On Wed, Jul 4, 2018 at 11:53 AM Mckenzie West <[email protected]> wrote: > > I have been using sage --docbuild reference html to build my documentation > however it has started crashing (on my develop branch - 8.3.beta8) at the end > of the manifolds documentation both on Ubuntu and CoCalc with an OSError. > > On the other hand, I was recommended to use make doc and that has run just > fine. > > The developer's guide instructs users to use the first method, so it seems to > me that some sort of change/bug fix should be made.
I could be wrong, but I believe sage -docbuild reference html does not necessarily update references from other documentation pages, nor does it update the object inventories (needed for links to classes/functions to be resolved correctly). So first you have to run sage -docbuild reference inventory which might fix it, but hard to say without seeing what the problem with. `make doc` does some other stuff too to clean up from old doc builds, so I would just use that. The developer's guide should probably recommend always doing `make doc` first to make sure your docs are all up-to-date. Once that's done you can manually use `sage -docbuild` if you want to rebuild just specific docs as you develop. -- You received this message because you are subscribed to the Google Groups "sage-devel" 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 https://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
