gsw wrote: > So the "make" problem you reported is not restricted to binaries, and > I think this problem exists since the ReSTification of the docs (Sage > 3.4? Sage 4.0?). > IMHO, it would be far more important to solve the problem that "sage - > clone" rebuilds all of the documentation in a better way than using > these hard links recently introduced, an issue that was discussed here > before (by David Loeffler and Minh IIRC). > Maybe it's possible to solve both problems at the same time. > The first time I looked into how Sphinx checks whether it should > rebuild which docs I gave up, when I couldn't figure out if Sphinx > pickles the doc files together with their absolute path names (which > would be pretty annoying in light of "sage -clone"), or with relative > path names only, or however.
At the risk of being annoyingly repetitive: A relevant ticket for "ref-cloning" problems is http://trac.sagemath.org/sage_trac/ticket/6187 The patch there should, e.g., ensure that clone names are absent from Sphinx's pickle. The most recently uncovered problem may well be related. I'll try to investigate. The ticket needs further review, but casual testers are welcome! It would be very useful to know which problems remain, are newly introduced, etc. As a bonus --- or bogus, perhaps --- please test and make suggestions about new command-line options introduced there for sage -docbuild. A sample help message: sage -docbuild [OPTIONS] DOCUMENT (FORMAT | COMMAND) Build or return information about Sage documentation. DOCUMENT name of the document to build FORMAT document output format COMMAND document-specific command A DOCUMENT and either a FORMAT or a COMMAND are required, unless a list of one or more of these is requested. DOCUMENTs: developer website testreference bordeaux_2008 reference installation tutorial numerical_sage a_tour_of_sage constructions fr/tutorial all (!) (!) Builds everything. FORMATs: html pdf changes htmlhelp json latex linkcheck pickle web COMMANDs for the DOCUMENT 'reference': print_included_modules print_modified_modules (*) print_unincluded_modules print_newly_included_modules (*) (*) Since the last build. OPTIONS: Standard: -h, --help show a help message and exit -H, --help-all show an extended help message and exit -D, --documents list all available DOCUMENTs -F, --formats list all output FORMATs -C DOC, --commands=DOC list all COMMANDs for DOCUMENT DOC; use 'all' to list all -j, --jsmath render math using jsMath; FORMATs: html, json, pickle, web -N, --no-colors do not color output; does not affect children -q, --quiet work quietly; same as --verbose=0 -v LEVEL, --verbose=LEVEL report progress at LEVEL=0 (quiet), 1 (normal), 2 (info), or 3 (debug); does not affect children Advanced: Use these options with care. -S OPTS, --sphinx-opts=OPTS pass comma-separated OPTS to sphinx-build -U, --update-mtimes before building reference manual, update modification times for auto-generated ReST files Examples: sage -docbuild -FDC all sage -docbuild constructions pdf sage -docbuild reference html -jv3 sage -docbuild --jsmath tutorial html sage -docbuild reference print_unincluded_modules sage -docbuild developer -j html --sphinx-opts -q,-aE --verbose 2 --~--~---------~--~----~------------~-------~--~----~ To post to this group, send email to sage-devel@googlegroups.com To unsubscribe from this group, send email to sage-devel-unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URLs: http://www.sagemath.org -~----------~----~----~----~------~----~------~--~---
