[Python-Dev] Sphinx version for Python 2.x docs

[Sandro Tosi]

Hi all,

On Sat, Aug 27, 2011 at 07:47, Georg Brandl <g.brandl at gmx.net> wrote:
> One of the main reasons for keeping Sphinx compatibility to 0.6.x was to
> enable distributions (like Debian) to build the docs for the Python they ship
> with the version of Sphinx that they ship.
>
> This should now be fine with 1.0.x, so since you are ready to do the work of
> converting the 2.7 Doc sources, it will be accepted.  The argument of easier
> backports is a very good one.

Not exactly as quickly as I would, I started to work on upgrading
sphinx for 2.7. Currently I've all the preliminary patches at:

http://hg.python.org/sandbox/morph/shortlog/5057ce392838

in the 2.7-sphinx branch (they fix one thing at a time, they'll be
collapsed once all ready).

During the build process, there are some warnings that I can understand:

writing output... [100%] whatsnew/index
/home/morph/cpython/morph_sandbox/Doc/glossary.rst:520: WARNING:
unknown keyword: nonlocal
/home/morph/cpython/morph_sandbox/Doc/library/stdtypes.rst:2372:
WARNING: more than one target found for cross-reference u'next':
iterator.next, multifile.MultiFile.next, csv.csvreader.next,
dbhash.dbhash.next, mailbox.oldmailbox.next, ttk.Treeview.next,
nntplib.NNTP.next, file.next, bsddb.bsddbobject.next,
tarfile.TarFile.next, generator.next
/home/morph/cpython/morph_sandbox/Doc/library/stdtypes.rst:2372:
WARNING: more than one target found for cross-reference u'next':
iterator.next, multifile.MultiFile.next, csv.csvreader.next,
dbhash.dbhash.next, mailbox.oldmailbox.next, ttk.Treeview.next,
nntplib.NNTP.next, file.next, bsddb.bsddbobject.next,
tarfile.TarFile.next, generator.next
/home/morph/cpython/morph_sandbox/Doc/library/sys.rst:651: WARNING:
unknown keyword: None
/home/morph/cpython/morph_sandbox/Doc/library/sys.rst:712: WARNING:
unknown keyword: None
/home/morph/cpython/morph_sandbox/Doc/reference/datamodel.rst:1942:
WARNING: unknown keyword: not in
/home/morph/cpython/morph_sandbox/Doc/reference/expressions.rst:1101:
WARNING: unknown keyword: not in
/home/morph/cpython/morph_sandbox/Doc/reference/expressions.rst:1135:
WARNING: unknown keyword: not in
/home/morph/cpython/morph_sandbox/Doc/reference/expressions.rst:1176:
WARNING: unknown keyword: not in
/home/morph/cpython/morph_sandbox/Doc/reference/expressions.rst:1184:
WARNING: unknown keyword: is not
/home/morph/cpython/morph_sandbox/Doc/reference/expressions.rst:1362:
WARNING: unknown keyword: is not
/home/morph/cpython/morph_sandbox/Doc/reference/simple_stmts.rst:700:
WARNING: unknown keyword: None
/home/morph/cpython/morph_sandbox/Doc/reference/simple_stmts.rst:729:
WARNING: unknown keyword: None
/home/morph/cpython/morph_sandbox/Doc/reference/simple_stmts.rst:729:
WARNING: unknown keyword: None
writing additional files... genindex py-modindex search download index
opensearch

Do you know how I can fix them?

Thanks & Cheers,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi