Our problem is that if somebody looks at FPC+Lazarus trying to solve a specific problem, whilst we might have the library routines etc. to help him, the machine-generated RTL+FCL documentation leaves much to be desired.
I don't understand. Only the prototypes are machine generated, the content is handwritten. (and in the case of FPC quite ok)
Marcov, not to argue, just inform. Some rough notes about how I find the RTL and FCL documentation -
Firstly, I struggle to identify which is RTL (89 items in doc, 66 items in src), FCL (44 items in doc), Packages (154 items in src). The RTL number seems similar but in fact almost no correlation between the doc and src entry titles.
Its possible to search the documentation from a "Search the documentation" link, eg "fcl-web" appears to go off into an endless loop.
Most of the 89 entries under
RTL take you to a page containing one or several sentences about the unit. Rarely any mention or links to unit contents or how to use it.
The
FCL doc entries in the docs seem to be, on average, more informative but, many are missing. As I am unsure where, in the source, the FCL exists (is it just fpc-* or all in "packages" ?) its hard to tell just what percentage is documented. But again, fc-web does not seem to be there.
So staying on my theme of fcl-web (for no other reason than its a great package) I find that googling for it takes me to the "daily" documentation, something I have seen before but can never find when I want it. It says -
FPC is distributed with a lot of units (well over 1500), organized in packages. For most of these no real documentation is available That includes fcl-web,
On the other hand,
Lazarus documentation is actually quite good, an enormous credit to Don Siders who works tirelessly away with no thanks. Thanks Don, a really great job !
EDIT : typo in quote
Davo