Hi Rooters, following the discussion about auto document generation, I'd like to add my experience too, about the Perceps perl script. What I like best of this package is its high customizability. The script encapsulates a C++ parser which saves its work in hash tables, then a template parser which substitutes tags like {member} or {args} in the final output, which can be any textual format (HTML, LaTeX source, man pages, ...) given that the appropriate template is provided. If anyone wants to see my setup, have a look at: http://meitner.tn.infn.it/toyNN/Doc/index.html The templates and scripts I used can be found in: http://meitner.tn.infn.it/cgi-bin/bettelli/archive.pl in the Miscellanea section; the C++ sources are in the same place in the other two columns. I think the package is complete, exception made for the possibility to link directly to the C++ source file; this should be anyway of little effort since perl is appropriate for such parsing jobs. Probably, once the package is optimal it should be ported to a compiled language (or the documentation task could be run in background with high nice level while compiling the C++ code just like I do in my project). The Perceps script documentation can be reached at: http://meitner.tn.infn.it/localdoc/Perceps-3.5.0 which also links to the original home page. Best regards, Stefano Bettelli ---------------------------------------------------------- E-Mail: Stefano Bettelli <bettelli@tn.infn.it> WWW : http://meitner.tn.infn.it
This archive was generated by hypermail 2b29 : Tue Jan 04 2000 - 00:43:40 MET