On 9/21/07, William Stein <[EMAIL PROTECTED]> wrote: > > On 9/21/07, Jason Grout <[EMAIL PROTECTED]> wrote: > > I changed some of the documentation in graphs/graph.py (formatted it > > using Latex). How do I build a new manual to see my changes? > > cd SAGE_ROOT/devel/doc/ref > ./build_pdf > > That will create ref.pdf, which you can view. This *requires* that you > have latex2html correctly installed, which -- due to its screwy > license -- often isn't installed on machines by default.
Would this method also work for docstrings files which are not included in the reference manual? (Ie, for newly created *.py files.) > > > Going to > > the doc directory and typing "make pdf" seems to just pick up the old > > sage.graphs.graph.tex file and not generate a new one from the python > > source. > > That would also work, but you have to first do > ./update > in the SAGE_ROOT/devel/doc/ref/ directory. > > > Did I miss something in the documentation? > > No, you didn't miss anything, since the build > system is unfortunately not really documented. > > There is a minimal README.txt in > SAGE_ROOT/devel/doc/ref/ > > If anybody understands the build system and > wants to document the above sort of thing, please > post a patch to trac against the doc repository. > > William > > > > --~--~---------~--~----~------------~-------~--~----~ To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sage-devel URLs: http://sage.scipy.org/sage/ and http://modular.math.washington.edu/sage/ -~----------~----~----~----~------~----~------~--~---
