[Lazarus] "show declaration hints" has more power in it than is really used

[Mattias Gaertner]

On Sun, 25 Jul 2010 07:31:13 +0000
Mark Morgan Lloyd <markMLl.lazarus at telemetry.co.uk> wrote:

> Doug Chamberlin wrote:
> 
> > I'm in the same boat (35+ years). Comments are always immediately after 
> > instead of before. Among other things this helps ensure the comment is 
> > not lost when the code is moved since it is located *within* the 
> > unit/procedure/function. I sure hope any further automated support will 
> > be able to handle this style.
> 
> I note discussion elsewhere in the thread about using fpdoc in 
> preference to embedded comments. I think it's worth noting that at some 
> point in the future code might be read by somebody who only has the 
> source and doesn't have the Lazarus IDE etc., in much the same way that 
> Lazarus/FPC developers have to refer to kernel and library header files 
> written for C/C++.

fpdoc has many output formats and the html output is put online. fpdoc
is a command line utility, not part of the Lazarus IDE. Several people
are working on offline viewers.

Mattias