5 The SAGE Documentation

You do not need to install the documentation separately. This includes the tutorial, the manual, the programming guide, and this installation guide. The tutorial is an overview about the philosophy of SAGE, and some examples of how to use SAGE. The reference manual explains what is available in SAGE and gives examples of how to use it.

For SAGE to build the html, dvi and pdf versions of the documentation, it requires a working latex system with latex2html. The source to create the SAGE documentation is included with the SAGE source tarball. This documentation is in the subdirectory devel/doc-*. To build it, change into this directory and type ./rebuild. All the html documentation is in the doc subdirectory (which is actually a link to devel/doc-*/html).

Note: Some systems exhibit a latex bug where the url command gets defined twice, and this prevents building the documentation which use html links. A hack to get around this, at least on an Ubuntu 5.10 system, is to comment out line 103 of /usr/share/texmf/tex/latex/misc/url.sty. If you can figure out a much better fix, please email (wstein@gmail.com).

See About this document... for information on suggesting changes.