[fpc-other] Re: [fpc-pascal] Variable arguments, different types?

Marco van de Voort marcov at stack.nl
Sat Mar 11 12:20:58 CET 2006


> > See docs: [http://www.freepascal.org/docs-html/ref/refsu47.html]

> Just like one of those USENET trolls who spits out "read the man page",
> even though the man page is incomplete.

Still, most haven't read the incomplete bits either :-)
 
> Manuals constantly need updating, along with examples needing to be
> updated too.

True. And that is a lot work. OSS answer to that is highlevel parallellism
to manuals, but in practice that gives crappy manuals.

> Makes me wonder what PHP people were thinking, adding a silly comment system to
> their main documentation URL's. How can that help anyone. The manuals are
> already complete, and set in stone. They don't change.

We have this with FPC too (select with comments), 

http://community.freepascal.org:8080/docs-html/ref/refsu47.html#x113-12000010.3.6

this is mostly to submit feedback back to the doc maintainer(s) on a per
subject basis, and avoiding a lot of routine work on maillists etc.

That doesn't mean the lists can't be used for communicating over the docs,
but for trivia the comment system could be handy (though I never heard back
from Michael how it works in practice, and _if_ there are any submissions)


More information about the fpc-other mailing list