On Mar 16, 11:08 am, Carl Witty <carl.wi...@gmail.com> wrote:
> On Mon, Mar 16, 2009 at 10:46 AM, mabshoff <mabsh...@googlemail.com> wrote:
>
> > On Mar 16, 10:37 am, mabshoff <mabsh...@googlemail.com> wrote:
>
> > <SNIP>
>
> >> But strangely enough when I run the documentation build I run into the
> >> same issue you described. I am poking around to see what is
> >> happening ...
>
> > An observation:
>
> > "
> > pickling environment... done
> > checking consistency... WARNING: /scratch/mabshoff/sage-3.4.1.alpha0/
> > devel/sage-main/doc/en/reference/sage/algebras/quaternion_order.rst::
> > document isn't included in any toctree
> > done
> > "
>
> > There is a quaternion_order.rst in devel/sage/doc/en/reference/sage/
> > algebras that seems to be autogenerated.
>
> > After nuking the output directory rebuilding all documentation
> > repeatedly works.
>
> This would happen if you pushed/applied a patch that added
> quaternion_order.pyx (and a reference to quaternion_order.rst from one
> of the main reference manual files), built the documentation, and then
> popped/reverted the patch.
Well, the strange thing is that is is re-generated even though I
deleted the output directory and the string "quaternion_order" does
not appear anywhere inside devel/sage/ expect in output directories:
mabsh...@sage:/scratch/mabshoff/sage-3.4.1.alpha0$ grep -r
quaternion_order devel/sage-main/*
devel/sage-main/doc/output/html/en/reference/sage/algebras/
quaternion_order.html: <li><a href="../../_sources/sage/
algebras/quaternion_order.txt">Show Source</a></li>
Binary file devel/sage-main/doc/output/doctrees/en/reference/
environment.pickle matches
Binary file devel/sage-main/doc/output/doctrees/en/reference/sage/
algebras/quaternion_order.doctree matches
There are also the following files:
mabsh...@sage:/scratch/mabshoff/sage-3.4.1.alpha0$ find devel/sage-
main/ -name "quaternion_order*"
devel/sage-main/doc/en/reference/sage/algebras/quaternion_order.rst
devel/sage-main/doc/output/html/en/reference/_sources/sage/algebras/
quaternion_order.txt
devel/sage-main/doc/output/html/en/reference/sage/algebras/
quaternion_order.html
devel/sage-main/doc/output/doctrees/en/reference/sage/algebras/
quaternion_order.doctree
> Maybe the right fix is to find the code that generates the WARNING
> message, and make it just delete the .rst file instead.
Something along those lines.
I now deleted the empty doc/en/reference/sage/algebras/
quaternion_order.rst file, nuked the output directory to get rid of
the pickles and did rebuild the documentation from scratch.
quaternion_order was not in the list of files where ReST strings were
exported from. And low and behold, the other files are gone:
mabsh...@sage:/scratch/mabshoff/sage-3.4.1.alpha0$ find devel/sage-
main/ -name "quaternion_order*"
mabsh...@sage:/scratch/mabshoff/sage-3.4.1.alpha0$
> Carl
It might be a good idea to have some kind of procedure that describes
how to get rid of files that have been added to the documentation even
though it should be a rare occurrence.
Cheers,
Michael
--~--~---------~--~----~------------~-------~--~----~
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
-~----------~----~----~----~------~----~------~--~---
