I have been looking for better documentation generators in the
mean time I wrote a small utility that allows one to quickly add an
example or whatever from a text file into an html file generated by
fpdoc (fbdoc is included in free pascal).. It is a command line tool
written in python
http://dexrow.blogspot.com/2007/10/small-utility-to-use-with-fpdoc.html