[fpc-pascal] State of FPC docs.rant

[Marco van de Voort]

In our previous episode, Joseph Montanez said:
> I just spent 2 hours on FPDoc's trying to get how to use it. Automatic
> documentation was dead easy but the whole XML integration part was a
> nightmare, so I gave up reading the docs on how to use the doc.
> Instead I figure "Hey there must be examples of this right?" ... *digs
> through source* ... 5 mins later figured it out.

(You might also want to have a look at the fixdocs.sh script, it is what I
use to generate the CHM docs:

http://www.stack.nl/~marcov/doc-chm.zip

)