Menu

#42 Comment association and concatenation

open
nobody
None
5
2012-11-05
2008-06-06
No

As already mentioned in another feature request, I'd vote for an switch to default all comments to BackComment.

There exists only one situation, where a comment is placed before the referenced item, and that's before classes or other structured types. Even comments on procedures should be placed after the procedure heading, else the Delphi IDE can insert other methods between a procedure definition and an preceding comment.

I've hacked that new default behaviour into my working copy, and it works quite well for e.g. VirtualTreeView. But there I came across another topic: Some newer(?) tools seem to split multi-line comments into a couple of single-line "//" comments, so that pasdoc should be able to concatenate such comments again.

And before I forget it, line numbers often were helpful in the documentation, e.g. appended to the unit names, so that one can jump easily to an identifier that deserves editing. A similar feature were nice in the GUI, with an SynEdit bound to the log pane...

Else I thank all developers for their fine work :-)

DoDi

Discussion


Log in to post a comment.

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.