This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Documentation warnings
Type: behavior Stage:
Components: Documentation Versions: Python 3.5
process
Status: closed Resolution: third party
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, georg.brandl, pitrou
Priority: normal Keywords:

Created on 2014-09-30 19:01 by pitrou, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Messages (2)
msg227978 - (view) Author: Antoine Pitrou (pitrou) * (Python committer) Date: 2014-09-30 19:01
I get the following warnings when building the doc:

                                                                              
$ make html
sphinx-build -b html -d build/doctrees -D latex_paper_size=  . build/html 
Running Sphinx v1.2.1
loading pickled environment... done
building [html]: targets for 65 source files that are out of date
updating environment: 1 added, 66 changed, 0 removed
reading sources... [100%] whatsnew/changelog                                           
/home/antoine/cpython/default/Doc/library/compileall.rst:23: WARNING: Malformed option description u'directory ...', should look like "-opt args", "--opt args" or "/opt args"
/home/antoine/cpython/default/Doc/library/compileall.rst:23: WARNING: Malformed option description u'file ...', should look like "-opt args", "--opt args" or "/opt args"
/home/antoine/cpython/default/Doc/library/json.rst:593: WARNING: Malformed option description u'infile', should look like "-opt args", "--opt args" or "/opt args"
/home/antoine/cpython/default/Doc/library/json.rst:611: WARNING: Malformed option description u'outfile', should look like "-opt args", "--opt args" or "/opt args"
/home/antoine/cpython/default/Doc/tutorial/appendix.rst:69: WARNING: duplicate label tut-startup, other instance in /home/antoine/cpython/default/Doc/tutorial/interpreter.rst
/home/antoine/cpython/default/Doc/tutorial/appendix.rst:16: WARNING: duplicate label tut-error, other instance in /home/antoine/cpython/default/Doc/tutorial/interpreter.rst
/home/antoine/cpython/default/Doc/tutorial/appendix.rst:102: WARNING: duplicate label tut-customize, other instance in /home/antoine/cpython/default/Doc/tutorial/interpreter.rst
/home/antoine/cpython/default/Doc/tutorial/appendix.rst:38: WARNING: duplicate label tut-scripts, other instance in /home/antoine/cpython/default/Doc/tutorial/interpreter.rst
/home/antoine/cpython/default/Doc/using/cmdline.rst:167: WARNING: Malformed option description u'-?', should look like "-opt args", "--opt args" or "/opt args"
msg227980 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2014-09-30 19:21
These are a bug in Sphinx 1.2.1 and fixed in 1.2.2.
History
Date User Action Args
2022-04-11 14:58:08adminsetgithub: 66717
2014-09-30 19:21:24georg.brandlsetstatus: open -> closed

nosy: + georg.brandl
messages: + msg227980

resolution: third party
2014-09-30 19:01:41pitroucreate