3 suggestions about autodocumentation

From: Terrence Brannon (brannon@quake.usc.edu)
Date: Tue Jun 24 1997 - 20:23:18 MEST


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



This archive was generated by hypermail 2b29 : Tue Jan 04 2000 - 00:26:19 MET