summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2014-03-02 08:50:10 +0100
committerGeorg Brandl <georg@python.org>2014-03-02 08:50:10 +0100
commit85ddf03f45f79a0bc7d20fcceba0057a72452fd1 (patch)
tree49f519acf9c000d0fa4deefc94f7ac45498f7ac0
parentdb0f7ccc705b37617faf7c6139e96dc826dfdb22 (diff)
parentcae4910527c549e83b8b63e88c90324113846f70 (diff)
downloadsphinx-git-85ddf03f45f79a0bc7d20fcceba0057a72452fd1.tar.gz
merge with stable
-rw-r--r--doc/extdev/appapi.rst2
-rw-r--r--doc/extdev/markupapi.rst4
-rw-r--r--doc/intl.rst2
-rw-r--r--sphinx/__main__.py4
-rw-r--r--sphinx/builders/gettext.py3
-rw-r--r--sphinx/make_mode.py24
-rw-r--r--sphinx/util/nodes.py3
-rwxr-xr-xutils/check_sources.py2
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 &mdash; 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)