A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://mail.python.org/pipermail/python-dev/2012-January/115501.html below:

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

[Python-Dev] Sphinx version for Python 2.x docsÉric Araujo merwok at netwok.org
Sat Jan 14 04:24:52 CET 2012
Hi Sandro,

Thanks for getting the ball rolling on this.  One style for markup, one
Sphinx version to code our extensions against and one location for the
documenting guidelines will make our work a bit easier.

> During the build process, there are some warnings that I can 
> understand:
I assume you mean “can’t”, as you later ask how to fix them.  As a
general rule, they’re only warnings, so they don’t break the build, 
only
some links or stylings, so I think it’s okay to ignore them *right 
now*.

> Doc/glossary.rst:520: WARNING: unknown keyword: nonlocal
That’s a mistake I did in cefe4f38fa0e.  This sentence should be 
removed.

> Doc/library/stdtypes.rst:2372: WARNING: more than one target found 
> for
> cross-reference u'next':
Need to use :meth:`.next` to let Sphinx find the right target (more 
info
on request :)

> Doc/library/sys.rst:651: WARNING: unknown keyword: None
Should use ``None``.

> Doc/reference/datamodel.rst:1942: WARNING: unknown keyword: not in
> Doc/reference/expressions.rst:1184: WARNING: unknown keyword: is not
I don’t know if these should work (i.e. create a link to the 
appropriate
language reference section) or abuse the markup (there are “not” and
“in” keywords, but no “not in” keyword → use ``not in``).  I’d say 
ignore
them.

Cheers
More information about the Python-Dev mailing list

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4