Online Help
1 Introduction
The complete
NAG C Library Manual, Mark 8
can be viewed on-line in one of three formats:
- PDF+HTML, a full PDF manual which can be browsed using HTML index files;
- PDF, a full PDF manual browsed using the PDF bookmarks; and
- XHTML+MathML, a fully linked version of the manual using XHTML and MathML.
This note tells you how to obtain the software required to view the documentation and advises you on how best to navigate
the files with or without an HTML browser.
2 PDF+HTML Format
2.1 Viewing PDF+HTML Files
The mark up used in these files is standard HTML and should work with your normal HTML browser. Links to PDF files will either
open in the browser or in a separate PDF viewer dependent on your local configuration. If Adobe Acrobat is not running as
a plug-in then the bookmark links will not work correctly, you are advised to reinstall Adobe Acrobat which should rectify
the problem.
Please note that the
Essential Introduction contains
some mathematical characters that are displayed as question marks by releases of Netscape earlier than 6, but that these are
displayed correctly by Netscape 6 and Internet Explorer. They may also be viewed via the PDF.
Please see Section
3.1 for further asistance with PDF Files.
2.2 Navigating PDF+HTML Files
A main index file has been provided (mark<current mark number>.html in the directory html) which contains a fully linked HTML Contents document, which links to individual Chapter Contents
documents (and where available, HTML files), which in turn point to all the available PDF files. Use your HTML browser to
navigate from this main index file. If you use the bookmarks whilst browsing the PDF files you will find yourself in the
PDF browsing environment.
3 PDF Format
3.1 Viewing and Printing PDF Files
If you do not already have a copy of Adobe Acrobat Reader for your platform, a free copy can be downloaded from http://www.adobe.com. Please check this site for availability of a reader for your platform.
If Adobe Acrobat is not running as a plug-in then the bookmark links will not work correctly, you are advised to reinstall
Adobe Acrobat which should rectify the problem.
Please note that if you are using Adobe Acrobat 4.0 or earlier you might experience some problems when printing documents
that contain non-standard characters, such as integral signs, square roots and large brackets. For instance,
the round brackets on page 2 of
nag_zgetri (f07awc) will appear incomplete when printed using 4.0, but will print correctly using 5.0.
3.2 Navigating Using PDF Bookmarks
If you prefer not to use your HTML browser it is possible to navigate around the documentation using the bookmark facility
within Adobe Acrobat. A main index file has been provided (mark<current mark number>.pdf in the directory pdf) which contains a bookmark list pointing to fully linked Contents documents which provide links
to all the available PDF files.
4 XHTML+MathML Format
4.1 Viewing XHTML+MathML Files
These files do not use any proprietary browser specific features, and conform to relevant W3C Recommendations (Standards)
(XHTML 1.0, MathML 2.0, CSS 1, XSL 1.0).
Support for these languages may require updating your browser and/or installing a (free) third party extension. Details of
system requirements for various platforms are detailed below. If information about additional platforms or browsers is required,
this document will be updated as necessary.
4.1.1 Microsoft Windows
4.1.1.1 Internet Explorer
The required version is 6.0 or later and the latest version of IE is always available from:
http://www.microsoft.com/ie
If you have IE 6 (but not 5.5) the mathematics will be displayed to some extent without any additional plug-in, but to produce
high quality mathematics rendering you should obtain the free MathPlayer behaviour available from Design Science.
The latest version is available for download from:
http://www.mathplayer.com/en/products/mathplayer/welcome.asp
4.1.1.2 Mozilla/Firefox/Netscape
All versions of Mozilla (from around 0.94) should display XHTML+MathML files by default. MathML support is part of the core
rerendering engine in this browser. Netscape from Version 6 onwards is essentially a rebadged version of Mozilla
You may need to install additional fonts (if so, a dialog box will alert you when you first view a page containing mathematics).
A font installer has been produced at:
http://web.mit.edu/atticus/www/mathml/mit-mathml-fonts-1.0-fc1.msi/
Instructions on the use of the installer are available from:
http://web.mit.edu/is/topics/webpublishing/mathml/fonts-win.html
although it should be self explanatory.
4.1.2 Unix/Linux
4.1.2.1 Mozilla/Firefox/Netscape
All versions of Mozilla (from around 0.94) should display XHTML+MathML files by default. MathML support is part of the core
rerendering engine in this browser. Netscape from Version 6 onwards is essentially a rebadged version of Mozilla.
You may need to install additional fonts (if so, a dialog box will alert you when you first view a page containing mathematics).
On Linux with Xft-enabled builds, you should install the TrueType TeX fonts from:
http://www.mozilla.org/projects/mathml/fonts/bakoma/texcm-ttf.zip
and Mathematica 4.1 fonts from:
http://support.wolfram.com/mathematica/systems/windows/general/latestfonts.html
See the instructions at:
http://bugzilla.mozilla.org/show_bug.cgi?id=128153#c81
On Unix/Linux with Xft-disabled builds (i.e., with X11core fonts), you should install the Type1 TeX fonts from:
ftp://ftp.ams.org/pub/tex/psfonts/cm/cmps-unix.tar.gz
and Mathematica 4.1 fonts in PFA format from:
http://support.wolfram.com/mathematica/systems/unix/general/manualfontdownload.html
and PCF format from:
http://support.wolfram.com/mathematica/systems/unix/interface/pcf.html
For instructions see:
http://swissnet.ai.mit.edu/projects/intelligent-book/mathml/#gnu
4.1.3 Macintosh
4.1.3.1 Mozilla/Firefox/Netscape
On the Mac OS X, you are advised to have Firefox version 1.5b or later. Netscape from Version 6 onwards is essentially a
rebadged version of Mozilla.
You will then need to download the font installer from:
http://web.mit.edu/atticus/www/mathml/mit-mathml-fonts-1.0-fc2a.hqx
and follow the instructions provided in:
http://web.mit.edu/is/topics/webpublishing/mathml/fonts-mac.html
4.2 Navigating XHTML+MathML Files
A main index file has been provided (mark<current mark number>.xml in the directory xhtml) which contains a fully linked XHTML Contents document, which links to individual Chapter Contents
documents, which in turn link to a complete set of fully linked XHTML files. Use your HTML browser to navigate from this
main index file. For each function document in XHTML format you are provided with a link to its equivalent PDF file, this
file has been provided primarily for printing purposes.
© The Numerical Algorithms Group Ltd, Oxford, UK. 2005