The output is automatically placed in the html/, pdf/, help/, dvi/, and tex/ subdirectories of the doc/o/bookname/ directory.
HTML output can be viewed with any HTML browser. The title page for individual books is always bookxx.html where xx is the two-letter abbreviation for the book (except for the SST Drivers manuals, for QNX Helpviewer reasons). So, to see the HTML version of the Cascade DataHub manual, you would point your browser to doc/o/dh-book/html/bookdh.html. The Cogent Documentation bookset uses the file cogentdocs.html for its title page, so you would access doc/o/cogent-set/html/cogentdocs.html.
PDF output can be viewed and printed with the Acrobat Reader or any other PDF viewer. The file name for each PDF book is main.pdf. So, to access the Cascade DataHub manual in PDF, you would open the file doc/o/dh-book/pdf/main.pdf. Keep in mind that the Cogent Documentation bookset is not available in PDF, nor are the Gamma or Gamma/Photon manuals. The latter are split into 3 directories each: doc/o/gamguide-book/, doc/o/gamref1-book/, and doc/o/gamref2-book/; and doc/o/phgamguide-book/, doc/o/phgamref1-book/, and doc/o/phgamref2-book/.
QNX Helpviewer output can be viewed using an HTML browser (since QNX Helpviewer format is just slightly modified HTML), but the output must be installed on a QNX system to use the Helpviewer Table of Contents feature. The best way to do this is to install the Cogent Documentation distribution file generated by the doc/export/Makefile, which is explained in Making the Distribution from doc/export/.
To check output in QNX6, copy the archive to any directory, and unzip it. In that directory, do:
> helpviewer -t usr/cogent/help/cogent-set.toc
To install in QNX 4, copy the .tgz archive to a QNX 4 machine, open a shell and do this:
> su # /etc/install -u /path/to/archive/CogentDocs-1.0-....
Postscript and DVI output is in the dvi/main.ps and dvi/main.dvi files respectively. The other files in that directory are used to process other output.
TEX output is in tex/main.tex. We generally don't view this output; it is used as an intermediate step in processing the print output (PDF, Postscript and DVI).
Copyright © 1995-2004 by Cogent Real-Time Systems, Inc. All rights reserved.