diff options
author | Georg Brandl <georg@python.org> | 2014-03-02 08:50:10 +0100 |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2014-03-02 08:50:10 +0100 |
commit | 85ddf03f45f79a0bc7d20fcceba0057a72452fd1 (patch) | |
tree | 49f519acf9c000d0fa4deefc94f7ac45498f7ac0 | |
parent | db0f7ccc705b37617faf7c6139e96dc826dfdb22 (diff) | |
parent | cae4910527c549e83b8b63e88c90324113846f70 (diff) | |
download | sphinx-git-85ddf03f45f79a0bc7d20fcceba0057a72452fd1.tar.gz |
merge with stable
-rw-r--r-- | doc/extdev/appapi.rst | 2 | ||||
-rw-r--r-- | doc/extdev/markupapi.rst | 4 | ||||
-rw-r--r-- | doc/intl.rst | 2 | ||||
-rw-r--r-- | sphinx/__main__.py | 4 | ||||
-rw-r--r-- | sphinx/builders/gettext.py | 3 | ||||
-rw-r--r-- | sphinx/make_mode.py | 24 | ||||
-rw-r--r-- | sphinx/util/nodes.py | 3 | ||||
-rwxr-xr-x | utils/check_sources.py | 2 |
8 files changed, 27 insertions, 17 deletions
diff --git a/doc/extdev/appapi.rst b/doc/extdev/appapi.rst index 88fd43404..48f5d96e3 100644 --- a/doc/extdev/appapi.rst +++ b/doc/extdev/appapi.rst @@ -218,7 +218,7 @@ package. use ``docutils.nodes.generated`` if you want no further text decoration. If the text should be treated as literal (e.g. no smart quote replacement), but not have typewriter styling, use ``sphinx.addnodes.literal_emphasis`` or - ``sphinx.addnodes.literal_strong``. + ``sphinx.addnodes.literal_strong``. For the role content, you have the same syntactical possibilities as for standard Sphinx roles (see :ref:`xref-syntax`). diff --git a/doc/extdev/markupapi.rst b/doc/extdev/markupapi.rst index 3c09687eb..577a39e0d 100644 --- a/doc/extdev/markupapi.rst +++ b/doc/extdev/markupapi.rst @@ -55,7 +55,7 @@ using :meth:`.Sphinx.add_directive` or :meth:`.Sphinx.add_directive_to_domain`. .. attribute:: arguments The arguments given to the directive, as a list. - + .. attribute:: options The options given to the directive, as a dictionary mapping option names @@ -82,7 +82,7 @@ using :meth:`.Sphinx.add_directive` or :meth:`.Sphinx.add_directive_to_domain`. Internal offset of the directive content. Used when calling ``nested_parse`` (see below). - + .. attribute:: block_text The string containing the entire directive. diff --git a/doc/intl.rst b/doc/intl.rst index 6f74deb0e..3363dc50f 100644 --- a/doc/intl.rst +++ b/doc/intl.rst @@ -294,5 +294,5 @@ There is `sphinx translation page`_ for Sphinx-1.2 documentation. .. _`transifex-client`: https://pypi.python.org/pypi/transifex-client .. _`sphinx-intl`: https://pypi.python.org/pypi/sphinx-intl .. _Transifex: https://www.transifex.com/ -.. _`sphinx translation page`: https://www.transifex.com/projects/p/sphinx-doc-1_2_0/ +.. _`sphinx translation page`: https://www.transifex.com/projects/p/sphinx-doc-1_2_0/ .. _`Transifex Client v0.8 — Transifex documentation`: http://help.transifex.com/features/client/index.html diff --git a/sphinx/__main__.py b/sphinx/__main__.py index ee8419b79..270bc4ebd 100644 --- a/sphinx/__main__.py +++ b/sphinx/__main__.py @@ -1,7 +1,7 @@ # -*- coding: utf-8 -*- """ - Sphinx - ~~~~~~ + sphinx.__main__ + ~~~~~~~~~~~~~~~ The Sphinx documentation toolchain. diff --git a/sphinx/builders/gettext.py b/sphinx/builders/gettext.py index 06ea45055..e25e780a9 100644 --- a/sphinx/builders/gettext.py +++ b/sphinx/builders/gettext.py @@ -56,7 +56,8 @@ class Catalog(object): def add(self, msg, origin): if not hasattr(origin, 'uid'): - # Nodes that are replicated like todo don't have a uid, however i18n is also unnecessary. + # Nodes that are replicated like todo don't have a uid, + # however i18n is also unnecessary. return if msg not in self.metadata: # faster lookup in hash self.messages.append(msg) diff --git a/sphinx/make_mode.py b/sphinx/make_mode.py index 804c095ce..c18aec8b1 100644 --- a/sphinx/make_mode.py +++ b/sphinx/make_mode.py @@ -50,7 +50,8 @@ BUILDERS = [ ("", "xml", "to make Docutils-native XML files"), ("", "pseudoxml", "to make pseudoxml-XML files for display purposes"), ("", "linkcheck", "to check all external links for integrity"), - ("", "doctest", "to run all doctests embedded in the documentation (if enabled)"), + ("", "doctest", "to run all doctests embedded in the documentation " + "(if enabled)"), ("", "coverage", "to run coverage check of the documentation (if enabled)"), ] @@ -92,13 +93,15 @@ class Make(object): if self.run_generic_build('dirhtml') > 0: return 1 print() - print('Build finished. The HTML pages are in %s.' % self.builddir_join('dirhtml')) + print('Build finished. The HTML pages are in %s.' % + self.builddir_join('dirhtml')) def build_singlehtml(self): if self.run_generic_build('singlehtml') > 0: return 1 print() - print('Build finished. The HTML page is in %s.' % self.builddir_join('singlehtml')) + print('Build finished. The HTML page is in %s.' % + self.builddir_join('singlehtml')) def build_pickle(self): if self.run_generic_build('pickle') > 0: @@ -127,7 +130,8 @@ class Make(object): '.qhcp project file in %s, like this:' % self.builddir_join('qthelp')) print('$ qcollectiongenerator %s.qhcp' % self.builddir_join('qthelp', proj_name)) print('To view the help file:') - print('$ assistant -collectionFile %s.qhc' % self.builddir_join('qthelp', proj_name)) + print('$ assistant -collectionFile %s.qhc' % + self.builddir_join('qthelp', proj_name)) def build_devhelp(self): if self.run_generic_build('devhelp') > 0: @@ -173,7 +177,8 @@ class Make(object): def build_texinfo(self): if self.run_generic_build('texinfo') > 0: return 1 - print("Build finished; the Texinfo files are in %s." % self.builddir_join('texinfo')) + print("Build finished; the Texinfo files are in %s." % + self.builddir_join('texinfo')) if os.name == 'posix': print("Run `make' in that directory to run these through makeinfo") print("(use `make info' here to do that automatically).") @@ -188,13 +193,15 @@ class Make(object): if self.run_generic_build('gettext', doctreedir=dtdir) > 0: return 1 print() - print('Build finished. The message catalogs are in %s.' % self.builddir_join('gettext')) + print('Build finished. The message catalogs are in %s.' % + self.builddir_join('gettext')) def build_changes(self): if self.run_generic_build('changes') > 0: return 1 print() - print('Build finished. The overview file is in %s.' % self.builddir_join('changes')) + print('Build finished. The overview file is in %s.' % + self.builddir_join('changes')) def build_linkcheck(self): res = self.run_generic_build('linkcheck') @@ -227,7 +234,8 @@ class Make(object): if self.run_generic_build('pseudoxml') > 0: return 1 print() - print('Build finished. The pseudo-XML files are in %s.' % self.builddir_join('pseudoxml')) + print('Build finished. The pseudo-XML files are in %s.' % + self.builddir_join('pseudoxml')) def run_generic_build(self, builder, doctreedir=None): # compatibility with old Makefile diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py index ca8fa2ac6..ed7abe865 100644 --- a/sphinx/util/nodes.py +++ b/sphinx/util/nodes.py @@ -58,7 +58,8 @@ def extract_messages(doctree): # this issue was filed to Docutils tracker: # sf.net/tracker/?func=detail&aid=3599485&group_id=38414&atid=422032 # sourceforge.net/p/docutils/patches/108/ - if isinstance(node, (nodes.caption, nodes.title, nodes.rubric)) and not node.source: + if isinstance(node, (nodes.caption, nodes.title, nodes.rubric)) \ + and not node.source: node.source = find_source_node(node) node.line = 0 #need fix docutils to get `node.line` diff --git a/utils/check_sources.py b/utils/check_sources.py index 3c6cdcc40..6b984ad6d 100755 --- a/utils/check_sources.py +++ b/utils/check_sources.py @@ -63,7 +63,7 @@ if sys.version_info < (3, 0): def check_style_and_encoding(fn, lines): encoding = 'ascii' for lno, line in enumerate(lines): - if len(line) > 81: + if len(line) > 90: yield lno+1, "line too long" if lno < 2: co = coding_re.search(line) |