Opened 12 years ago
Closed 12 years ago
#7466 closed defect (fixed)
21 warnings when building the HTML version of the reference manual, Sage 4.2.1
Reported by: | mvngu | Owned by: | mvngu |
---|---|---|---|
Priority: | minor | Milestone: | sage-4.3 |
Component: | documentation | Keywords: | |
Cc: | sage-combinat | Merged in: | sage-4.3.rc0 |
Authors: | John Palmieri | Reviewers: | Minh Van Nguyen |
Report Upstream: | N/A | Work issues: | |
Branch: | Commit: | ||
Dependencies: | Stopgaps: |
Description (last modified by )
Building the HTML version of the reference manual for Sage 4.2.1, I received 21 warnings. These warnings are:
/scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/geometry/lattice_polytope.rst:: (ERROR/3) Content block expected for the "note" directive; none found. /scratch/mvngu/build/sage-4.2.1/local/lib/python2.6/site-packages/sage/plot/contour_plot.py:docstring of sage.plot.contour_plot.region_plot:30: (WARNING/2) Bullet list ends without a blank line; unexpected unindent. /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/rings/polynomial/polynomial_element.rst:: (ERROR/3) Content block expected for the "warning" directive; none found. /scratch/mvngu/build/sage-4.2.1/local/lib/python2.6/site-packages/sage/rings/polynomial/polynomial_ring_constructor.py:docstring of sage.rings.polynomial.polynomial_ring_constructor.PolynomialRing:200: (WARNING/2) Definition list ends without a blank line; unexpected unindent. /scratch/mvngu/build/sage-4.2.1/local/lib/python2.6/site-packages/sagenb/notebook/config.py:docstring of sagenb.notebook.config:26: (WARNING/2) Inline interpreted text or phrase reference start-string without end-string. /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sagenb/notebook/twist.rst:6: (WARNING/2) autodoc can't import/find class 'sagenb.notebook.twist.UserToplevel.userchild_download_worksheets.zip', it reported error: "userchild_download_worksheets", please check your spelling and sys.path /scratch/mvngu/build/sage-4.2.1/local/lib/python2.6/site-packages/sagenb/storage/abstract_storage.py:docstring of sagenb.storage.abstract_storage.Datastore.worksheets:7: (WARNING/2) Literal block expected; none found. /scratch/mvngu/build/sage-4.2.1/local/lib/python2.6/site-packages/sagenb/storage/filesystem_storage.py:docstring of sagenb.storage.filesystem_storage.FilesystemDatastore.worksheets:7: (WARNING/2) Literal block expected; none found. looking for now-outdated files... none found pickling environment... done checking consistency... /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/introspect.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/misc.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/notebook/cell.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/notebook/css.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/notebook/docHTMLProcessor.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/notebook/interact.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/notebook/js.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/notebook/notebook.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/notebook/template.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/notebook/twist.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/notebook/worksheet.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/simple/twist.rst:: WARNING: document isn't included in any toctree /scratch/mvngu/build/sage-4.2.1/devel/sage/doc/en/reference/sage/server/support.rst:: WARNING: document isn't included in any toctree
Attachments (1)
Change History (6)
comment:1 Changed 12 years ago by
- Description modified (diff)
comment:2 Changed 12 years ago by
- Report Upstream set to N/A
- Status changed from new to needs_review
Changed 12 years ago by
comment:3 Changed 12 years ago by
- Cc sage-combinat added
comment:4 Changed 12 years ago by
- Reviewers set to Minh Van Nguyen
- Status changed from needs_review to positive_review
On Sage 4.3.alpha1, I first deleted the output/
directory and then proceeded to rebuild the HTML version of the reference manual:
[mvngu@sage sage-4.3.alpha1-7466-reference]$ rm -rf devel/sage-main/doc/output/ ./sage -docbuild reference html
This resulted in 34 warnings. To apply patches to Sage 4.3.alpha1, first you must resolve the issue of missing image files as reported at ticket #7606. I again removed the output/
directory, deleted everything under the directory SAGE_ROOT/devel/sage/doc/en/reference/sage/server/
*except* for
trac/trac.rst wiki/moin.rst
and finally I applied the patch trac_7466.patch
. Rebuilding the HTML version of the reference manual now only resulted in 8 warnings. So positive review from me. The remaining warnings can be dealt with in another ticket. I don't see those remaining warnings as a reason to hold back this ticket.
comment:5 Changed 12 years ago by
- Merged in set to sage-4.3.rc0
- Resolution set to fixed
- Status changed from positive_review to closed
With 4.3.alpha1, I get these warnings and some others. The attached patch fixes some of these, leaving seven. Four of those come from sagenb, and so should that spkg should be patched. The other three have to do with the new category stuff, and I don't know how to fix them:
Instructions: apply the patch. Also delete (by hand) everything in the directory
SAGE_ROOT/devel/sage/doc/en/reference/sage/server/
*except* for(These files are not tracked by Mercurial, so we have to delete them by hand, as far as I can tell.)