PDA

View Full Version : documentation generators question and small util for fpdoc..



edexter
25-10-2007, 06:50 AM
I have been trying various documentation generators
universal report, documatic, twin text, fpdoc.. I was very impressed with universal report but I don't have that kind of $ for that sort of thing unless someone else is springing for it. the other two I didn't like and fpdoc doesn't realy thrill me (The price is good though). Is there other documentation generators I am missing??? I am taking those book adds as sort of a dare to write good docs (amazon has publishing on demand) while I am mentioning this I wrote a small utility to add examples to docs created with fpdoc (written in python)




http://dexrow.blogspot.com/2007/10/small-utility-to-use-with-fpdoc.html

Mirage
26-10-2007, 04:18 AM
I'm using DiPasDoc (http://www.yunqa.de/delphi/doku.php/products/pasdoc/index?DokuWiki=lqth9ovjcmv4mqdsthhecagt54).

edexter
02-11-2007, 02:11 AM
I will look into that one.. I wrote another one yesterday.. (using python heresy I know).. It goes through an entire directory looking for .pas files and puts all the data into two files.. One for the interface one for the implementation.. grabs all the comments exc (I used glob.glob in python for that).. A little work for the human combining them and putting all the examples in the text. If there is any interest in a printed version and if someone can do a .pdf cover these can be uploaded to amazon.com.. It can be cheaper than using your own printer in some cases..