[fpc-devel] [RFC] fpdoc output comment from the source

[L505]

> > Did you miss something?
>
> > On the FPC homepage:
> > - Click "on-line documentation"
> > - Click "documentation table of contents with comments"
> > - Click "Add a comment"
>

I think I finally figured out your little comment system for the units generated with
FPDOC that I seemed to magically find today:

http://community.freepascal.org:10000/docs-html/rtl/index.html

The comment system *is* (and has been, for how long I don't know) in place - even if
it took me 50 years to find. The major problem is no one reads those documents, or
can find them easily.  People read what is indexed by google:
http://www.freepascal.org/docs-html/rtl/

I think the reason I've never landed on a comment document page is because google
treats them as duplicates and doesn't index them. That, and as I said before, the
fact that we have so many FPC mirrors out there with the exact same content makes
google think there is no need to index the documents with comments.

I'd force the comments onto people - they can't do any harm. Why offer the docs
without comments? It'd be better for google, but not necessarily better for those
people who don't like comments under the documents (who wouldn't?).

Sorry if I couldn't find them - but if I can't find them, who can? (unless I'm a
clutz, which is highly possible).

--
L505