Mailing lists / fpc-other / 2006-03
2 messages · 2 people · –
Reply by email Subscribe to this list Your subscription
Read-only archive. Use j and k to move between messages.
See docs: [http://www.freepascal.org/docs-html/ref/refsu47.html] Michalis
Just like one of those USENET trolls who spits out "read the man page", even though the man page is incomplete.
Manuals constantly need updating, along with examples needing to be updated too.
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.
RTFM!
> 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)