Re: Auto document generation

From: Stefano Bettelli (bettelli@tn.infn.it)
Date: Tue Oct 12 1999 - 12:53:22 MEST


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