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

[Martin]

On 24/07/2010 17:34, Mark Morgan Lloyd wrote:
> Bernd wrote:
>
> Much stuff that appeared on a single line, with occasional missing 
> spaces. If it's difficult to write it should be difficult to read. 
> Here endeth the rant :-)
>
> I wonder if I could ask a question that follows on from Bernd's 
> sentiment. He points out that the IDE will pick up a comment /before/ 
> a declaration, but for getting on for 30 years I've been putting 
> comments immediately /after/ and that includes the positioning of a 
> unit summary. What's more I've been writing comments where every line 
> is terminated ("Sloane style") rather than having a brace at the start 
> of each comment and one at the end, and I still favour (* *) because 
> of years spent using Modula-2.
>
> Is there a Lazarus Style Guide somewhere, that deals with how best to 
> format code so that the IDE can exploit it, that deals with using 
> fpdoc or something similar for ones own projects, and that possibly 
> even deals with writing help files (of some suitable format)?
>

Not sure about if/where the various "IDE can read this commnet"...

But a comment at the end of the *same* line, is also recognized.

procedure Foo; // Does something real important