On Sun, 25 Jul 2010 07:31:13 +0000 Mark Morgan Lloyd <[email protected]> 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 -- _______________________________________________ Lazarus mailing list [email protected] http://lists.lazarus.freepascal.org/mailman/listinfo/lazarus
