This will build the project data for a Windows Compiled Help file (cgns.chm)
from the CGNS documentation. The program creates a copy of all the documentation
along with a cgns.hhp (htmlhelp project file) and a cgns.hhc (htmlhelp index) file
from the sitemaps.

To create the executable, do:

make -f Makefile.unix

or

nmake -f Makefile.win

The first is for unix and the second for windows using MSVC and nmake.

To build the compiled help source, run:

html2chm [-a] [-v] sourcedir chmdir [CGNShome]
        printf ("input_dir = directory containing CGNS documentation\n");
        printf ("output_dir = directory to write CHM output\n");
        printf ("CGNShome = GRC documentation home for external links\n");
        printf ("           default is CGNS_docs_current\n");

where 'sourcedir' is where the CGNS documentation is located, and
'chmdir' is the directory in which to copy the modified files.

The -a option will include all the documentation (CGNSTalk, minutes,
slides, tar, pdf and tex files, .etc). If not given, these references
will be lined to those at GRC.

The -v option prints a details about what is being done.

The last optional argument, CGNShome, is the base location for
external links. The default is CGNS_docs_current, which is appended
to the base URL http://www.grc.nasa.gov/WWW/cgns.
You may specify either the full URL or just that relative to the base.

This should create the cgns.hhp and cgns.hhc files in 'chmdir', which are
used to build the Windows chm file. You will need the windows htmlhelp
distribution to build the chm file. There may be chm compilers available
for Linux also (I know there are viewers).

What html2chm does is:

1) strips the navigation headers (since this info is in the index)
2) removes the colons from link names (i.e. changes sec:whatCGNS to
   sec-whatCGNS) HTML help seems to not like the colons.
3) replaces download, papers, slides and minutes relative links with the
   http address http://www.grc.nasa.gov/WWW/cgns

Bruce
brucewedan@gmail.com
