3 suggestions about autodocumentation

Terrence Brannon (brannon@quake.usc.edu)
24 Jun 1997 11:23:18 -0700

1: a verbose flag for rootcint to indicate which file is currently
being processed
2: http://hpna49-7.cern.ch/Documentation.html states that there are
three placed to comment code which you want in HTML
documentation. There is actually a fourth: behind the ClassDef(,)
macro in the class so that it shows up in the ClassIndex.
3: Is there supposed to be a segmentation violation when
Thtml::MakeAll() completes? Transcript below from running the example
on the webpage:

brannon@surf ~/rs/VisionMagick/terry/junk : root
*******************************************
* *
* W E L C O M E to R O O T *
* *
* Version 1.01/03 24 May 1997 *
* Development version *
* *
* You are welcome to visit our Web site *
* http://root.cern.ch *
* *
*******************************************

CINT/ROOT C/C++ Interpreter version 5.13.10, May 22 1997
Type ? for help. Commands must be C++ statements.
Enclose multiple statements between { }.
root [0] gSystem.Load("myso.so")
gSystem.Load("myso.so")
(int)0
root [1] THtml html;
THtml html;
root [2] html.SetOutputDir( "/tmp/doc/" );
html.SetOutputDir( "/tmp/doc/" );
root [3] html.SetSourceDir( "./" );
html.SetSourceDir( "./" );
root [4] html.MakeAll();
html.MakeAll();
/tmp/doc/ListOfTypes.html
/tmp/doc/ClassIndex.html
/tmp/doc/BASE_Index.html
/tmp/doc/CONT_Index.html
/tmp/doc/FUNC_Index.html
/tmp/doc/G3D_Index.html
/tmp/doc/G_Index.html
/tmp/doc/GPAD_Index.html
/tmp/doc/H_Index.html
/tmp/doc/HTML_Index.html
/tmp/doc/META_Index.html
/tmp/doc/MINUIT_Index.html
/tmp/doc/NET_Index.html
/tmp/doc/POSTSCRIPT_Index.html
/tmp/doc/PROOF_Index.html
/tmp/doc/RINT_Index.html
/tmp/doc/TREE_Index.html
/tmp/doc/UNIX_Index.html
/tmp/doc/USER_Index.html
/tmp/doc/X11_Index.html
211 /tmp/doc/MyClass.html
/tmp/doc/MyClass_Tree.ps

*** Break *** segmentation violation

*** Break *** keyboard interrupt
Root > 

-- 
o============o  Sending unsolicited commercial e-mail (UCE)  to this address
 Legal Notice   is indication of your consent to pay me $120/hour for 1 hour
o============o  minimum for professional proofreading & technical assessment.
  Terrence Brannon * brannon@quake.usc.edu * http://quake.usc.edu/~brannon