#14156: New docbuilder always rebuilds everything
---------------------------------+------------------------------------------
Reporter: jdemeyer | Owner: mvngu
Type: defect | Status: needs_review
Priority: blocker | Milestone: sage-5.8
Component: documentation | Resolution:
Keywords: | Work issues:
Report Upstream: N/A | Reviewers:
Authors: John Palmieri | Merged in:
Dependencies: | Stopgaps:
---------------------------------+------------------------------------------
Changes (by {'newvalue': u'John Palmieri', 'oldvalue': ''}):
* cc: vbraun (added)
* status: new => needs_review
* author: => John Palmieri
Comment:
I think there are two problems. First, the inventory builder did not have
a working `get_outdated_docs` method: it was inheriting the method from
`StandaloneHTMLBuilder`, and it was always saying that all docs were
outdated: it was comparing the modification time of the appropriate `rst`
file to some nonexistent file. I've put in a new method which is identical
to the inherited one, except that it compares to the modification time of
`objects.inv`.
The second problem is that any change to the configuration triggers a
rebuild, so passing `-D multidoc_first_pass=0` vs. `-D
multidoc_first_pass=1`, or changing the setting of
`app.config.intersphinx_mapping`, turn out to be bad ideas. I've deleted
those, and instead filtered out the useless warning message ("search index
couldn't be loaded...") during the inventory build.
This now works for me: I can type `make doc` twice, and it doesn't
rebuild, and then I can type `sage --docbuild all html` or `sage
--docbuild reference inventory` or variations on these and it doesn't
rebuild. Touching a single file, running `sage -b` and then building the
docs behaves properly.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/14156#comment:3>
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.
