[Lazarus] documentation snapshot

[Marco van de Voort]

On Sat, Apr 20, 2013 at 01:22:38PM -0400, Anthony Walter wrote:
> Were you going to tackle the dotted unit name

Certainly not.

> and Delphi style generic declaration problems in the bug tracker?

That is more interesting, and closer to my heart, but a bit beyond me atm,
I'm afraid.

I'm just doing regular debugging stints with fpdoc just to
get the docs through, that is it. Usually in sync with FPC releases.

> I've been testing documentation generation tools and editing together a
> nice style with a tree view feature (I'm working on adding an index
> feature).
> 
> Here is an example if you want some inspiration:
> http://codebot.org/bare/default.html

I don't like the treeview (as it is currently). It seems to have a really
deep hierarchy, and clicking a link in the right window, doesn't synchronize
the left, so you are constantly folding and unfolding the treeview

The toplevel "class" lemma is nearly defunct. It doesn't really provide
links to the class (need treeview for that), and doesn't contain much other
info.

I also don't like showing methods etc in a table.  I like the current
situation more (more compact _AND_ more information)

If I recall correctly, docview also suffered from this.