#6495: Build the reference manual incrementally
---------------------------------------------------------------+------------
Reporter: mpatel | Owner:
jdemeyer
Type: enhancement | Status:
needs_work
Priority: major | Milestone:
sage-5.7
Component: documentation | Resolution:
Keywords: days38 | Work issues:
Report Upstream: N/A | Reviewers:
Volker Braun, Florent Hivert
Authors: Mitesh Patel, John Palmieri, Florent Hivert | Merged in:
Dependencies: #13143, #12719 | Stopgaps:
---------------------------------------------------------------+------------
Comment (by jhpalmieri):
On what platforms, and how reliably, do you see the `WARNING: intersphinx
inventory ...`?
For the other problem, this patch fixes it for me:
{{{
#!diff
diff --git a/doc/common/builder.py b/doc/common/builder.py
--- a/doc/common/builder.py
+++ b/doc/common/builder.py
@@ -274,7 +274,7 @@ class AllBuilder(object):
global ALLSPHINXOPTS
ALLSPHINXOPTS += ' -Q -D multidoc_first_pass=1'
for document in refs:
- getattr(get_builder(document), 'inventory')(*args, **kwds)
+ getattr(get_builder(document), name)(*args, **kwds)
logger.warning("Building reference manual, second pass.\n")
ALLSPHINXOPTS = ALLSPHINXOPTS.replace(
'multidoc_first_pass=1', 'multidoc_first_pass=0')
}}}
Or perhaps we should use this one:
{{{
#!diff
diff --git a/doc/common/builder.py b/doc/common/builder.py
--- a/doc/common/builder.py
+++ b/doc/common/builder.py
@@ -274,7 +274,10 @@ class AllBuilder(object):
global ALLSPHINXOPTS
ALLSPHINXOPTS += ' -Q -D multidoc_first_pass=1'
for document in refs:
- getattr(get_builder(document), 'inventory')(*args, **kwds)
+ if name == 'pdf':
+ getattr(get_builder(document), 'inventory')(*args,
**kwds)
+ else:
+ getattr(get_builder(document), name)(*args, **kwds)
logger.warning("Building reference manual, second pass.\n")
ALLSPHINXOPTS = ALLSPHINXOPTS.replace(
'multidoc_first_pass=1', 'multidoc_first_pass=0')
}}}
With an html build, building with this patch does not take any more time.
Opinions?
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6495#comment:190>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.
