homepage

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: Various markup errors in documentation
Type: Stage: resolved
Components: Documentation Versions: Python 3.4, Python 3.5
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: berker.peksag Nosy List: berker.peksag, ezio.melotti, georg.brandl, python-dev, r.david.murray
Priority: low Keywords: easy, patch

Created on 2014年08月22日 15:59 by berker.peksag, last changed 2022年04月11日 14:58 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
markup.diff berker.peksag, 2014年08月22日 15:59
Messages (7)
msg225682 - (view) Author: Berker Peksag (berker.peksag) * (Python committer) Date: 2014年08月22日 15:59
/home/berker/projects/cpython/default/Doc/extending/newtypes.rst:985: ERROR: Error in "note" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/faq/library.rst:700: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/argparse.rst:1896: ERROR: Error in "warning" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/asyncio-eventloop.rst:200: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/asyncio-protocol.rst:397: ERROR: Error in "note" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/asyncio-protocol.rst:405: ERROR: Error in "note" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/asyncio-task.rst:271: ERROR: Error in "note" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/email.contentmanager.rst:404: ERROR: Error in "note" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/logging.handlers.rst:867: ERROR: Error in "note" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/multiprocessing.rst:853: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/os.rst:59: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/pathlib.rst:34: ERROR: Error in "note" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/pathlib.rst:40: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/pathlib.rst:43: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/pickle.rst:143: ERROR: Error in "note" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/ssl.rst:269: ERROR: Error in "note" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/ssl.rst:934: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/statistics.rst:138: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/stdtypes.rst:3874: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/sys.rst:800: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/library/warnings.rst:43: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/using/cmdline.rst:109: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/using/cmdline.rst:161: ERROR: Error in "seealso" directive:
invalid option block.
/home/berker/projects/cpython/default/Doc/using/cmdline.rst:364: ERROR: Error in "seealso" directive:
invalid option block.
msg227723 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2014年09月27日 20:22
New changeset 0ec56e677bc3 by Berker Peksag in branch '3.4':
Issue #22251: Fix ReST markup to avoid errors building docs.
https://hg.python.org/cpython/rev/0ec56e677bc3
New changeset ed1dbac90b92 by Berker Peksag in branch 'default':
Issue #22251: Fix ReST markup to avoid errors building docs.
https://hg.python.org/cpython/rev/ed1dbac90b92 
msg227724 - (view) Author: Berker Peksag (berker.peksag) * (Python committer) Date: 2014年09月27日 20:24
See issue 16805 for a similar issue.
msg227725 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2014年09月27日 20:24
These "errors" are all valid markup. They would have been discovered much earlier had they been errors.
Please consider checking why your Sphinx setup produces the errors, fixing it and then reverting the changes.
msg227726 - (view) Author: R. David Murray (r.david.murray) * (Python committer) Date: 2014年09月27日 20:42
I suppose this is one disadvantage of using the system sphinx when 'make html' is run?
msg227729 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2014年09月27日 21:01
New changeset 0b84904c9471 by Berker Peksag in branch '3.4':
Revert #22251
https://hg.python.org/cpython/rev/0b84904c9471
New changeset 78ae78f967f1 by Berker Peksag in branch 'default':
Revert #22251
https://hg.python.org/cpython/rev/78ae78f967f1 
msg227730 - (view) Author: Berker Peksag (berker.peksag) * (Python committer) Date: 2014年09月27日 21:03
I was using Sphinx 1.2.2 and found two related issues: issue 16805 and issue 20961.
I've just upgraded Sphinx to 1.2.3, did a clean checkout, reverted the changes and everything looks good.
Sorry for the noise!
History
Date User Action Args
2022年04月11日 14:58:07adminsetgithub: 66447
2014年09月27日 21:03:09berker.peksagsetstatus: open -> closed

messages: + msg227730
2014年09月27日 21:01:45python-devsetmessages: + msg227729
2014年09月27日 20:42:40r.david.murraysetstatus: closed -> open
nosy: + r.david.murray
messages: + msg227726

2014年09月27日 20:24:59georg.brandlsetmessages: + msg227725
2014年09月27日 20:24:22berker.peksagsetmessages: + msg227724
2014年09月27日 20:23:04berker.peksagsetstatus: open -> closed
resolution: fixed
stage: patch review -> resolved
2014年09月27日 20:22:29python-devsetnosy: + python-dev
messages: + msg227723
2014年08月22日 15:59:53berker.peksagcreate

AltStyle によって変換されたページ (->オリジナル) /