problem using Root.Html.SourceDir

From: Joanne Bogart (jrb@SLAC.stanford.edu)
Date: Tue Apr 06 1999 - 00:53:10 MEST 

I would like to generate html documentation for classes residing in
four different source directories.  There are instances of references
from classes in one directory to classes in another, for example classes
in one directory sometimes inherit from classes in another.  I have made
four shared libraries corresponding to the four source directories.

The only way I can get references within the html files for a set of
classes to point to my output directory seems to be to run root from
the source directory for that set of classes; otherwise the references
point to 

      http://root.cern.ch/root/html  

which is the value of Root.Html.Root.


Here is my .rootrc:

Unix.*.Root.DynamicPath:   .:/afs/slac.stanford.edu/package/cernroot/newroot/lib:/afs/slac.stanford.edu/g/nld/RootApps/FullRecon/prod/bin/SunOS:/afs/slac.stanford.edu/g/nld/RootApps/FastMC/prod/bin/SunOS:/afs/slac.stanford.edu/g/nld/RootApps/Util/prod/bin/SunOS:/afs/slac.stanford.edu/g/nld/RootApps/Event/prod/bin/SunOS
Unix.*.MacroPath:          .:$ROOTAPPS/FastMC/dev/test:$NLDROOT/RootApps/FastMC/prod/doc
Root.Html.SourceDir:       .:/afs/slac.stanford.edu/g/nld/RootApps/Event/V3.0/src:/afs/slac.stanford.edu/g/nld/RootApps/FastMC/V3.0/src:/afs/slac.stanford.edu/g/nld/RootApps/Util/V2.0/src:/afs/slac.stanford.edu/g/nld/RootApps/FullRecon/V3.0/src
Root.Html.OutputDir:       /afs/slac.stanford.edu/g/nld/RootApps/Common/prod/doc/rootHtml
Root.Html.Root:            http://root.cern.ch/root/html

  --------------------------------------------------------------------
libEvent.so is the most fundamental of the shareables.  I can run the 
following macro from the source directory for the event classes,
/afs/slac.stanford.edu/g/nld/RootApps/Event/V3.0/src

                -------------------------------
// Need to have appropriate Root.Html.* items in .rootrc

int makeHtmlEvent()
{
  gROOT->Reset();

  THtml html;

  gSystem->Load("libEvent.so");
  //  gSystem->Load("libRootAppsUtil.so");
  //  gSystem->Load("libFastMC.so");
  //  gSystem->Load("libFullRecon.so");
  

  gHtml->MakeAll();
  return 0;
}

                 ------------------------------------

and reasonable .html files end up in the output directory, though there
are some complaints.

The next shareable up is Util, so I next run this macro from the Util source
directory:

                   -------------------------------------

// Need to have appropriate Root.Html.* items in .rootrc

int makeHtmlUtil()
{
  gROOT->Reset();

  THtml html;

  gSystem->Load("libEvent.so");
  gSystem->Load("libRootAppsUtil.so");
  //  gSystem->Load("libFastMC.so");
  //  gSystem->Load("libFullRecon.so");
  

  gHtml->MakeAll();
  return 0;
}

The class RecModule references Event.  The generated file RecModule.html
contains the following:

<!--BOLD--><a href="#RecModule:doit">doit</a><!--PLAIN-->(<a href="http://root.
cern.ch/root/html/Event.html">Event</a>* event)

instead of referencing the Event.html in the output directory.  Similarly,
the next shareable, FastMC, has classes which inherit from RecModule, and
the generated html files for such a class have lines like

<h2>class <a name="CalRecon" href="CalRecon.h">CalRecon</a> : public <a href="h
ttp://root.cern.ch/root/html/RecModule.html">RecModule</a></h2>

How can I get all internal references to be resolved properly?

                                             Joanne

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