From 50fadb9e94078e38fa9b3d2974171cd6397bc31a Mon Sep 17 00:00:00 2001
From: Roland Meister <Roland Meister@localhost>
Date: Mon, 10 Dec 2012 21:54:11 +0100
Subject: [PATCH 01/29] Bug #1047: templating toctree()'s includehidden
 argument

Document the includehidden option and give it sane defaults.
See bug #1047 for implementation alternatives.
---
 doc/templating.rst      | 3 +++
 sphinx/builders/html.py | 2 ++
 2 files changed, 5 insertions(+)

diff --git a/doc/templating.rst b/doc/templating.rst
index 05a1346c0..b9dfc683b 100644
--- a/doc/templating.rst
+++ b/doc/templating.rst
@@ -391,3 +391,6 @@ are in HTML form), these variables are also available:
 
    * ``titles_only`` (false by default): if true, put only toplevel document
      titles in the tree
+
+   * ``includehidden`` (false by default): if true, the TOC tree will also
+     contain hidden entries.
diff --git a/sphinx/builders/html.py b/sphinx/builders/html.py
index f5218673f..7fa42057f 100644
--- a/sphinx/builders/html.py
+++ b/sphinx/builders/html.py
@@ -653,6 +653,8 @@ class StandaloneHTMLBuilder(Builder):
             self.indexer.feed(pagename, title, doctree)
 
     def _get_local_toctree(self, docname, collapse=True, **kwds):
+        if 'includehidden' not in kwds:
+            kwds['includehidden'] = False
         return self.render_partial(self.env.get_toctree_for(
             docname, self, collapse, **kwds))['fragment']
 

From 567671f4d84f22c8528a098db431c4d36323c808 Mon Sep 17 00:00:00 2001
From: Roland Meister <Roland Meister@localhost>
Date: Mon, 10 Dec 2012 22:01:01 +0100
Subject: [PATCH 02/29] Bug #1046: templating toctree() does not expand to
 maxdepth past maxdepth

If the current page is nested larger than maxdepth it gets deleted
before it can be marked as current. The toctree then callapses to
the top entries. Split _walk_depth in two parts, first just add
the current tag, and remove unneeded entries in a second call.
---
 sphinx/environment.py | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/sphinx/environment.py b/sphinx/environment.py
index cada082d7..69dcdf7de 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -1342,18 +1342,22 @@ class BuildEnvironment:
                     if maxdepth > 0 and depth > maxdepth:
                         subnode.parent.replace(subnode, [])
                     else:
-                        # to find out what to collapse, *first* walk subitems,
-                        # since that determines which children point to the
-                        # current page
+                        # recurse on children
                         _walk_depth(subnode, depth+1, maxdepth)
                         # cull sub-entries whose parents aren't 'current'
                         if (collapse and depth > 1 and
                             'iscurrent' not in subnode.parent):
                             subnode.parent.remove(subnode)
 
+        def _mark_current(node):
+            """Mark current page and its parents with the 'current' class."""
+            for subnode in node.children[:]:
+                if isinstance(subnode, (addnodes.compact_paragraph,
+                                        nodes.list_item, nodes.bullet_list)):
+                    # for <p>, <li> and <ul>, just recurse to children
+                    _mark_current(subnode)
                 elif isinstance(subnode, nodes.reference):
-                    # for <a>, identify which entries point to the current
-                    # document and therefore may not be collapsed
+                    # for <a>, identify the current document
                     if subnode['refuri'] == docname:
                         if not subnode['anchorname']:
                             # give the whole branch a 'current' class
@@ -1472,6 +1476,7 @@ class BuildEnvironment:
         newnode['toctree'] = True
 
         # prune the tree to maxdepth and replace titles, also set level classes
+        _mark_current(newnode)
         _walk_depth(newnode, 1, prune and maxdepth or 0)
 
         # set the target paths in the toctrees (they are not known at TOC

From 12baf340009673ead0713866e39b8deb1558c314 Mon Sep 17 00:00:00 2001
From: Roland Meister <Roland Meister@localhost>
Date: Sat, 22 Dec 2012 23:37:19 +0100
Subject: [PATCH 03/29] Move comment out of _walk_depth and add comment why the
 function was split

---
 sphinx/environment.py | 34 ++++++++++++++++++----------------
 1 file changed, 18 insertions(+), 16 deletions(-)

diff --git a/sphinx/environment.py b/sphinx/environment.py
index 69dcdf7de..d55aa7a2e 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -1311,23 +1311,26 @@ class BuildEnvironment:
         if toctree.get('hidden', False) and not includehidden:
             return None
 
+        # For reading the following two helper function, it is useful to keep
+        # in mind the node structure of a toctree (using HTML-like node names
+        # for brevity):
+        #
+        # <ul>
+        #   <li>
+        #     <p><a></p>
+        #     <p><a></p>
+        #     ...
+        #     <ul>
+        #       ...
+        #     </ul>
+        #   </li>
+        # </ul>
+        #
+        # The transformation is made in two passes in order to avoid
+        # interactions between marking and pruning the tree (see bug #1046).
+
         def _walk_depth(node, depth, maxdepth):
             """Utility: Cut a TOC at a specified depth."""
-
-            # For reading this function, it is useful to keep in mind the node
-            # structure of a toctree (using HTML-like node names for brevity):
-            #
-            # <ul>
-            #   <li>
-            #     <p><a></p>
-            #     <p><a></p>
-            #     ...
-            #     <ul>
-            #       ...
-            #     </ul>
-            #   </li>
-            # </ul>
-
             for subnode in node.children[:]:
                 if isinstance(subnode, (addnodes.compact_paragraph,
                                         nodes.list_item)):
@@ -1335,7 +1338,6 @@ class BuildEnvironment:
                     # recurse to children
                     subnode['classes'].append('toctree-l%d' % (depth-1))
                     _walk_depth(subnode, depth, maxdepth)
-
                 elif isinstance(subnode, nodes.bullet_list):
                     # for <ul>, determine if the depth is too large or if the
                     # entry is to be collapsed

From 0fe9a0252b4866847ca628720b3833a558bfecc4 Mon Sep 17 00:00:00 2001
From: Roland Meister <Roland Meister@localhost>
Date: Sun, 23 Dec 2012 00:03:17 +0100
Subject: [PATCH 04/29] Move adding 'toctree-l%d' classes to _mark_current;
 this fixes the test suite

Also adjust comments and docstrings to reflect the current state.
---
 sphinx/environment.py | 27 +++++++++++++++------------
 1 file changed, 15 insertions(+), 12 deletions(-)

diff --git a/sphinx/environment.py b/sphinx/environment.py
index d55aa7a2e..5eb8afcaf 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -1334,9 +1334,7 @@ class BuildEnvironment:
             for subnode in node.children[:]:
                 if isinstance(subnode, (addnodes.compact_paragraph,
                                         nodes.list_item)):
-                    # for <p> and <li>, just indicate the depth level and
-                    # recurse to children
-                    subnode['classes'].append('toctree-l%d' % (depth-1))
+                    # for <p> and <li>, just recurse
                     _walk_depth(subnode, depth, maxdepth)
                 elif isinstance(subnode, nodes.bullet_list):
                     # for <ul>, determine if the depth is too large or if the
@@ -1344,22 +1342,27 @@ class BuildEnvironment:
                     if maxdepth > 0 and depth > maxdepth:
                         subnode.parent.replace(subnode, [])
                     else:
-                        # recurse on children
+                        # recurse on children, current page is already marked
                         _walk_depth(subnode, depth+1, maxdepth)
                         # cull sub-entries whose parents aren't 'current'
                         if (collapse and depth > 1 and
                             'iscurrent' not in subnode.parent):
                             subnode.parent.remove(subnode)
 
-        def _mark_current(node):
-            """Mark current page and its parents with the 'current' class."""
+        def _mark_current(node, depth):
+            """Add 'toctree-l%d' and 'current' classes to the toctree."""
             for subnode in node.children[:]:
                 if isinstance(subnode, (addnodes.compact_paragraph,
-                                        nodes.list_item, nodes.bullet_list)):
-                    # for <p>, <li> and <ul>, just recurse to children
-                    _mark_current(subnode)
+                                        nodes.list_item)):
+                    # for <p> and <li>, indicate the depth level and recurse
+                    subnode['classes'].append('toctree-l%d' % (depth-1))
+                    _mark_current(subnode, depth)
+                elif isinstance(subnode, nodes.bullet_list):
+                    # for <ul>, just recurse
+                    _mark_current(subnode, depth+1)
                 elif isinstance(subnode, nodes.reference):
-                    # for <a>, identify the current document
+                    # for <a>, identify which entries point to the current
+                    # document and therefore may not be collapsed
                     if subnode['refuri'] == docname:
                         if not subnode['anchorname']:
                             # give the whole branch a 'current' class
@@ -1477,8 +1480,8 @@ class BuildEnvironment:
         newnode = addnodes.compact_paragraph('', '', *tocentries)
         newnode['toctree'] = True
 
-        # prune the tree to maxdepth and replace titles, also set level classes
-        _mark_current(newnode)
+        # prune the tree to maxdepth, also set toc depth and current classes
+        _mark_current(newnode, 1)
         _walk_depth(newnode, 1, prune and maxdepth or 0)
 
         # set the target paths in the toctrees (they are not known at TOC

From 37c862e9c948f9d046c97f506f4a7799228b9076 Mon Sep 17 00:00:00 2001
From: Roland Meister <Roland Meister@localhost>
Date: Sun, 23 Dec 2012 00:12:08 +0100
Subject: [PATCH 05/29] Rename helper functions for resolve_toctree to reflect
 their intent

---
 sphinx/environment.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/sphinx/environment.py b/sphinx/environment.py
index 5eb8afcaf..46789c29c 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -1329,13 +1329,13 @@ class BuildEnvironment:
         # The transformation is made in two passes in order to avoid
         # interactions between marking and pruning the tree (see bug #1046).
 
-        def _walk_depth(node, depth, maxdepth):
+        def _toctree_prune(node, depth, maxdepth):
             """Utility: Cut a TOC at a specified depth."""
             for subnode in node.children[:]:
                 if isinstance(subnode, (addnodes.compact_paragraph,
                                         nodes.list_item)):
                     # for <p> and <li>, just recurse
-                    _walk_depth(subnode, depth, maxdepth)
+                    _toctree_prune(subnode, depth, maxdepth)
                 elif isinstance(subnode, nodes.bullet_list):
                     # for <ul>, determine if the depth is too large or if the
                     # entry is to be collapsed
@@ -1343,23 +1343,23 @@ class BuildEnvironment:
                         subnode.parent.replace(subnode, [])
                     else:
                         # recurse on children, current page is already marked
-                        _walk_depth(subnode, depth+1, maxdepth)
+                        _toctree_prune(subnode, depth+1, maxdepth)
                         # cull sub-entries whose parents aren't 'current'
                         if (collapse and depth > 1 and
                             'iscurrent' not in subnode.parent):
                             subnode.parent.remove(subnode)
 
-        def _mark_current(node, depth):
+        def _toctree_add_classes(node, depth):
             """Add 'toctree-l%d' and 'current' classes to the toctree."""
             for subnode in node.children[:]:
                 if isinstance(subnode, (addnodes.compact_paragraph,
                                         nodes.list_item)):
                     # for <p> and <li>, indicate the depth level and recurse
                     subnode['classes'].append('toctree-l%d' % (depth-1))
-                    _mark_current(subnode, depth)
+                    _toctree_add_classes(subnode, depth)
                 elif isinstance(subnode, nodes.bullet_list):
                     # for <ul>, just recurse
-                    _mark_current(subnode, depth+1)
+                    _toctree_add_classes(subnode, depth+1)
                 elif isinstance(subnode, nodes.reference):
                     # for <a>, identify which entries point to the current
                     # document and therefore may not be collapsed
@@ -1481,8 +1481,8 @@ class BuildEnvironment:
         newnode['toctree'] = True
 
         # prune the tree to maxdepth, also set toc depth and current classes
-        _mark_current(newnode, 1)
-        _walk_depth(newnode, 1, prune and maxdepth or 0)
+        _toctree_add_classes(newnode, 1)
+        _toctree_prune(newnode, 1, prune and maxdepth or 0)
 
         # set the target paths in the toctrees (they are not known at TOC
         # generation time)

From 224a76f865b6910d0c8721680515fc544e7b572a Mon Sep 17 00:00:00 2001
From: Roland Meister <Roland Meister@localhost>
Date: Sun, 23 Dec 2012 00:17:33 +0100
Subject: [PATCH 06/29] Remove unneeded copy of children in
 _toctree_add_classes

---
 sphinx/environment.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/environment.py b/sphinx/environment.py
index 46789c29c..29e7a79bc 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -1351,7 +1351,7 @@ class BuildEnvironment:
 
         def _toctree_add_classes(node, depth):
             """Add 'toctree-l%d' and 'current' classes to the toctree."""
-            for subnode in node.children[:]:
+            for subnode in node.children:
                 if isinstance(subnode, (addnodes.compact_paragraph,
                                         nodes.list_item)):
                     # for <p> and <li>, indicate the depth level and recurse

From 417aff228c0e9eb815e1f46a5335477e1a203a5d Mon Sep 17 00:00:00 2001
From: Roland Meister <Roland Meister@localhost>
Date: Sun, 23 Dec 2012 00:27:32 +0100
Subject: [PATCH 07/29] Avoid recurson on invisible entries in _toctree_prune

---
 sphinx/environment.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/sphinx/environment.py b/sphinx/environment.py
index 29e7a79bc..d1885e852 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -1342,12 +1342,13 @@ class BuildEnvironment:
                     if maxdepth > 0 and depth > maxdepth:
                         subnode.parent.replace(subnode, [])
                     else:
-                        # recurse on children, current page is already marked
-                        _toctree_prune(subnode, depth+1, maxdepth)
                         # cull sub-entries whose parents aren't 'current'
                         if (collapse and depth > 1 and
                             'iscurrent' not in subnode.parent):
                             subnode.parent.remove(subnode)
+                        else:
+                            # recurse on visible children  
+                            _toctree_prune(subnode, depth+1, maxdepth)
 
         def _toctree_add_classes(node, depth):
             """Add 'toctree-l%d' and 'current' classes to the toctree."""

From 054833a96f60ea1ae4b09d384b451066e552bff9 Mon Sep 17 00:00:00 2001
From: Georg Brandl <georg@python.org>
Date: Thu, 3 Jan 2013 10:10:53 +0100
Subject: [PATCH 08/29] Issue #1067: in search index generation, record words
 in section titles in their own set

---
 sphinx/environment.py     |  2 +-
 sphinx/search/__init__.py | 73 +++++++++++++++++++++++++--------------
 2 files changed, 48 insertions(+), 27 deletions(-)

diff --git a/sphinx/environment.py b/sphinx/environment.py
index 85bda8a5f..455c24758 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -71,7 +71,7 @@ default_settings = {
 
 # This is increased every time an environment attribute is added
 # or changed to properly invalidate pickle files.
-ENV_VERSION = 41
+ENV_VERSION = 42
 
 
 default_substitutions = set([
diff --git a/sphinx/search/__init__.py b/sphinx/search/__init__.py
index 6c87c525f..e28b5a6d9 100644
--- a/sphinx/search/__init__.py
+++ b/sphinx/search/__init__.py
@@ -9,9 +9,10 @@
     :license: BSD, see LICENSE for details.
 """
 import re
+import itertools
 import cPickle as pickle
 
-from docutils.nodes import comment, Text, NodeVisitor, SkipNode
+from docutils.nodes import comment, title, Text, NodeVisitor, SkipNode
 
 from sphinx.util import jsdump, rpartition
 
@@ -92,6 +93,7 @@ var Stemmer = function() {
             (ord(word[0]) < 256 and (len(word) < 3 or word in self.stopwords or
                                      word.isdigit())))
 
+
 from sphinx.search import en, ja
 
 languages = {
@@ -137,13 +139,16 @@ class WordCollector(NodeVisitor):
     def __init__(self, document, lang):
         NodeVisitor.__init__(self, document)
         self.found_words = []
+        self.found_title_words = []
         self.lang = lang
 
     def dispatch_visit(self, node):
         if node.__class__ is comment:
             raise SkipNode
-        if node.__class__ is Text:
+        elif node.__class__ is Text:
             self.found_words.extend(self.lang.split(node.astext()))
+        elif node.__class__ is title:
+            self.found_title_words.extend(self.lang.split(node.astext()))
 
 
 class IndexBuilder(object):
@@ -162,6 +167,8 @@ class IndexBuilder(object):
         self._titles = {}
         # stemmed word -> set(filenames)
         self._mapping = {}
+        # stemmed words in titles -> set(filenames)
+        self._title_mapping = {}
         # objtype -> index
         self._objtypes = {}
         # objtype index -> (domain, type, objname (localized))
@@ -179,12 +186,18 @@ class IndexBuilder(object):
             raise ValueError('old format')
         index2fn = frozen['filenames']
         self._titles = dict(zip(index2fn, frozen['titles']))
-        self._mapping = {}
-        for k, v in frozen['terms'].iteritems():
-            if isinstance(v, int):
-                self._mapping[k] = set([index2fn[v]])
-            else:
-                self._mapping[k] = set(index2fn[i] for i in v)
+
+        def load_terms(mapping):
+            rv = {}
+            for k, v in mapping.iteritems():
+                if isinstance(v, int):
+                    rv[k] = set([index2fn[v]])
+                else:
+                    rv[k] = set(index2fn[i] for i in v)
+            return rv
+
+        self._mapping = load_terms(frozen['terms'])
+        self._title_mapping = load_terms(frozen['section_terms'])
         # no need to load keywords/objtypes
 
     def dump(self, stream, format):
@@ -229,28 +242,31 @@ class IndexBuilder(object):
         return rv
 
     def get_terms(self, fn2index):
-        rv = {}
-        for k, v in self._mapping.iteritems():
-            if len(v) == 1:
-                fn, = v
-                if fn in fn2index:
-                    rv[k] = fn2index[fn]
-            else:
-                rv[k] = [fn2index[fn] for fn in v if fn in fn2index]
-        return rv
+        rvs = {}, {}
+        for rv, mapping in zip(rvs, (self._mapping, self._title_mapping)):
+            for k, v in mapping.iteritems():
+                if len(v) == 1:
+                    fn, = v
+                    if fn in fn2index:
+                        rv[k] = fn2index[fn]
+                else:
+                    rv[k] = [fn2index[fn] for fn in v if fn in fn2index]
+        return rvs
 
     def freeze(self):
         """Create a usable data structure for serializing."""
         filenames = self._titles.keys()
         titles = self._titles.values()
         fn2index = dict((f, i) for (i, f) in enumerate(filenames))
-        terms = self.get_terms(fn2index)
+        terms, title_terms = self.get_terms(fn2index)
+
         objects = self.get_objects(fn2index)  # populates _objtypes
         objtypes = dict((v, k[0] + ':' + k[1])
                         for (k, v) in self._objtypes.iteritems())
         objnames = self._objnames
         return dict(filenames=filenames, titles=titles, terms=terms,
-                    objects=objects, objtypes=objtypes, objnames=objnames)
+                    objects=objects, objtypes=objtypes, objnames=objnames,
+                    titleterms=title_terms)
 
     def prune(self, filenames):
         """Remove data for all filenames not in the list."""
@@ -261,6 +277,8 @@ class IndexBuilder(object):
         self._titles = new_titles
         for wordnames in self._mapping.itervalues():
             wordnames.intersection_update(filenames)
+        for wordnames in self._title_mapping.itervalues():
+            wordnames.intersection_update(filenames)
 
     def feed(self, filename, title, doctree):
         """Feed a doctree to the index."""
@@ -269,16 +287,19 @@ class IndexBuilder(object):
         visitor = WordCollector(doctree, self.lang)
         doctree.walk(visitor)
 
-        def add_term(word, stem=self.lang.stem):
-            word = stem(word)
-            if self.lang.word_filter(word):
-                self._mapping.setdefault(word, set()).add(filename)
+        stem = self.lang.stem
+        filter =  self.lang.word_filter
 
-        for word in self.lang.split(title):
-            add_term(word)
+        for word in itertools.chain(visitor.found_title_words,
+                                    self.lang.split(title)):
+            word = stem(word)
+            if filter(word):
+                self._title_mapping.setdefault(word, set()).add(filename)
 
         for word in visitor.found_words:
-            add_term(word)
+            word = stem(word)
+            if word not in self._title_mapping and filter(word):
+                self._mapping.setdefault(word, set()).add(filename)
 
     def context_for_searchtool(self):
         return dict(

From c428cbe44c65accd2861c6848932c1edc5b6d708 Mon Sep 17 00:00:00 2001
From: Georg Brandl <georg@python.org>
Date: Thu, 3 Jan 2013 10:11:18 +0100
Subject: [PATCH 09/29] Add Hernan.

---
 AUTHORS | 1 +
 1 file changed, 1 insertion(+)

diff --git a/AUTHORS b/AUTHORS
index a24d6a545..2a9dbbac9 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -13,6 +13,7 @@ Other contributors, listed alphabetically, are:
 * Charles Duffy -- original graphviz extension
 * Kevin Dunn -- MathJax extension
 * Josip Dzolonga -- coverage builder
+* Hernan Grecco -- search improvements
 * Horst Gutmann -- internationalization support
 * Martin Hans -- autodoc improvements
 * Doug Hellmann -- graphviz improvements

From dab4377c4feb3956a721828f44a4f37b1447e3fa Mon Sep 17 00:00:00 2001
From: Georg Brandl <georg@python.org>
Date: Thu, 3 Jan 2013 10:36:53 +0100
Subject: [PATCH 10/29] Fix loading the existing search index.

---
 sphinx/search/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/search/__init__.py b/sphinx/search/__init__.py
index e28b5a6d9..a4e306e3e 100644
--- a/sphinx/search/__init__.py
+++ b/sphinx/search/__init__.py
@@ -197,7 +197,7 @@ class IndexBuilder(object):
             return rv
 
         self._mapping = load_terms(frozen['terms'])
-        self._title_mapping = load_terms(frozen['section_terms'])
+        self._title_mapping = load_terms(frozen['titleterms'])
         # no need to load keywords/objtypes
 
     def dump(self, stream, format):

From cfc2245c8dccf3d9d63d014ccbe2fc364a0feb8f Mon Sep 17 00:00:00 2001
From: Georg Brandl <georg@python.org>
Date: Thu, 3 Jan 2013 10:49:28 +0100
Subject: [PATCH 11/29] Issue #1067: Scoring based search results

Modify the search tool to create single result set (instead of the
current 4: regular, important, unimportantResults, objectResults).
Each result has an associated score.

The results are sorted by score before presenting the results. This
modification does not seem to change the search time significantly.

Patch by Hernan E. Grecco.
---
 sphinx/themes/basic/static/searchtools.js_t | 198 ++++++++++----------
 1 file changed, 102 insertions(+), 96 deletions(-)

diff --git a/sphinx/themes/basic/static/searchtools.js_t b/sphinx/themes/basic/static/searchtools.js_t
index d3ce6b191..e22b76db6 100644
--- a/sphinx/themes/basic/static/searchtools.js_t
+++ b/sphinx/themes/basic/static/searchtools.js_t
@@ -34,7 +34,7 @@ jQuery.makeSearchSummary = function(text, keywords, hlwords) {
     rv = rv.highlightText(this, 'highlighted');
   });
   return rv;
-}
+};
 
 {{ search_language_stemming_code|safe }}
 
@@ -86,9 +86,10 @@ var Search = {
     if (this._pulse_status >= 0)
         return;
     function pulse() {
+      var i;
       Search._pulse_status = (Search._pulse_status + 1) % 4;
       var dotString = '';
-      for (var i = 0; i < Search._pulse_status; i++)
+      for (i = 0; i < Search._pulse_status; i++)
         dotString += '.';
       Search.dots.text(dotString);
       if (Search._pulse_status > -1)
@@ -98,7 +99,7 @@ var Search = {
   },
 
   /**
-   * perform a search for something
+   * perform a search for something (or wait until index is loaded)
    */
   performSearch : function(query) {
     // create the required interface elements
@@ -118,17 +119,21 @@ var Search = {
       this.deferQuery(query);
   },
 
+  /**
+   * execute search (requires search index to be loaded)
+   */
   query : function(query) {
+    var i;
     var stopwords = {{ search_language_stop_words }};
 
-    // Stem the searchterms and add them to the correct list
+    // stem the searchterms and add them to the correct list
     var stemmer = new Stemmer();
     var searchterms = [];
     var excluded = [];
     var hlterms = [];
     var tmp = query.split(/\s+/);
     var objectterms = [];
-    for (var i = 0; i < tmp.length; i++) {
+    for (i = 0; i < tmp.length; i++) {
       if (tmp[i] != "") {
           objectterms.push(tmp[i].toLowerCase());
       }
@@ -152,7 +157,7 @@ var Search = {
       // only add if not already in the list
       if (!$u.contains(toAppend, word))
         toAppend.push(word);
-    };
+    }
     var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" "));
 
     // console.debug('SEARCH: searching for:');
@@ -163,86 +168,39 @@ var Search = {
     var filenames = this._index.filenames;
     var titles = this._index.titles;
     var terms = this._index.terms;
-    var fileMap = {};
+    var titleterms = this._index.titleterms;
+
     var files = null;
-    // different result priorities
-    var importantResults = [];
-    var objectResults = [];
-    var regularResults = [];
-    var unimportantResults = [];
+
+    // array of [filename, title, anchor, descr, score]
+    var results = [];
     $('#search-progress').empty();
 
     // lookup as object
-    for (var i = 0; i < objectterms.length; i++) {
-      var others = [].concat(objectterms.slice(0,i),
+    for (i = 0; i < objectterms.length; i++) {
+      var others = [].concat(objectterms.slice(0, i),
                              objectterms.slice(i+1, objectterms.length))
-      var results = this.performObjectSearch(objectterms[i], others);
-      // Assume first word is most likely to be the object,
-      // other words more likely to be in description.
-      // Therefore put matches for earlier words first.
-      // (Results are eventually used in reverse order).
-      objectResults = results[0].concat(objectResults);
-      importantResults = results[1].concat(importantResults);
-      unimportantResults = results[2].concat(unimportantResults);
+      results = results.concat(this.performObjectSearch(objectterms[i], others));
     }
 
-    // perform the search on the required terms
-    for (var i = 0; i < searchterms.length; i++) {
-      var word = searchterms[i];
-      // no match but word was a required one
-      if ((files = terms[word]) == null)
-        break;
-      if (files.length == undefined) {
-        files = [files];
-      }
-      // create the mapping
-      for (var j = 0; j < files.length; j++) {
-        var file = files[j];
-        if (file in fileMap)
-          fileMap[file].push(word);
-        else
-          fileMap[file] = [word];
-      }
-    }
+    // lookup as search terms in fulltext
+    results = results.concat(this.performTermsSearch(searchterms, excluded, terms, 0))
+                     .concat(this.performTermsSearch(searchterms, excluded, titleterms, 20));
 
-    // now check if the files don't contain excluded terms
-    for (var file in fileMap) {
-      var valid = true;
+    // delete unused variables in order to not waste memory until list is
+    // retrieved completely
+    delete filenames, titles, terms, titleterms;
 
-      // check if all requirements are matched
-      if (fileMap[file].length != searchterms.length)
-        continue;
-
-      // ensure that none of the excluded terms is in the
-      // search result.
-      for (var i = 0; i < excluded.length; i++) {
-        if (terms[excluded[i]] == file ||
-            $u.contains(terms[excluded[i]] || [], file)) {
-          valid = false;
-          break;
-        }
-      }
-
-      // if we have still a valid result we can add it
-      // to the result list
-      if (valid)
-        regularResults.push([filenames[file], titles[file], '', null]);
-    }
-
-    // delete unused variables in order to not waste
-    // memory until list is retrieved completely
-    delete filenames, titles, terms;
-
-    // now sort the regular results descending by title
-    regularResults.sort(function(a, b) {
-      var left = a[1].toLowerCase();
-      var right = b[1].toLowerCase();
-      return (left > right) ? -1 : ((left < right) ? 1 : 0);
+    // now sort the regular results by score (in opposite order of appearance,
+    // since the display function below uses pop() to retrieve items)
+    results.sort(function(a, b) {
+      var left = a[4];
+      var right = b[4];
+      return (left > right) ? 1 : ((left < right) ? -1 : 0);
     });
 
-    // combine all results
-    var results = unimportantResults.concat(regularResults)
-      .concat(objectResults).concat(importantResults);
+    console.info('search results:', results);
+    Search.lastresults = results.slice();  // a copy
 
     // print the results
     var resultCount = results.length;
@@ -307,15 +265,17 @@ var Search = {
     displayNextItem();
   },
 
+  /**
+   * search for object names
+   */
   performObjectSearch : function(object, otherterms) {
     var filenames = this._index.filenames;
     var objects = this._index.objects;
     var objnames = this._index.objnames;
     var titles = this._index.titles;
 
-    var importantResults = [];
-    var objectResults = [];
-    var unimportantResults = [];
+    var i;
+    var results = [];
 
     for (var prefix in objects) {
       for (var name in objects[prefix]) {
@@ -330,7 +290,7 @@ var Search = {
             var haystack = (prefix + ' ' + name + ' ' +
                             objname + ' ' + title).toLowerCase();
             var allfound = true;
-            for (var i = 0; i < otherterms.length; i++) {
+            for (i = 0; i < otherterms.length; i++) {
               if (haystack.indexOf(otherterms[i]) == -1) {
                 allfound = false;
                 break;
@@ -346,32 +306,78 @@ var Search = {
             anchor = fullname;
           else if (anchor == '-')
             anchor = objnames[match[1]][1] + '-' + fullname;
-          result = [filenames[match[0]], fullname, '#'+anchor, descr];
+          result = [filenames[match[0]], fullname, '#'+anchor, descr, 0];
+          var score;
           switch (match[2]) {
-          case 1: objectResults.push(result); break;
-          case 0: importantResults.push(result); break;
-          case 2: unimportantResults.push(result); break;
+          case 1: // normal results -- display between important and fulltext
+            score = 5; break;
+          case 0: // "important" results -- show directly after title results
+            score = 10; break;
+          case 2: // "unimportant" results -- show after fulltext results
+            score = -10; break;
           }
+          results.push([filenames[match[0]], fullname, '#'+anchor, descr, score]);
         }
       }
     }
 
-    // sort results descending
-    objectResults.sort(function(a, b) {
-      return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0);
-    });
+    return results;
+  },
 
-    importantResults.sort(function(a, b) {
-      return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0);
-    });
+  /**
+   * search for full-text terms in the index
+   */
+  performTermsSearch : function(searchterms, excluded, terms, score) {
+    var filenames = this._index.filenames;
+    var titles = this._index.titles;
 
-    unimportantResults.sort(function(a, b) {
-      return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0);
-    });
+    var i;
+    var fileMap = {};
+    var results = [];
 
-    return [importantResults, objectResults, unimportantResults]
-  }
-}
+    // perform the search on the required terms
+    for (i = 0; i < searchterms.length; i++) {
+      var word = searchterms[i];
+      // no match but word was a required one
+      if ((files = terms[word]) == null)
+        break;
+      if (files.length == undefined) {
+        files = [files];
+      }
+      // create the mapping
+      for (var j = 0; j < files.length; j++) {
+        var file = files[j];
+        if (file in fileMap)
+          fileMap[file].push(word);
+        else
+          fileMap[file] = [word];
+      }
+    }
+
+    // now check if the files don't contain excluded terms
+    for (var file in fileMap) {
+      var valid = true;
+
+      // check if all requirements are matched
+      if (fileMap[file].length != searchterms.length)
+          continue;
+
+      // ensure that none of the excluded terms is in the search result
+      for (i = 0; i < excluded.length; i++) {
+        if (terms[excluded[i]] == file ||
+          $u.contains(terms[excluded[i]] || [], file)) {
+          valid = false;
+          break;
+        }
+      }
+
+      // if we have still a valid result we can add it to the result list
+      if (valid)
+        results.push([filenames[file], titles[file], '', null, score]);
+    }
+    return results;
+  },
+};
 
 $(document).ready(function() {
   Search.init();

From d997aa76b0b2ea3a3caf9d2bcd33e4e10bac73d3 Mon Sep 17 00:00:00 2001
From: Jonathan Waltman <jonathan.waltman@gmail.com>
Date: Thu, 3 Jan 2013 13:34:47 -0600
Subject: [PATCH 12/29] Closes #958: Do not preserve ``environment.pickle``
 after a failed build.

---
 CHANGES               | 2 ++
 sphinx/application.py | 5 +++++
 sphinx/environment.py | 5 +----
 3 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/CHANGES b/CHANGES
index 03a83d4f8..af15c8861 100644
--- a/CHANGES
+++ b/CHANGES
@@ -62,6 +62,8 @@ Release 1.2 (in development)
 
 * #1041: Fix cpp domain parser fails to parse a const type with a modifier.
 
+* #958: Do not preserve ``environment.pickle`` after a failed build.
+
 * PR#88: Added the "Sphinx Developer's Guide" (:file:`doc/devguide.rst`)
   which outlines the basic development process of the Sphinx project.
 
diff --git a/sphinx/application.py b/sphinx/application.py
index 9cf90f1dd..6eefc3e44 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -11,6 +11,7 @@
     :license: BSD, see LICENSE for details.
 """
 
+import os
 import sys
 import types
 import posixpath
@@ -203,6 +204,10 @@ class Sphinx(object):
             else:
                 self.builder.build_update()
         except Exception, err:
+            # delete the saved env to force a fresh build next time
+            envfile = path.join(self.doctreedir, ENV_PICKLE_FILENAME)
+            if path.isfile(envfile):
+                os.unlink(envfile)
             self.emit('build-finished', err)
             raise
         else:
diff --git a/sphinx/environment.py b/sphinx/environment.py
index 5103be6a8..5caa09eb8 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -365,9 +365,7 @@ class BuildEnvironment:
         del self.config.values
         domains = self.domains
         del self.domains
-        # first write to a temporary file, so that if dumping fails,
-        # the existing environment won't be overwritten
-        picklefile = open(filename + '.tmp', 'wb')
+        picklefile = open(filename, 'wb')
         # remove potentially pickling-problematic values from config
         for key, val in vars(self.config).items():
             if key.startswith('_') or \
@@ -379,7 +377,6 @@ class BuildEnvironment:
             pickle.dump(self, picklefile, pickle.HIGHEST_PROTOCOL)
         finally:
             picklefile.close()
-        movefile(filename + '.tmp', filename)
         # reset attributes
         self.domains = domains
         self.config.values = values

From cf4166fa58b8dd895c38d7e42ef391e06f8d9bf3 Mon Sep 17 00:00:00 2001
From: Jonathan Waltman <jonathan.waltman@gmail.com>
Date: Thu, 3 Jan 2013 13:55:26 -0600
Subject: [PATCH 13/29] Fix ``test_i18n_literalblock_warning`` which would
 sometimes fail due to the text wrapping of error messages.

---
 tests/test_intl.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/test_intl.py b/tests/test_intl.py
index 545d9c559..decffa91b 100644
--- a/tests/test_intl.py
+++ b/tests/test_intl.py
@@ -219,7 +219,7 @@ def test_i18n_literalblock_warning(app):
               u"\n   this is"
               u"\n   literal block\n"
               u"\nMISSING LITERAL BLOCK:\n"
-              u"\n<SYSTEM MESSAGE: ")
+              u"\n<SYSTEM MESSAGE:")
     assert result.startswith(expect)
 
     warnings = warnfile.getvalue().replace(os.sep, '/')

From 1832284e89435572f778dd3abbd53ef67494cfb5 Mon Sep 17 00:00:00 2001
From: Georg Brandl <georg@python.org>
Date: Fri, 4 Jan 2013 11:17:32 +0100
Subject: [PATCH 14/29] Closes #1067: implement pluggable search scorer and
 tweak scoring to give good results.  Patch by Hernan Grecco.

---
 CHANGES                                     |   4 +
 doc/config.rst                              |   9 ++
 sphinx/builders/html.py                     |   3 +-
 sphinx/config.py                            |   1 +
 sphinx/search/__init__.py                   |   9 +-
 sphinx/themes/basic/static/searchtools.js_t | 148 ++++++++++++++------
 6 files changed, 127 insertions(+), 47 deletions(-)

diff --git a/CHANGES b/CHANGES
index 03a83d4f8..635ba3b80 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,10 @@
 Release 1.2 (in development)
 ============================
 
+* #1067: Improve the ordering of the JavaScript search results: matches in titles
+  come before matches in full text, and object results are better categorized.
+  Also implement a pluggable search scorer.
+
 * PR#72: #975: Fix gettext does not extract definition terms before docutils 0.10.0
 
 * PR#25: In inheritance diagrams, the first line of the class docstring
diff --git a/doc/config.rst b/doc/config.rst
index 0ff6d4051..6174d4871 100644
--- a/doc/config.rst
+++ b/doc/config.rst
@@ -760,6 +760,15 @@ that use Sphinx' HTMLWriter class.
 
    .. versionadded:: 1.1
 
+.. confval:: html_search_scorer
+
+   The name of a javascript file (relative to the configuration directory) that
+   implements a search results scorer.  If empty, the default will be used.
+
+   .. XXX describe interface for scorer here
+
+   .. versionadded:: 1.2
+
 .. confval:: htmlhelp_basename
 
    Output file base name for HTML help builder.  Default is ``'pydoc'``.
diff --git a/sphinx/builders/html.py b/sphinx/builders/html.py
index 77cbb78d4..573bb9b2c 100644
--- a/sphinx/builders/html.py
+++ b/sphinx/builders/html.py
@@ -240,7 +240,8 @@ class StandaloneHTMLBuilder(Builder):
         if not lang or lang not in languages:
             lang = 'en'
         self.indexer = IndexBuilder(self.env, lang,
-                                    self.config.html_search_options)
+                                    self.config.html_search_options,
+                                    self.config.html_search_scorer)
         self.load_indexer(docnames)
 
         self.docwriter = HTMLWriter(self)
diff --git a/sphinx/config.py b/sphinx/config.py
index 1134eb866..b91bd0b11 100644
--- a/sphinx/config.py
+++ b/sphinx/config.py
@@ -110,6 +110,7 @@ class Config(object):
         html_secnumber_suffix = ('. ', 'html'),
         html_search_language = (None, 'html'),
         html_search_options = ({}, 'html'),
+        html_search_scorer = ('', None),
 
         # HTML help only options
         htmlhelp_basename = (lambda self: make_filename(self.project), None),
diff --git a/sphinx/search/__init__.py b/sphinx/search/__init__.py
index a4e306e3e..e43e5d917 100644
--- a/sphinx/search/__init__.py
+++ b/sphinx/search/__init__.py
@@ -161,7 +161,7 @@ class IndexBuilder(object):
         'pickle':   pickle
     }
 
-    def __init__(self, env, lang, options):
+    def __init__(self, env, lang, options, scoring):
         self.env = env
         # filename -> title
         self._titles = {}
@@ -176,6 +176,12 @@ class IndexBuilder(object):
         # add language-specific SearchLanguage instance
         self.lang = languages[lang](options)
 
+        if scoring:
+            with open(scoring, 'rb') as fp:
+                self.js_scorer_code = fp.read().decode('utf-8')
+        else:
+            self.js_scorer_code = u''
+
     def load(self, stream, format):
         """Reconstruct from frozen data."""
         if isinstance(format, basestring):
@@ -305,4 +311,5 @@ class IndexBuilder(object):
         return dict(
             search_language_stemming_code = self.lang.js_stemmer_code,
             search_language_stop_words = jsdump.dumps(sorted(self.lang.stopwords)),
+            search_scorer_tool = self.js_scorer_code,
         )
diff --git a/sphinx/themes/basic/static/searchtools.js_t b/sphinx/themes/basic/static/searchtools.js_t
index e22b76db6..e91e9c667 100644
--- a/sphinx/themes/basic/static/searchtools.js_t
+++ b/sphinx/themes/basic/static/searchtools.js_t
@@ -9,35 +9,42 @@
  *
  */
 
-/**
- * helper function to return a node containing the
- * search summary for a given text. keywords is a list
- * of stemmed words, hlwords is the list of normal, unstemmed
- * words. the first one is used to find the occurance, the
- * latter for highlighting it.
- */
-
-jQuery.makeSearchSummary = function(text, keywords, hlwords) {
-  var textLower = text.toLowerCase();
-  var start = 0;
-  $.each(keywords, function() {
-    var i = textLower.indexOf(this.toLowerCase());
-    if (i > -1)
-      start = i;
-  });
-  start = Math.max(start - 120, 0);
-  var excerpt = ((start > 0) ? '...' : '') +
-  $.trim(text.substr(start, 240)) +
-  ((start + 240 - text.length) ? '...' : '');
-  var rv = $('<div class="context"></div>').text(excerpt);
-  $.each(hlwords, function() {
-    rv = rv.highlightText(this, 'highlighted');
-  });
-  return rv;
-};
-
 {{ search_language_stemming_code|safe }}
 
+{% if search_scorer_tool %}
+{{ search_scorer_tool|safe }}
+{% else %}
+/**
+ * Simple result scoring code.
+ */
+var Scorer = {
+  // Implement the following function to further tweak the score for each result
+  // The function takes a result array [filename, title, anchor, descr, score]
+  // and returns the new score.
+  /*
+  score: function(result) {
+    return result[4];
+  },
+  */
+
+  // query matches the full name of an object
+  objNameMatch: 11,
+  // or matches in the last dotted part of the object name
+  objPartialMatch: 6,
+  // Additive scores depending on the priority of the object
+  objPrio: {0:  15,   // used to be importantResults
+            1:  5,   // used to be objectResults
+            2: -5},  // used to be unimportantResults
+  //  Used when the priority is not in the mapping.
+  objPrioDefault: 0,
+
+  // query found in title
+  title: 15,
+  // query found in terms
+  term: 5
+};
+{% endif %}
+
 /**
  * Search Module
  */
@@ -184,23 +191,40 @@ var Search = {
     }
 
     // lookup as search terms in fulltext
-    results = results.concat(this.performTermsSearch(searchterms, excluded, terms, 0))
-                     .concat(this.performTermsSearch(searchterms, excluded, titleterms, 20));
+    results = results.concat(this.performTermsSearch(searchterms, excluded, terms, Scorer.term))
+                     .concat(this.performTermsSearch(searchterms, excluded, titleterms, Scorer.title));
 
     // delete unused variables in order to not waste memory until list is
     // retrieved completely
     delete filenames, titles, terms, titleterms;
 
-    // now sort the regular results by score (in opposite order of appearance,
-    // since the display function below uses pop() to retrieve items)
+    // let the scorer override scores with a custom scoring function
+    if (Scorer.score) {
+      for (i = 0; i < results.length; i++)
+        results[i][4] = Scorer.score(results[i]);
+    }
+
+    // now sort the results by score (in opposite order of appearance, since the
+    // display function below uses pop() to retrieve items) and then
+    // alphabetically
     results.sort(function(a, b) {
       var left = a[4];
       var right = b[4];
-      return (left > right) ? 1 : ((left < right) ? -1 : 0);
+      if (left > right) {
+        return 1;
+      } else if (left < right) {
+        return -1;
+      } else {
+        // same score: sort alphabetically
+        left = a[1].toLowerCase();
+        right = b[1].toLowerCase();
+        return (left > right) ? -1 : ((left < right) ? 1 : 0);
+      }
     });
 
-    console.info('search results:', results);
-    Search.lastresults = results.slice();  // a copy
+    // for debugging
+    //Search.lastresults = results.slice();  // a copy
+    //console.info('search results:', Search.lastresults);
 
     // print the results
     var resultCount = results.length;
@@ -236,7 +260,7 @@ var Search = {
           $.get(DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' +
                 item[0] + '.txt', function(data) {
             if (data != '') {
-              listItem.append($.makeSearchSummary(data, searchterms, hlterms));
+              listItem.append(Search.makeSearchSummary(data, searchterms, hlterms));
               Search.output.append(listItem);
             }
             listItem.slideDown(5, function() {
@@ -281,6 +305,16 @@ var Search = {
       for (var name in objects[prefix]) {
         var fullname = (prefix ? prefix + '.' : '') + name;
         if (fullname.toLowerCase().indexOf(object) > -1) {
+          var score = 0;
+          var parts = fullname.split('.');
+          // check for different match types: exact matches of full name or
+          // "last name" (i.e. last dotted part)
+          if (fullname == object || parts[parts.length - 1] == object) {
+            score += Scorer.objNameMatch;
+          // matches in last name
+          } else if (parts[parts.length - 1].indexOf(object) > -1) {
+            score += Scorer.objPartialMatch;
+          }
           var match = objects[prefix][name];
           var objname = objnames[match[1]][2];
           var title = titles[match[0]];
@@ -301,20 +335,17 @@ var Search = {
             }
           }
           var descr = objname + _(', in ') + title;
+
           anchor = match[3];
           if (anchor == '')
             anchor = fullname;
           else if (anchor == '-')
             anchor = objnames[match[1]][1] + '-' + fullname;
-          result = [filenames[match[0]], fullname, '#'+anchor, descr, 0];
-          var score;
-          switch (match[2]) {
-          case 1: // normal results -- display between important and fulltext
-            score = 5; break;
-          case 0: // "important" results -- show directly after title results
-            score = 10; break;
-          case 2: // "unimportant" results -- show after fulltext results
-            score = -10; break;
+          // add custom score for some objects according to scorer
+          if (Scorer.objPrio.hasOwnProperty(match[2])) {
+            score += Scorer.objPrio[match[2]];
+          } else {
+            score += Scorer.objPrioDefault;
           }
           results.push([filenames[match[0]], fullname, '#'+anchor, descr, score]);
         }
@@ -372,11 +403,38 @@ var Search = {
       }
 
       // if we have still a valid result we can add it to the result list
-      if (valid)
+      if (valid) {
         results.push([filenames[file], titles[file], '', null, score]);
+      }
     }
     return results;
   },
+
+  /**
+   * helper function to return a node containing the
+   * search summary for a given text. keywords is a list
+   * of stemmed words, hlwords is the list of normal, unstemmed
+   * words. the first one is used to find the occurance, the
+   * latter for highlighting it.
+   */
+  makeSearchSummary : function(text, keywords, hlwords) {
+    var textLower = text.toLowerCase();
+    var start = 0;
+    $.each(keywords, function() {
+      var i = textLower.indexOf(this.toLowerCase());
+      if (i > -1)
+        start = i;
+    });
+    start = Math.max(start - 120, 0);
+    var excerpt = ((start > 0) ? '...' : '') +
+      $.trim(text.substr(start, 240)) +
+      ((start + 240 - text.length) ? '...' : '');
+    var rv = $('<div class="context"></div>').text(excerpt);
+    $.each(hlwords, function() {
+      rv = rv.highlightText(this, 'highlighted');
+    });
+    return rv;
+  }
 };
 
 $(document).ready(function() {

From 73b8622f0931f0a915f5322956bb3a7e4ba4a5c2 Mon Sep 17 00:00:00 2001
From: Georg Brandl <georg@python.org>
Date: Fri, 4 Jan 2013 12:29:43 +0100
Subject: [PATCH 15/29] Correct some JS issues found by JSHint.

---
 sphinx/themes/basic/static/doctools.js      |  2 +-
 sphinx/themes/basic/static/searchtools.js_t | 41 +++++++++------------
 2 files changed, 18 insertions(+), 25 deletions(-)

diff --git a/sphinx/themes/basic/static/doctools.js b/sphinx/themes/basic/static/doctools.js
index 4b65f6aec..8614442eb 100644
--- a/sphinx/themes/basic/static/doctools.js
+++ b/sphinx/themes/basic/static/doctools.js
@@ -32,7 +32,7 @@ if (!window.console || !console.firebug) {
  */
 jQuery.urldecode = function(x) {
   return decodeURIComponent(x).replace(/\+/g, ' ');
-}
+};
 
 /**
  * small helper function to urlencode strings
diff --git a/sphinx/themes/basic/static/searchtools.js_t b/sphinx/themes/basic/static/searchtools.js_t
index e91e9c667..e863df44f 100644
--- a/sphinx/themes/basic/static/searchtools.js_t
+++ b/sphinx/themes/basic/static/searchtools.js_t
@@ -101,7 +101,7 @@ var Search = {
       Search.dots.text(dotString);
       if (Search._pulse_status > -1)
         window.setTimeout(pulse, 500);
-    };
+    }
     pulse();
   },
 
@@ -141,24 +141,25 @@ var Search = {
     var tmp = query.split(/\s+/);
     var objectterms = [];
     for (i = 0; i < tmp.length; i++) {
-      if (tmp[i] != "") {
+      if (tmp[i] !== "") {
           objectterms.push(tmp[i].toLowerCase());
       }
 
       if ($u.indexOf(stopwords, tmp[i]) != -1 || tmp[i].match(/^\d+$/) ||
-          tmp[i] == "") {
+          tmp[i] === "") {
         // skip this "word"
         continue;
       }
       // stem the word
       var word = stemmer.stemWord(tmp[i]).toLowerCase();
+      var toAppend;
       // select the correct list
       if (word[0] == '-') {
-        var toAppend = excluded;
+        toAppend = excluded;
         word = word.substr(1);
       }
       else {
-        var toAppend = searchterms;
+        toAppend = searchterms;
         hlterms.push(tmp[i].toLowerCase());
       }
       // only add if not already in the list
@@ -172,13 +173,9 @@ var Search = {
     // console.info('excluded: ', excluded);
 
     // prepare search
-    var filenames = this._index.filenames;
-    var titles = this._index.titles;
     var terms = this._index.terms;
     var titleterms = this._index.titleterms;
 
-    var files = null;
-
     // array of [filename, title, anchor, descr, score]
     var results = [];
     $('#search-progress').empty();
@@ -186,7 +183,7 @@ var Search = {
     // lookup as object
     for (i = 0; i < objectterms.length; i++) {
       var others = [].concat(objectterms.slice(0, i),
-                             objectterms.slice(i+1, objectterms.length))
+                             objectterms.slice(i+1, objectterms.length));
       results = results.concat(this.performObjectSearch(objectterms[i], others));
     }
 
@@ -194,10 +191,6 @@ var Search = {
     results = results.concat(this.performTermsSearch(searchterms, excluded, terms, Scorer.term))
                      .concat(this.performTermsSearch(searchterms, excluded, titleterms, Scorer.title));
 
-    // delete unused variables in order to not waste memory until list is
-    // retrieved completely
-    delete filenames, titles, terms, titleterms;
-
     // let the scorer override scores with a custom scoring function
     if (Scorer.score) {
       for (i = 0; i < results.length; i++)
@@ -233,7 +226,7 @@ var Search = {
       if (results.length) {
         var item = results.pop();
         var listItem = $('<li style="display:none"></li>');
-        if (DOCUMENTATION_OPTIONS.FILE_SUFFIX == '') {
+        if (DOCUMENTATION_OPTIONS.FILE_SUFFIX === '') {
           // dirhtml builder
           var dirname = item[0] + '/';
           if (dirname.match(/\/index\/$/)) {
@@ -259,7 +252,7 @@ var Search = {
         } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) {
           $.get(DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' +
                 item[0] + '.txt', function(data) {
-            if (data != '') {
+            if (data !== '') {
               listItem.append(Search.makeSearchSummary(data, searchterms, hlterms));
               Search.output.append(listItem);
             }
@@ -336,8 +329,8 @@ var Search = {
           }
           var descr = objname + _(', in ') + title;
 
-          anchor = match[3];
-          if (anchor == '')
+          var anchor = match[3];
+          if (anchor === '')
             anchor = fullname;
           else if (anchor == '-')
             anchor = objnames[match[1]][1] + '-' + fullname;
@@ -362,7 +355,7 @@ var Search = {
     var filenames = this._index.filenames;
     var titles = this._index.titles;
 
-    var i;
+    var i, j, file, files;
     var fileMap = {};
     var results = [];
 
@@ -370,14 +363,14 @@ var Search = {
     for (i = 0; i < searchterms.length; i++) {
       var word = searchterms[i];
       // no match but word was a required one
-      if ((files = terms[word]) == null)
+      if ((files = terms[word]) === null)
         break;
-      if (files.length == undefined) {
+      if (files.length === undefined) {
         files = [files];
       }
       // create the mapping
-      for (var j = 0; j < files.length; j++) {
-        var file = files[j];
+      for (j = 0; j < files.length; j++) {
+        file = files[j];
         if (file in fileMap)
           fileMap[file].push(word);
         else
@@ -386,7 +379,7 @@ var Search = {
     }
 
     // now check if the files don't contain excluded terms
-    for (var file in fileMap) {
+    for (file in fileMap) {
       var valid = true;
 
       // check if all requirements are matched

From 19a8c9e2e5715b1099898378f7d6bb880f0753fa Mon Sep 17 00:00:00 2001
From: Takayuki Shimizukawa <shimizukawa@gmail.com>
Date: Fri, 4 Jan 2013 21:46:17 +0900
Subject: [PATCH 16/29] fix problems with py25,py3x for search index generation

---
 sphinx/search/__init__.py | 7 ++++---
 tests/test_search.py      | 2 +-
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/sphinx/search/__init__.py b/sphinx/search/__init__.py
index e43e5d917..3a43ae8e1 100644
--- a/sphinx/search/__init__.py
+++ b/sphinx/search/__init__.py
@@ -8,6 +8,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
+from __future__ import with_statement
 import re
 import itertools
 import cPickle as pickle
@@ -294,17 +295,17 @@ class IndexBuilder(object):
         doctree.walk(visitor)
 
         stem = self.lang.stem
-        filter =  self.lang.word_filter
+        _filter =  self.lang.word_filter
 
         for word in itertools.chain(visitor.found_title_words,
                                     self.lang.split(title)):
             word = stem(word)
-            if filter(word):
+            if _filter(word):
                 self._title_mapping.setdefault(word, set()).add(filename)
 
         for word in visitor.found_words:
             word = stem(word)
-            if word not in self._title_mapping and filter(word):
+            if word not in self._title_mapping and _filter(word):
                 self._mapping.setdefault(word, set()).add(filename)
 
     def context_for_searchtool(self):
diff --git a/tests/test_search.py b/tests/test_search.py
index f2c174065..e5ae71e96 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -36,7 +36,7 @@ def test_wordcollector():
     doc['file'] = 'dummy'
     parser.parse(FILE_CONTENTS, doc)
 
-    ix = IndexBuilder(None, 'en', {})
+    ix = IndexBuilder(None, 'en', {}, None)
     ix.feed('filename', 'title', doc)
     assert 'boson' not in ix._mapping
     assert 'fermion' in ix._mapping

From 263d5b376f10ae8c8db488ea87f71cb856ecefc6 Mon Sep 17 00:00:00 2001
From: Takayuki Shimizukawa <shimizukawa@gmail.com>
Date: Fri, 4 Jan 2013 18:18:43 +0900
Subject: [PATCH 17/29] Fix text writer can not handle visit_legend for figure
 directive contents.

---
 CHANGES                | 2 ++
 sphinx/writers/text.py | 5 +++++
 tests/root/markup.txt  | 4 ++++
 3 files changed, 11 insertions(+)

diff --git a/CHANGES b/CHANGES
index 0bec2d048..9805b8191 100644
--- a/CHANGES
+++ b/CHANGES
@@ -5,6 +5,8 @@ Release 1.2 (in development)
   come before matches in full text, and object results are better categorized.
   Also implement a pluggable search scorer.
 
+* Fix text writer can not handle visit_legend for figure directive contents.
+
 * PR#72: #975: Fix gettext does not extract definition terms before docutils 0.10.0
 
 * PR#25: In inheritance diagrams, the first line of the class docstring
diff --git a/sphinx/writers/text.py b/sphinx/writers/text.py
index 3332af6f8..2c38aeb4a 100644
--- a/sphinx/writers/text.py
+++ b/sphinx/writers/text.py
@@ -294,6 +294,11 @@ class TextTranslator(nodes.NodeVisitor):
     def visit_label(self, node):
         raise nodes.SkipNode
 
+    def visit_legend(self, node):
+        pass
+    def depart_legend(self, node):
+        pass
+
     # XXX: option list could use some better styling
 
     def visit_option_list(self, node):
diff --git a/tests/root/markup.txt b/tests/root/markup.txt
index dde13a6b5..cbfbbbe3d 100644
--- a/tests/root/markup.txt
+++ b/tests/root/markup.txt
@@ -191,6 +191,10 @@ Figures
 
    My caption of the figure
 
+   My description paragraph of the figure.
+
+   Description paragraph is wraped with legend node.
+
 
 Version markup
 --------------

From ab6706e6edebc153cd6ce85d83ecc78cb6041918 Mon Sep 17 00:00:00 2001
From: Takayuki Shimizukawa <shimizukawa@gmail.com>
Date: Sat, 5 Jan 2013 01:06:42 +0900
Subject: [PATCH 18/29] Closes #940: Fix gettext does not extract figure
 caption.

This is docutils issue.
see also: https://sourceforge.net/tracker/?func=detail&aid=3599485&group_id=38414&atid=422032
---
 CHANGES                            |   2 ++
 sphinx/util/nodes.py               |   7 +++++++
 tests/root/i18n/figure_caption.po  |  29 +++++++++++++++++++++++++++++
 tests/root/i18n/figure_caption.txt |  12 ++++++++++++
 tests/root/i18n/i18n.png           | Bin 0 -> 67861 bytes
 tests/root/i18n/index.txt          |   1 +
 tests/test_intl.py                 |  16 ++++++++++++++++
 7 files changed, 67 insertions(+)
 create mode 100644 tests/root/i18n/figure_caption.po
 create mode 100644 tests/root/i18n/figure_caption.txt
 create mode 100644 tests/root/i18n/i18n.png

diff --git a/CHANGES b/CHANGES
index 9805b8191..2addc2a9b 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,8 @@
 Release 1.2 (in development)
 ============================
 
+* #940: Fix gettext does not extract figure caption.
+
 * #1067: Improve the ordering of the JavaScript search results: matches in titles
   come before matches in full text, and object results are better categorized.
   Also implement a pluggable search scorer.
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index 1e3e08716..da055da0c 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -52,6 +52,13 @@ def extract_messages(doctree):
                 node.line = definition_list_item.line - 1
                 node.rawsource = definition_list_item.\
                                  rawsource.split("\n", 2)[0]
+        # workaround: nodes.caption doesn't have source, line.
+        # this issue was filed to Docutils tracker:
+        # https://sourceforge.net/tracker/?func=detail&aid=3599485&group_id=38414&atid=422032
+        if isinstance(node, nodes.caption) and not node.source:
+            node.source = node.parent.source
+            node.line = ''  #need fix docutils to get `node.line`
+
         if not node.source:
             continue # built-in message
         if isinstance(node, IGNORED_NODES):
diff --git a/tests/root/i18n/figure_caption.po b/tests/root/i18n/figure_caption.po
new file mode 100644
index 000000000..01b4c041e
--- /dev/null
+++ b/tests/root/i18n/figure_caption.po
@@ -0,0 +1,29 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2012, foof
+# This file is distributed under the same license as the foo package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: sphinx 1.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2013-01-04 7:00\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+msgid "i18n with figure caption"
+msgstr "I18N WITH FIGURE CAPTION"
+
+msgid "My caption of the figure"
+msgstr "MY CAPTION OF THE FIGURE"
+
+msgid "My description paragraph1 of the figure."
+msgstr "MY DESCRIPTION PARAGRAPH1 OF THE FIGURE."
+
+msgid "My description paragraph2 of the figure."
+msgstr "MY DESCRIPTION PARAGRAPH2 OF THE FIGURE."
diff --git a/tests/root/i18n/figure_caption.txt b/tests/root/i18n/figure_caption.txt
new file mode 100644
index 000000000..75567b3a1
--- /dev/null
+++ b/tests/root/i18n/figure_caption.txt
@@ -0,0 +1,12 @@
+:tocdepth: 2
+
+i18n with figure caption
+========================
+
+.. figure:: i18n.png
+
+   My caption of the figure
+
+   My description paragraph1 of the figure.
+
+   My description paragraph2 of the figure.
diff --git a/tests/root/i18n/i18n.png b/tests/root/i18n/i18n.png
new file mode 100644
index 0000000000000000000000000000000000000000..72c12d13fec6b51b68a490e869011bae7f1b356c
GIT binary patch
literal 67861
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
aGyPvV0UwG0uR>)20000<MNUMnLSTXy!v;qH

literal 0
HcmV?d00001

diff --git a/tests/root/i18n/index.txt b/tests/root/i18n/index.txt
index f8c9d4066..dfab377a1 100644
--- a/tests/root/i18n/index.txt
+++ b/tests/root/i18n/index.txt
@@ -7,3 +7,4 @@
    refs_inconsistency
    literalblock
    definition_terms
+   figure_caption
diff --git a/tests/test_intl.py b/tests/test_intl.py
index decffa91b..e93caa21a 100644
--- a/tests/test_intl.py
+++ b/tests/test_intl.py
@@ -243,3 +243,19 @@ def test_i18n_definition_terms(app):
               u"\n   THE CORRESPONDING DEFINITION #2\n")
 
     assert result == expect
+
+
+@with_app(buildername='text',
+          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
+                         'gettext_compact': False})
+def test_i18n_figure_caption(app):
+    # regression test for #940
+    app.builder.build(['i18n/figure_caption'])
+    result = (app.outdir / 'i18n' / 'figure_caption.txt').text(encoding='utf-8')
+    expect = (u"\nI18N WITH FIGURE CAPTION"
+              u"\n************************\n"
+              u"\n   [image]MY CAPTION OF THE FIGURE\n"
+              u"\n   MY DESCRIPTION PARAGRAPH1 OF THE FIGURE.\n"
+              u"\n   MY DESCRIPTION PARAGRAPH2 OF THE FIGURE.\n")
+
+    assert result == expect

From ae9afab1fcd3fc0ba2b6f049f87df261f168d2f2 Mon Sep 17 00:00:00 2001
From: Roland Meister <Roland Meister@localhost>
Date: Fri, 4 Jan 2013 22:05:50 +0100
Subject: [PATCH 19/29] remove trailing whitespace in sphinx/environment.py

---
 sphinx/environment.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/environment.py b/sphinx/environment.py
index 5caa09eb8..4f9c30c6c 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -1373,7 +1373,7 @@ class BuildEnvironment:
                             'iscurrent' not in subnode.parent):
                             subnode.parent.remove(subnode)
                         else:
-                            # recurse on visible children  
+                            # recurse on visible children
                             _toctree_prune(subnode, depth+1, maxdepth)
 
         def _toctree_add_classes(node, depth):

From 4370896aea063b9abb539d4861c25aee3deb8b9e Mon Sep 17 00:00:00 2001
From: Roland Meister <Roland Meister@localhost>
Date: Fri, 4 Jan 2013 22:13:26 +0100
Subject: [PATCH 20/29] Whitespace cleanup in jinja templates

This change removes odd-looking empty lines before the doctype declaration in
HTML files created by jinja templates.
---
 sphinx/themes/agogo/layout.html          | 2 +-
 sphinx/themes/basic/defindex.html        | 2 +-
 sphinx/themes/basic/domainindex.html     | 2 +-
 sphinx/themes/basic/genindex-single.html | 2 +-
 sphinx/themes/basic/genindex-split.html  | 2 +-
 sphinx/themes/basic/genindex.html        | 2 +-
 sphinx/themes/basic/page.html            | 2 +-
 sphinx/themes/basic/search.html          | 2 +-
 sphinx/themes/default/layout.html        | 2 +-
 sphinx/themes/epub/epub-cover.html       | 2 +-
 sphinx/themes/epub/layout.html           | 2 +-
 sphinx/themes/haiku/layout.html          | 2 +-
 sphinx/themes/pyramid/layout.html        | 2 +-
 sphinx/themes/scrolls/layout.html        | 2 +-
 sphinx/themes/sphinxdoc/layout.html      | 2 +-
 15 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/sphinx/themes/agogo/layout.html b/sphinx/themes/agogo/layout.html
index 7f3a24870..fde19dbc7 100644
--- a/sphinx/themes/agogo/layout.html
+++ b/sphinx/themes/agogo/layout.html
@@ -8,7 +8,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "basic/layout.html" %}
+{%- extends "basic/layout.html" %}
 
 {% block header %}
     <div class="header-wrapper">
diff --git a/sphinx/themes/basic/defindex.html b/sphinx/themes/basic/defindex.html
index 4c57b53df..1ae9630de 100644
--- a/sphinx/themes/basic/defindex.html
+++ b/sphinx/themes/basic/defindex.html
@@ -7,7 +7,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "layout.html" %}
+{%- extends "layout.html" %}
 {% set title = _('Overview') %}
 {% block body %}
   <h1>{{ docstitle|e }}</h1>
diff --git a/sphinx/themes/basic/domainindex.html b/sphinx/themes/basic/domainindex.html
index cbb9cba5d..7f99da618 100644
--- a/sphinx/themes/basic/domainindex.html
+++ b/sphinx/themes/basic/domainindex.html
@@ -7,7 +7,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "layout.html" %}
+{%- extends "layout.html" %}
 {% set title = indextitle %}
 {% block extrahead %}
 {{ super() }}
diff --git a/sphinx/themes/basic/genindex-single.html b/sphinx/themes/basic/genindex-single.html
index 0efdcee99..e79212516 100644
--- a/sphinx/themes/basic/genindex-single.html
+++ b/sphinx/themes/basic/genindex-single.html
@@ -28,7 +28,7 @@
   </dt>
 {% endmacro %}
 
-{% extends "layout.html" %}
+{%- extends "layout.html" %}
 {% set title = _('Index') %}
 {% block body %}
 
diff --git a/sphinx/themes/basic/genindex-split.html b/sphinx/themes/basic/genindex-split.html
index e2fcf04cf..20c180687 100644
--- a/sphinx/themes/basic/genindex-split.html
+++ b/sphinx/themes/basic/genindex-split.html
@@ -7,7 +7,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "layout.html" %}
+{%- extends "layout.html" %}
 {% set title = _('Index') %}
 {% block body %}
 
diff --git a/sphinx/themes/basic/genindex.html b/sphinx/themes/basic/genindex.html
index 3ba162bf6..dd2c96d8e 100644
--- a/sphinx/themes/basic/genindex.html
+++ b/sphinx/themes/basic/genindex.html
@@ -28,7 +28,7 @@
   </dt>
 {% endmacro %}
 
-{% extends "layout.html" %}
+{%- extends "layout.html" %}
 {% set title = _('Index') %}
 {% block body %}
 
diff --git a/sphinx/themes/basic/page.html b/sphinx/themes/basic/page.html
index f7de22b67..185c6c85a 100644
--- a/sphinx/themes/basic/page.html
+++ b/sphinx/themes/basic/page.html
@@ -7,7 +7,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "layout.html" %}
+{%- extends "layout.html" %}
 {% block body %}
   {{ body }}
 {% endblock %}
diff --git a/sphinx/themes/basic/search.html b/sphinx/themes/basic/search.html
index 2d926a41b..011c23929 100644
--- a/sphinx/themes/basic/search.html
+++ b/sphinx/themes/basic/search.html
@@ -7,7 +7,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "layout.html" %}
+{%- extends "layout.html" %}
 {% set title = _('Search') %}
 {% set script_files = script_files + ['_static/searchtools.js'] %}
 {% block extrahead %}
diff --git a/sphinx/themes/default/layout.html b/sphinx/themes/default/layout.html
index 0cc0df10e..d237f5ed9 100644
--- a/sphinx/themes/default/layout.html
+++ b/sphinx/themes/default/layout.html
@@ -7,7 +7,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "basic/layout.html" %}
+{%- extends "basic/layout.html" %}
 
 {% if theme_collapsiblesidebar|tobool %}
 {% set script_files = script_files + ['_static/sidebar.js'] %}
diff --git a/sphinx/themes/epub/epub-cover.html b/sphinx/themes/epub/epub-cover.html
index f0289f602..5872fb7f1 100644
--- a/sphinx/themes/epub/epub-cover.html
+++ b/sphinx/themes/epub/epub-cover.html
@@ -7,7 +7,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "layout.html" %}
+{%- extends "layout.html" %}
 {%- block header %}{% endblock %}
 {%- block rootrellink %}{% endblock %}
 {%- block relbaritems %}{% endblock %}
diff --git a/sphinx/themes/epub/layout.html b/sphinx/themes/epub/layout.html
index 789aa90b3..c2e2e0fd5 100644
--- a/sphinx/themes/epub/layout.html
+++ b/sphinx/themes/epub/layout.html
@@ -7,7 +7,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "basic/layout.html" %}
+{%- extends "basic/layout.html" %}
 
 {# add only basic navigation links #}
 {% block sidebar1 %}{% endblock %}
diff --git a/sphinx/themes/haiku/layout.html b/sphinx/themes/haiku/layout.html
index 9411e4483..edbda50b2 100644
--- a/sphinx/themes/haiku/layout.html
+++ b/sphinx/themes/haiku/layout.html
@@ -7,7 +7,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "basic/layout.html" %}
+{%- extends "basic/layout.html" %}
 {% set script_files = script_files + ['_static/theme_extras.js'] %}
 {% set css_files = css_files + ['_static/print.css'] %}
 
diff --git a/sphinx/themes/pyramid/layout.html b/sphinx/themes/pyramid/layout.html
index 1887361ee..8780ceaef 100644
--- a/sphinx/themes/pyramid/layout.html
+++ b/sphinx/themes/pyramid/layout.html
@@ -1,4 +1,4 @@
-{% extends "basic/layout.html" %}
+{%- extends "basic/layout.html" %}
 
 {%- block extrahead %}
 <link rel="stylesheet" href="http://fonts.googleapis.com/css?family=Neuton&amp;subset=latin" type="text/css" media="screen" charset="utf-8" />
diff --git a/sphinx/themes/scrolls/layout.html b/sphinx/themes/scrolls/layout.html
index 13e46015c..97f7ca1db 100644
--- a/sphinx/themes/scrolls/layout.html
+++ b/sphinx/themes/scrolls/layout.html
@@ -8,7 +8,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "basic/layout.html" %}
+{%- extends "basic/layout.html" %}
 {% set script_files = script_files + ['_static/theme_extras.js'] %}
 {% set css_files = css_files + ['_static/print.css'] %}
 {# do not display relbars #}
diff --git a/sphinx/themes/sphinxdoc/layout.html b/sphinx/themes/sphinxdoc/layout.html
index 05a99f9bf..4ffeb6ed2 100644
--- a/sphinx/themes/sphinxdoc/layout.html
+++ b/sphinx/themes/sphinxdoc/layout.html
@@ -7,7 +7,7 @@
     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{% extends "basic/layout.html" %}
+{%- extends "basic/layout.html" %}
 
 {# put the sidebar before the body #}
 {% block sidebar1 %}{{ sidebar() }}{% endblock %}

From b338af55dfdeb4de729cc8631fdd4fcb6a60e582 Mon Sep 17 00:00:00 2001
From: Jonathan Waltman <jonathan.waltman@gmail.com>
Date: Fri, 4 Jan 2013 22:24:46 -0600
Subject: [PATCH 21/29] Issue #869: Add option ``-T`` for printing the full
 traceback on exception.

---
 CHANGES           |  3 +++
 sphinx/cmdline.py | 22 ++++++++++++----------
 2 files changed, 15 insertions(+), 10 deletions(-)

diff --git a/CHANGES b/CHANGES
index 2addc2a9b..67c8155b4 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,9 @@
 Release 1.2 (in development)
 ============================
 
+* #869: sphinx-build now has the option :option:`-T` for printing the full
+  traceback after an unhandled exception.
+
 * #940: Fix gettext does not extract figure caption.
 
 * #1067: Improve the ordering of the JavaScript search results: matches in titles
diff --git a/sphinx/cmdline.py b/sphinx/cmdline.py
index 20ee536b2..9b8d8ae2e 100644
--- a/sphinx/cmdline.py
+++ b/sphinx/cmdline.py
@@ -59,6 +59,7 @@ new and changed files
          -w <file> -- write warnings (and errors) to given file
          -W        -- turn warnings into errors
          -P        -- run Pdb on exception
+         -T        -- show full traceback on exception
 Modi:
 * without -a and without filenames, write new and changed files.
 * with -a, write all files.
@@ -71,7 +72,7 @@ def main(argv):
         nocolor()
 
     try:
-        opts, args = getopt.getopt(argv[1:], 'ab:t:d:c:CD:A:ng:NEqQWw:P')
+        opts, args = getopt.getopt(argv[1:], 'ab:t:d:c:CD:A:ng:NEqQWw:PT')
         allopts = set(opt[0] for opt in opts)
         srcdir = confdir = abspath(args[0])
         if not path.isdir(srcdir):
@@ -109,6 +110,7 @@ def main(argv):
 
     buildername = None
     force_all = freshenv = warningiserror = use_pdb = False
+    show_traceback = False
     status = sys.stdout
     warning = sys.stderr
     error = sys.stderr
@@ -185,6 +187,8 @@ def main(argv):
             warnfile = val
         elif opt == '-P':
             use_pdb = True
+        elif opt == '-T':
+            show_traceback = True
 
     if warning and warnfile:
         warnfp = open(warnfile, 'w')
@@ -197,14 +201,7 @@ def main(argv):
                      warningiserror, tags)
         app.build(force_all, filenames)
         return app.statuscode
-    except KeyboardInterrupt:
-        if use_pdb:
-            import pdb
-            print >>error, red('Interrupted while building, starting debugger:')
-            traceback.print_exc()
-            pdb.post_mortem(sys.exc_info()[2])
-        return 1
-    except Exception, err:
+    except (Exception, KeyboardInterrupt), err:
         if use_pdb:
             import pdb
             print >>error, red('Exception occurred while building, '
@@ -213,7 +210,12 @@ def main(argv):
             pdb.post_mortem(sys.exc_info()[2])
         else:
             print >>error
-            if isinstance(err, SystemMessage):
+            if show_traceback:
+                traceback.print_exc(None, error)
+                print >>error
+            if isinstance(err, KeyboardInterrupt):
+                print >>error, 'interrupted!'
+            elif isinstance(err, SystemMessage):
                 print >>error, red('reST markup error:')
                 print >>error, terminal_safe(err.args[0])
             elif isinstance(err, SphinxError):

From 66fe7cc2d793c459ebff877eecacccf717609a75 Mon Sep 17 00:00:00 2001
From: Jonathan Waltman <jonathan.waltman@gmail.com>
Date: Fri, 4 Jan 2013 22:48:21 -0600
Subject: [PATCH 22/29] sphinx-build: Support the standard ``--help`` and
 ``--version`` options.

---
 CHANGES           |  3 +++
 sphinx/cmdline.py | 11 ++++++++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 67c8155b4..5f5ab76d9 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,9 @@
 Release 1.2 (in development)
 ============================
 
+* sphinx-build now supports the standard :option:`--help` and
+  :option:`--version` options.
+
 * #869: sphinx-build now has the option :option:`-T` for printing the full
   traceback after an unhandled exception.
 
diff --git a/sphinx/cmdline.py b/sphinx/cmdline.py
index 9b8d8ae2e..026bcd45c 100644
--- a/sphinx/cmdline.py
+++ b/sphinx/cmdline.py
@@ -60,6 +60,8 @@ new and changed files
          -W        -- turn warnings into errors
          -P        -- run Pdb on exception
          -T        -- show full traceback on exception
+        --help     -- show this help and exit
+        --version  -- show version information and exit
 Modi:
 * without -a and without filenames, write new and changed files.
 * with -a, write all files.
@@ -72,8 +74,15 @@ def main(argv):
         nocolor()
 
     try:
-        opts, args = getopt.getopt(argv[1:], 'ab:t:d:c:CD:A:ng:NEqQWw:PT')
+        opts, args = getopt.getopt(argv[1:], 'ab:t:d:c:CD:A:ng:NEqQWw:PTh',
+                                   ['help', 'version'])
         allopts = set(opt[0] for opt in opts)
+        if '-h' in allopts or '--help' in allopts:
+            usage(argv)
+            return 0
+        if '--version' in allopts:
+            print 'Sphinx (sphinx-build) %s' %  __version__
+            return 0
         srcdir = confdir = abspath(args[0])
         if not path.isdir(srcdir):
             print >>sys.stderr, 'Error: Cannot find source directory `%s\'.' % (

From 3cd00a0809fc1fc855b20c06e673eaaff3d659d7 Mon Sep 17 00:00:00 2001
From: Jonathan Waltman <jonathan.waltman@gmail.com>
Date: Fri, 4 Jan 2013 22:52:42 -0600
Subject: [PATCH 23/29] sphinx-build: Provide more specific error messages for
 invalid arguments.

---
 CHANGES           |  3 +++
 sphinx/cmdline.py | 11 +++++++----
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/CHANGES b/CHANGES
index 5f5ab76d9..cd07d18b9 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,9 @@
 Release 1.2 (in development)
 ============================
 
+* sphinx-build now provides more specific error messages when called with
+  invalid options or arguments.
+
 * sphinx-build now supports the standard :option:`--help` and
   :option:`--version` options.
 
diff --git a/sphinx/cmdline.py b/sphinx/cmdline.py
index 026bcd45c..ceb067e16 100644
--- a/sphinx/cmdline.py
+++ b/sphinx/cmdline.py
@@ -97,15 +97,18 @@ def main(argv):
         if not path.isdir(outdir):
             print >>sys.stderr, 'Making output directory...'
             os.makedirs(outdir)
-    except (IndexError, getopt.error):
-        usage(argv)
+    except getopt.error, err:
+        usage(argv, 'Error: %s' % err)
+        return 1
+    except IndexError:
+        usage(argv, 'Error: Insufficient arguments.')
         return 1
 
     filenames = args[2:]
     err = 0
     for filename in filenames:
         if not path.isfile(filename):
-            print >>sys.stderr, 'Cannot find file %r.' % filename
+            print >>sys.stderr, 'Error: Cannot find file %r.' % filename
             err = 1
     if err:
         return 1
@@ -132,7 +135,7 @@ def main(argv):
             buildername = val
         elif opt == '-a':
             if filenames:
-                usage(argv, 'Cannot combine -a option and filenames.')
+                usage(argv, 'Error: Cannot combine -a option and filenames.')
                 return 1
             force_all = True
         elif opt == '-t':

From 51fb8b435b59fdfe373b2d38be7827c4ff5f45de Mon Sep 17 00:00:00 2001
From: Jonathan Waltman <jonathan.waltman@gmail.com>
Date: Sat, 5 Jan 2013 02:41:12 -0600
Subject: [PATCH 24/29] Add verbose option ``-v`` for sphinx-build and some
 rudimentary debugging support.

---
 CHANGES                     |  6 +++
 sphinx/application.py       | 74 ++++++++++++++++++++++++++++++-------
 sphinx/builders/__init__.py | 10 +++--
 sphinx/cmdline.py           |  9 ++++-
 sphinx/environment.py       |  1 +
 sphinx/util/__init__.py     |  6 +++
 6 files changed, 87 insertions(+), 19 deletions(-)

diff --git a/CHANGES b/CHANGES
index cd07d18b9..ba0d38480 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,12 @@
 Release 1.2 (in development)
 ============================
 
+* sphinx-build now has a verbose option :option:`-v` which can be
+  repeated for greater effect.  A single occurrance provides a
+  slightly more verbose output than normal.  Two or more occurrences
+  of this option provides more detailed output which may be useful for
+  debugging.
+
 * sphinx-build now provides more specific error messages when called with
   invalid options or arguments.
 
diff --git a/sphinx/application.py b/sphinx/application.py
index 6eefc3e44..7e07f6b91 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -61,7 +61,8 @@ class Sphinx(object):
 
     def __init__(self, srcdir, confdir, outdir, doctreedir, buildername,
                  confoverrides=None, status=sys.stdout, warning=sys.stderr,
-                 freshenv=False, warningiserror=False, tags=None):
+                 freshenv=False, warningiserror=False, tags=None, verbosity=0):
+        self.verbosity = verbosity
         self.next_listener_id = 0
         self._extensions = {}
         self._listeners = {}
@@ -214,6 +215,17 @@ class Sphinx(object):
             self.emit('build-finished', None)
         self.builder.cleanup()
 
+    def _log(self, message, wfile, nonl=False):
+        try:
+            wfile.write(message)
+        except UnicodeEncodeError:
+            encoding = getattr(wfile, 'encoding', 'ascii') or 'ascii'
+            wfile.write(message.encode(encoding, 'replace'))
+        if not nonl:
+            wfile.write('\n')
+        if hasattr(wfile, 'flush'):
+            wfile.flush()
+
     def warn(self, message, location=None, prefix='WARNING: '):
         if isinstance(location, tuple):
             docname, lineno = location
@@ -226,26 +238,30 @@ class Sphinx(object):
         if self.warningiserror:
             raise SphinxWarning(warntext)
         self._warncount += 1
-        try:
-            self._warning.write(warntext)
-        except UnicodeEncodeError:
-            encoding = getattr(self._warning, 'encoding', 'ascii') or 'ascii'
-            self._warning.write(warntext.encode(encoding, 'replace'))
+        self._log(warntext, self._warning, True)
 
     def info(self, message='', nonl=False):
-        try:
-            self._status.write(message)
-        except UnicodeEncodeError:
-            encoding = getattr(self._status, 'encoding', 'ascii') or 'ascii'
-            self._status.write(message.encode(encoding, 'replace'))
-        if not nonl:
-            self._status.write('\n')
-        self._status.flush()
+        self._log(message, self._status, nonl)
+
+    def verbose(self, message, *args, **kwargs):
+        if self.verbosity < 1:
+            return
+        if args or kwargs:
+            message = message % (args or kwargs)
+        self._log(message, self._warning)
+
+    def debug(self, message, *args, **kwargs):
+        if self.verbosity < 2:
+            return
+        if args or kwargs:
+            message = message % (args or kwargs)
+        self._log(message, self._warning)
 
     # general extensibility interface
 
     def setup_extension(self, extension):
         """Import and setup a Sphinx extension module. No-op if called twice."""
+        self.debug('setting up extension: %r', extension)
         if extension in self._extensions:
             return
         try:
@@ -306,9 +322,12 @@ class Sphinx(object):
         else:
             self._listeners[event][listener_id] = callback
         self.next_listener_id += 1
+        self.debug('connecting event %r: %r [id=%s]',
+                   event, callback, listener_id)
         return listener_id
 
     def disconnect(self, listener_id):
+        self.debug('disconnecting event: [id=%s]', listener_id)
         for event in self._listeners.itervalues():
             event.pop(listener_id, None)
 
@@ -328,6 +347,7 @@ class Sphinx(object):
     # registering addon parts
 
     def add_builder(self, builder):
+        self.debug('adding builder: %r', builder)
         if not hasattr(builder, 'name'):
             raise ExtensionError('Builder class %s has no "name" attribute'
                                  % builder)
@@ -342,6 +362,7 @@ class Sphinx(object):
         self.builderclasses[builder.name] = builder
 
     def add_config_value(self, name, default, rebuild):
+        self.debug('adding config value: %r', (name, default, rebuild))
         if name in self.config.values:
             raise ExtensionError('Config value %r already present' % name)
         if rebuild in (False, True):
@@ -349,11 +370,13 @@ class Sphinx(object):
         self.config.values[name] = (default, rebuild)
 
     def add_event(self, name):
+        self.debug('adding event: %r', name)
         if name in self._events:
             raise ExtensionError('Event %r already present' % name)
         self._events[name] = ''
 
     def add_node(self, node, **kwds):
+        self.debug('adding node: %r', (node, kwds))
         nodes._add_node_class_names([node.__name__])
         for key, val in kwds.iteritems():
             try:
@@ -393,24 +416,30 @@ class Sphinx(object):
             return obj
 
     def add_directive(self, name, obj, content=None, arguments=None, **options):
+        self.debug('adding directive: %r',
+                   (name, obj, content, arguments, options))
         directives.register_directive(
             name, self._directive_helper(obj, content, arguments, **options))
 
     def add_role(self, name, role):
+        self.debug('adding role: %r', (name, role))
         roles.register_local_role(name, role)
 
     def add_generic_role(self, name, nodeclass):
         # don't use roles.register_generic_role because it uses
         # register_canonical_role
+        self.debug('adding generic role: %r', (name, nodeclass))
         role = roles.GenericRole(name, nodeclass)
         roles.register_local_role(name, role)
 
     def add_domain(self, domain):
+        self.debug('adding domain: %r', domain)
         if domain.name in self.domains:
             raise ExtensionError('domain %s already registered' % domain.name)
         self.domains[domain.name] = domain
 
     def override_domain(self, domain):
+        self.debug('overriding domain: %r', domain)
         if domain.name not in self.domains:
             raise ExtensionError('domain %s not yet registered' % domain.name)
         if not issubclass(domain, self.domains[domain.name]):
@@ -420,17 +449,21 @@ class Sphinx(object):
 
     def add_directive_to_domain(self, domain, name, obj,
                                 content=None, arguments=None, **options):
+        self.debug('adding directive to domain: %r',
+                   (domain, name, obj, content, arguments, options))
         if domain not in self.domains:
             raise ExtensionError('domain %s not yet registered' % domain)
         self.domains[domain].directives[name] = \
             self._directive_helper(obj, content, arguments, **options)
 
     def add_role_to_domain(self, domain, name, role):
+        self.debug('adding role to domain: %r', (domain, name, role))
         if domain not in self.domains:
             raise ExtensionError('domain %s not yet registered' % domain)
         self.domains[domain].roles[name] = role
 
     def add_index_to_domain(self, domain, index):
+        self.debug('adding index to domain: %r', (domain, index))
         if domain not in self.domains:
             raise ExtensionError('domain %s not yet registered' % domain)
         self.domains[domain].indices.append(index)
@@ -438,6 +471,9 @@ class Sphinx(object):
     def add_object_type(self, directivename, rolename, indextemplate='',
                         parse_node=None, ref_nodeclass=None, objname='',
                         doc_field_types=[]):
+        self.debug('adding object type: %r',
+                   (directivename, rolename, indextemplate, parse_node,
+                    ref_nodeclass, objname, doc_field_types))
         StandardDomain.object_types[directivename] = \
             ObjType(objname or directivename, rolename)
         # create a subclass of GenericObject as the new directive
@@ -454,6 +490,9 @@ class Sphinx(object):
 
     def add_crossref_type(self, directivename, rolename, indextemplate='',
                           ref_nodeclass=None, objname=''):
+        self.debug('adding crossref type: %r',
+                   (directivename, rolename, indextemplate, ref_nodeclass,
+                    objname))
         StandardDomain.object_types[directivename] = \
             ObjType(objname or directivename, rolename)
         # create a subclass of Target as the new directive
@@ -464,9 +503,11 @@ class Sphinx(object):
         StandardDomain.roles[rolename] = XRefRole(innernodeclass=ref_nodeclass)
 
     def add_transform(self, transform):
+        self.debug('adding transform: %r', transform)
         SphinxStandaloneReader.transforms.append(transform)
 
     def add_javascript(self, filename):
+        self.debug('adding javascript: %r', filename)
         from sphinx.builders.html import StandaloneHTMLBuilder
         if '://' in filename:
             StandaloneHTMLBuilder.script_files.append(filename)
@@ -475,6 +516,7 @@ class Sphinx(object):
                 posixpath.join('_static', filename))
 
     def add_stylesheet(self, filename):
+        self.debug('adding stylesheet: %r', filename)
         from sphinx.builders.html import StandaloneHTMLBuilder
         if '://' in filename:
             StandaloneHTMLBuilder.css_files.append(filename)
@@ -483,21 +525,25 @@ class Sphinx(object):
                 posixpath.join('_static', filename))
 
     def add_lexer(self, alias, lexer):
+        self.debug('adding lexer: %r', (alias, lexer))
         from sphinx.highlighting import lexers
         if lexers is None:
             return
         lexers[alias] = lexer
 
     def add_autodocumenter(self, cls):
+        self.debug('adding autodocumenter: %r', cls)
         from sphinx.ext import autodoc
         autodoc.add_documenter(cls)
         self.add_directive('auto' + cls.objtype, autodoc.AutoDirective)
 
     def add_autodoc_attrgetter(self, type, getter):
+        self.debug('adding autodoc attrgetter: %r', (type, getter))
         from sphinx.ext import autodoc
         autodoc.AutoDirective._special_attrgetters[type] = getter
 
     def add_search_language(self, cls):
+        self.debug('adding search language: %r', cls)
         from sphinx.search import languages, SearchLanguage
         assert isinstance(cls, SearchLanguage)
         languages[cls.lang] = cls
diff --git a/sphinx/builders/__init__.py b/sphinx/builders/__init__.py
index 9a869aa97..97932c4c7 100644
--- a/sphinx/builders/__init__.py
+++ b/sphinx/builders/__init__.py
@@ -119,9 +119,13 @@ class Builder(object):
         summary = bold(summary)
         for item in iterable:
             l += 1
-            self.info(term_width_line('%s[%3d%%] %s' %
-                                      (summary, 100*l/length,
-                                       colorfunc(item))), nonl=1)
+            s = '%s[%3d%%] %s' % (summary, 100*l/length,
+                                  colorfunc(item))
+            if self.app.verbosity:
+                s += '\n'
+            else:
+                s = term_width_line(s)
+            self.info(s, nonl=1)
             yield item
         if l > 0:
             self.info()
diff --git a/sphinx/cmdline.py b/sphinx/cmdline.py
index ceb067e16..0a1cab7dd 100644
--- a/sphinx/cmdline.py
+++ b/sphinx/cmdline.py
@@ -60,6 +60,7 @@ new and changed files
          -W        -- turn warnings into errors
          -P        -- run Pdb on exception
          -T        -- show full traceback on exception
+         -v        -- increase verbosity (can be repeated)
         --help     -- show this help and exit
         --version  -- show version information and exit
 Modi:
@@ -74,7 +75,7 @@ def main(argv):
         nocolor()
 
     try:
-        opts, args = getopt.getopt(argv[1:], 'ab:t:d:c:CD:A:ng:NEqQWw:PTh',
+        opts, args = getopt.getopt(argv[1:], 'ab:t:d:c:CD:A:ng:NEqQWw:PThv',
                                    ['help', 'version'])
         allopts = set(opt[0] for opt in opts)
         if '-h' in allopts or '--help' in allopts:
@@ -123,6 +124,7 @@ def main(argv):
     buildername = None
     force_all = freshenv = warningiserror = use_pdb = False
     show_traceback = False
+    verbosity = 0
     status = sys.stdout
     warning = sys.stderr
     error = sys.stderr
@@ -201,6 +203,9 @@ def main(argv):
             use_pdb = True
         elif opt == '-T':
             show_traceback = True
+        elif opt == '-v':
+            verbosity += 1
+            show_traceback = True
 
     if warning and warnfile:
         warnfp = open(warnfile, 'w')
@@ -210,7 +215,7 @@ def main(argv):
     try:
         app = Sphinx(srcdir, confdir, outdir, doctreedir, buildername,
                      confoverrides, status, warning, freshenv,
-                     warningiserror, tags)
+                     warningiserror, tags, verbosity)
         app.build(force_all, filenames)
         return app.statuscode
     except (Exception, KeyboardInterrupt), err:
diff --git a/sphinx/environment.py b/sphinx/environment.py
index 5caa09eb8..1b9042691 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -951,6 +951,7 @@ class BuildEnvironment:
         filterlevel = self.config.keep_warnings and 2 or 5
         for node in doctree.traverse(nodes.system_message):
             if node['level'] < filterlevel:
+                self.app.debug('%s [filtered system message]', node.astext())
                 node.parent.remove(node)
 
 
diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index b69b10a94..de4b14a4d 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -291,6 +291,12 @@ class Tee(object):
         self.stream1.write(text)
         self.stream2.write(text)
 
+    def flush(self):
+        if hasattr(self.stream1, 'flush'):
+            self.stream1.flush()
+        if hasattr(self.stream2, 'flush'):
+            self.stream2.flush()
+
 
 def parselinenos(spec, total):
     """Parse a line number spec (such as "1,2,4-6") and return a list of

From 42c90ee178e5cbc266d7b0406735f0cae6f2d860 Mon Sep 17 00:00:00 2001
From: Jonathan Waltman <jonathan.waltman@gmail.com>
Date: Sat, 5 Jan 2013 08:28:54 -0600
Subject: [PATCH 25/29] Add basic debugging support for autodoc.

---
 sphinx/ext/autodoc.py | 30 ++++++++++++++++++++++++------
 tests/test_autodoc.py |  4 ++--
 2 files changed, 26 insertions(+), 8 deletions(-)

diff --git a/sphinx/ext/autodoc.py b/sphinx/ext/autodoc.py
index d17800b0b..300c4f22c 100644
--- a/sphinx/ext/autodoc.py
+++ b/sphinx/ext/autodoc.py
@@ -317,13 +317,20 @@ class Documenter(object):
 
         Returns True if successful, False if an error occurred.
         """
+        if self.objpath:
+            self.env.app.debug('autodoc: from %s import %s',
+                               self.modname, '.'.join(self.objpath))
         try:
+            self.env.app.debug('autodoc: import %s', self.modname)
             __import__(self.modname)
             parent = None
             obj = self.module = sys.modules[self.modname]
+            self.env.app.debug('autodoc: => %r', obj)
             for part in self.objpath:
                 parent = obj
+                self.env.app.debug('autodoc: getattr(_, %r)', part)
                 obj = self.get_attr(obj, part)
+                self.env.app.debug('autodoc: => %r', obj)
                 self.object_name = part
             self.parent = parent
             self.object = obj
@@ -331,12 +338,16 @@ class Documenter(object):
         # this used to only catch SyntaxError, ImportError and AttributeError,
         # but importing modules with side effects can raise all kinds of errors
         except Exception, err:
-            if self.env.app and not self.env.app.quiet:
-                self.env.app.info(traceback.format_exc().rstrip())
-            self.directive.warn(
-                'autodoc can\'t import/find %s %r, it reported error: '
-                '"%s", please check your spelling and sys.path' %
-                (self.objtype, str(self.fullname), err))
+            if self.objpath:
+                errmsg = 'autodoc: failed to import %s %r from module %r' % \
+                         (self.objtype, '.'.join(self.objpath), self.modname)
+            else:
+                errmsg = 'autodoc: failed to import %s %r' % \
+                         (self.objtype, self.fullname)
+            errmsg += '; the following exception was raised:\n%s' % \
+                      traceback.format_exc()
+            self.env.app.debug(errmsg)
+            self.directive.warn(errmsg)
             self.env.note_reread()
             return False
 
@@ -1294,6 +1305,10 @@ class AutoDirective(Directive):
         self.warnings = []
         self.result = ViewList()
 
+        source, lineno = self.reporter.get_source_and_line(self.lineno)
+        self.env.app.debug('%s:%s: <input>\n%s',
+                           source, lineno, self.block_text)
+
         # find out what documenter to call
         objtype = self.name[4:]
         doc_class = self._registry[objtype]
@@ -1314,6 +1329,9 @@ class AutoDirective(Directive):
         if not self.result:
             return self.warnings
 
+        if self.env.app.verbosity >= 2:
+            self.env.app.debug('autodoc: <output>\n%s', '\n'.join(self.result))
+
         # record all filenames as dependencies -- this will at least
         # partially make automatic invalidation possible
         for fn in self.filename_set:
diff --git a/tests/test_autodoc.py b/tests/test_autodoc.py
index 21a3aed6e..a93bd7186 100644
--- a/tests/test_autodoc.py
+++ b/tests/test_autodoc.py
@@ -386,10 +386,10 @@ def test_generate():
     assert_warns("import for autodocumenting 'foobar'",
                  'function', 'foobar', more_content=None)
     # importing
-    assert_warns("import/find module 'test_foobar'",
+    assert_warns("failed to import module 'test_foobar'",
                  'module', 'test_foobar', more_content=None)
     # attributes missing
-    assert_warns("import/find function 'util.foobar'",
+    assert_warns("failed to import function 'foobar' from module 'util'",
                  'function', 'util.foobar', more_content=None)
 
     # test auto and given content mixing

From b17c588b0d9c61ba71d299c91c1ac06684f9ebb0 Mon Sep 17 00:00:00 2001
From: Takayuki Shimizukawa <shimizukawa@gmail.com>
Date: Sat, 5 Jan 2013 23:38:21 +0900
Subject: [PATCH 26/29] Closes #976: Fix gettext does not extract index
 entries.

---
 CHANGES                           |  2 +
 sphinx/builders/gettext.py        | 14 +++++-
 sphinx/directives/other.py        |  1 +
 sphinx/environment.py             | 21 ++++++++-
 sphinx/roles.py                   |  1 +
 sphinx/util/__init__.py           | 23 +++++++++
 sphinx/util/nodes.py              | 13 ++++++
 tests/root/i18n/index.txt         |  1 +
 tests/root/i18n/index_entries.po  | 77 +++++++++++++++++++++++++++++++
 tests/root/i18n/index_entries.txt | 31 +++++++++++++
 tests/test_build_gettext.py       | 47 +++++++++++++++++++
 tests/test_intl.py                | 34 ++++++++++++++
 12 files changed, 262 insertions(+), 3 deletions(-)
 create mode 100644 tests/root/i18n/index_entries.po
 create mode 100644 tests/root/i18n/index_entries.txt

diff --git a/CHANGES b/CHANGES
index ba0d38480..4386b5f1f 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,8 @@ Release 1.2 (in development)
 * #869: sphinx-build now has the option :option:`-T` for printing the full
   traceback after an unhandled exception.
 
+* #976: Fix gettext does not extract index entries.
+
 * #940: Fix gettext does not extract figure caption.
 
 * #1067: Improve the ordering of the JavaScript search results: matches in titles
diff --git a/sphinx/builders/gettext.py b/sphinx/builders/gettext.py
index c07f3fc9d..80a242996 100644
--- a/sphinx/builders/gettext.py
+++ b/sphinx/builders/gettext.py
@@ -15,9 +15,11 @@ from datetime import datetime
 from collections import defaultdict
 
 from sphinx.builders import Builder
-from sphinx.util.nodes import extract_messages
+from sphinx.util import split_index_msg
+from sphinx.util.nodes import extract_messages, traverse_translatable_index
 from sphinx.util.osutil import SEP, safe_relpath, ensuredir, find_catalog
 from sphinx.util.console import darkgreen
+from sphinx.locale import pairindextypes
 
 POHEADER = ur"""
 # SOME DESCRIPTIVE TITLE.
@@ -82,6 +84,16 @@ class I18nBuilder(Builder):
         for node, msg in extract_messages(doctree):
             catalog.add(msg, node)
 
+        # Extract translatable messages from index entries.
+        for node, entries in traverse_translatable_index(doctree):
+            for typ, msg, tid, main in entries:
+                for m in split_index_msg(typ, msg):
+                    if typ == 'pair' and m in pairindextypes.values():
+                        # avoid built-in translated message was incorporated
+                        # in 'sphinx.util.nodes.process_index_entry'
+                        continue
+                    catalog.add(m, node)
+
 
 class MessageCatalogBuilder(I18nBuilder):
     """
diff --git a/sphinx/directives/other.py b/sphinx/directives/other.py
index d90fb2e1c..c6baf775e 100644
--- a/sphinx/directives/other.py
+++ b/sphinx/directives/other.py
@@ -168,6 +168,7 @@ class Index(Directive):
         indexnode = addnodes.index()
         indexnode['entries'] = ne = []
         indexnode['inline'] = False
+        set_source_info(self, indexnode)
         for entry in arguments:
             ne.extend(process_index_entry(entry, targetid))
         return [indexnode, targetnode]
diff --git a/sphinx/environment.py b/sphinx/environment.py
index 1b9042691..4d9103222 100644
--- a/sphinx/environment.py
+++ b/sphinx/environment.py
@@ -38,9 +38,9 @@ from docutils.transforms.parts import ContentsFilter
 
 from sphinx import addnodes
 from sphinx.util import url_re, get_matching_docs, docname_join, split_into, \
-     FilenameUniqDict
+     split_index_msg, FilenameUniqDict
 from sphinx.util.nodes import clean_astext, make_refnode, extract_messages, \
-     WarningStream
+     traverse_translatable_index, WarningStream
 from sphinx.util.osutil import movefile, SEP, ustrftime, find_catalog, \
      fs_encoding
 from sphinx.util.matching import compile_matchers
@@ -303,6 +303,23 @@ class Locale(Transform):
                 child.parent = node
             node.children = patch.children
 
+        # Extract and translate messages for index entries.
+        for node, entries in traverse_translatable_index(self.document):
+            new_entries = []
+            for type, msg, tid, main in entries:
+                msg_parts = split_index_msg(type, msg)
+                msgstr_parts = []
+                for part in msg_parts:
+                    msgstr = catalog.gettext(part)
+                    if not msgstr:
+                        msgstr = part
+                    msgstr_parts.append(msgstr)
+
+                new_entries.append((type, ';'.join(msgstr_parts), tid, main))
+
+            node['raw_entries'] = entries
+            node['entries'] = new_entries
+
 
 class SphinxStandaloneReader(standalone.Reader):
     """
diff --git a/sphinx/roles.py b/sphinx/roles.py
index d395c372f..02c5ad8fc 100644
--- a/sphinx/roles.py
+++ b/sphinx/roles.py
@@ -293,6 +293,7 @@ def index_role(typ, rawtext, text, lineno, inliner, options={}, content=[]):
         entries = [('single', target, targetid, main)]
     indexnode = addnodes.index()
     indexnode['entries'] = entries
+    set_role_source_info(inliner, lineno, indexnode)
     textnode = nodes.Text(title, title)
     return [indexnode, targetnode, textnode], []
 
diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index de4b14a4d..8bedda126 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -360,6 +360,29 @@ def split_into(n, type, value):
     return parts
 
 
+def split_index_msg(type, value):
+    # new entry types must be listed in directives/other.py!
+    result = []
+    try:
+        if type == 'single':
+            try:
+                result = split_into(2, 'single', value)
+            except ValueError:
+                result = split_into(1, 'single', value)
+        elif type == 'pair':
+            result = split_into(2, 'pair', value)
+        elif type == 'triple':
+            result = split_into(3, 'triple', value)
+        elif type == 'see':
+            result = split_into(2, 'see', value)
+        elif type == 'seealso':
+            result = split_into(2, 'see', value)
+    except ValueError:
+        pass
+
+    return result
+
+
 def format_exception_cut_frames(x=1):
     """Format an exception with traceback, but only the last x frames."""
     typ, val, tb = sys.exc_info()
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index da055da0c..65accbf20 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -74,6 +74,19 @@ def extract_messages(doctree):
             yield node, msg
 
 
+def traverse_translatable_index(doctree):
+    """Traverse translatable index node from a document tree."""
+    def is_block_index(node):
+        return isinstance(node, addnodes.index) and  \
+            node.get('inline') == False
+    for node in doctree.traverse(is_block_index):
+        if 'raw_entries' in node:
+            entries = node['raw_entries']
+        else:
+            entries = node['entries']
+        yield node, entries
+
+
 def nested_parse_with_titles(state, content, node):
     """Version of state.nested_parse() that allows titles and does not require
     titles to have the same decoration as the calling document.
diff --git a/tests/root/i18n/index.txt b/tests/root/i18n/index.txt
index dfab377a1..dfacc0193 100644
--- a/tests/root/i18n/index.txt
+++ b/tests/root/i18n/index.txt
@@ -8,3 +8,4 @@
    literalblock
    definition_terms
    figure_caption
+   index_entries
diff --git a/tests/root/i18n/index_entries.po b/tests/root/i18n/index_entries.po
new file mode 100644
index 000000000..6da9a813d
--- /dev/null
+++ b/tests/root/i18n/index_entries.po
@@ -0,0 +1,77 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2013, foo
+# This file is distributed under the same license as the foo package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: foo foo\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2013-01-05 18:10\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+msgid "i18n with index entries"
+msgstr ""
+
+msgid "index target section"
+msgstr ""
+
+msgid "this is :index:`Newsletter` target paragraph."
+msgstr "THIS IS :index:`NEWSLETTER` TARGET PARAGRAPH."
+
+msgid "various index entries"
+msgstr ""
+
+msgid "That's all."
+msgstr ""
+
+msgid "Mailing List"
+msgstr "MAILING LIST"
+
+msgid "Newsletter"
+msgstr "NEWSLETTER"
+
+msgid "Recipients List"
+msgstr "RECIPIENTS LIST"
+
+msgid "First"
+msgstr "FIRST"
+
+msgid "Second"
+msgstr "SECOND"
+
+msgid "Third"
+msgstr "THIRD"
+
+msgid "Entry"
+msgstr "ENTRY"
+
+msgid "See"
+msgstr "SEE"
+
+msgid "Module"
+msgstr "MODULE"
+
+msgid "Keyword"
+msgstr "KEYWORD"
+
+msgid "Operator"
+msgstr "OPERATOR"
+
+msgid "Object"
+msgstr "OBJECT"
+
+msgid "Exception"
+msgstr "EXCEPTION"
+
+msgid "Statement"
+msgstr "STATEMENT"
+
+msgid "Builtin"
+msgstr "BUILTIN"
diff --git a/tests/root/i18n/index_entries.txt b/tests/root/i18n/index_entries.txt
new file mode 100644
index 000000000..c914a4b43
--- /dev/null
+++ b/tests/root/i18n/index_entries.txt
@@ -0,0 +1,31 @@
+:tocdepth: 2
+
+i18n with index entries
+=======================
+
+.. index::
+   single: Mailing List
+   pair: Newsletter; Recipients List
+
+index target section
+--------------------
+
+this is :index:`Newsletter` target paragraph.
+
+
+various index entries
+---------------------
+
+.. index::
+   triple: First; Second; Third
+   see: Entry; Mailing List
+   seealso: See; Newsletter
+   module: Module
+   keyword: Keyword
+   operator: Operator
+   object: Object
+   exception: Exception
+   statement: Statement
+   builtin: Builtin
+
+That's all.
diff --git a/tests/test_build_gettext.py b/tests/test_build_gettext.py
index ab68289e3..dcbff4849 100644
--- a/tests/test_build_gettext.py
+++ b/tests/test_build_gettext.py
@@ -11,6 +11,7 @@
 
 import gettext
 import os
+import re
 from subprocess import Popen, PIPE
 
 from util import *
@@ -79,3 +80,49 @@ def test_gettext(app):
 
     _ = gettext.translation('test_root', app.outdir, languages=['en']).gettext
     assert _("Testing various markup") == u"Testing various markup"
+
+
+@with_app(buildername='gettext',
+          confoverrides={'gettext_compact': False})
+def test_gettext_index_entries(app):
+    # regression test for #976
+    app.builder.build(['i18n/index_entries'])
+
+    _msgid_getter = re.compile(r'msgid "(.*)"').search
+    def msgid_getter(msgid):
+        m = _msgid_getter(msgid)
+        if m:
+            return m.groups()[0]
+        return None
+
+    pot = (app.outdir / 'i18n' / 'index_entries.pot').text(encoding='utf-8')
+    msgids = filter(None, map(msgid_getter, pot.splitlines()))
+
+    expected_msgids = [
+        "i18n with index entries",
+        "index target section",
+        "this is :index:`Newsletter` target paragraph.",
+        "various index entries",
+        "That's all.",
+        "Mailing List",
+        "Newsletter",
+        "Recipients List",
+        "First",
+        "Second",
+        "Third",
+        "Entry",
+        "See",
+        "Module",
+        "Keyword",
+        "Operator",
+        "Object",
+        "Exception",
+        "Statement",
+        "Builtin",
+    ]
+    for expect in expected_msgids:
+        assert expect in msgids
+        msgids.remove(expect)
+
+    # unexpected msgid existent
+    assert msgids == []
diff --git a/tests/test_intl.py b/tests/test_intl.py
index e93caa21a..932142999 100644
--- a/tests/test_intl.py
+++ b/tests/test_intl.py
@@ -259,3 +259,37 @@ def test_i18n_figure_caption(app):
               u"\n   MY DESCRIPTION PARAGRAPH2 OF THE FIGURE.\n")
 
     assert result == expect
+
+
+@with_app(buildername='html',
+          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
+                         'gettext_compact': False})
+def test_i18n_index_entries(app):
+    # regression test for #976
+    app.builder.build(['i18n/index_entries'])
+    result = (app.outdir / 'genindex.html').text(encoding='utf-8')
+
+    def wrap(tag, keyword):
+        start_tag = "<%s[^>]*>" % tag
+        end_tag = "</%s>" % tag
+        return r"%s\s*%s\s*%s" % (start_tag, keyword, end_tag)
+
+    expected_exprs = [
+        wrap('a', 'NEWSLETTER'),
+        wrap('a', 'MAILING LIST'),
+        wrap('a', 'RECIPIENTS LIST'),
+        wrap('a', 'FIRST SECOND'),
+        wrap('a', 'SECOND THIRD'),
+        wrap('a', 'THIRD, FIRST'),
+        wrap('dt', 'ENTRY'),
+        wrap('dt', 'SEE'),
+        wrap('a', 'MODULE'),
+        wrap('a', 'KEYWORD'),
+        wrap('a', 'OPERATOR'),
+        wrap('a', 'OBJECT'),
+        wrap('a', 'EXCEPTION'),
+        wrap('a', 'STATEMENT'),
+        wrap('a', 'BUILTIN'),
+    ]
+    for expr in expected_exprs:
+        assert re.search(expr, result, re.M)

From 268b0090171642f86a287ff8cc190945e5617b35 Mon Sep 17 00:00:00 2001
From: Jonathan Waltman <jonathan.waltman@gmail.com>
Date: Sat, 5 Jan 2013 20:14:48 -0600
Subject: [PATCH 27/29] Move "only" directive tests to a seperate test root.

---
 tests/root/contents.txt                                     | 1 -
 tests/roots/test-only-directive/conf.py                     | 2 ++
 tests/roots/test-only-directive/contents.rst                | 6 ++++++
 tests/{root/only.txt => roots/test-only-directive/only.rst} | 0
 tests/test_only_directive.py                                | 4 ++--
 tests/util.py                                               | 5 ++++-
 6 files changed, 14 insertions(+), 4 deletions(-)
 create mode 100644 tests/roots/test-only-directive/conf.py
 create mode 100644 tests/roots/test-only-directive/contents.rst
 rename tests/{root/only.txt => roots/test-only-directive/only.rst} (100%)

diff --git a/tests/root/contents.txt b/tests/root/contents.txt
index 67384351b..0fbd68236 100644
--- a/tests/root/contents.txt
+++ b/tests/root/contents.txt
@@ -27,7 +27,6 @@ Contents:
    doctest
    extensions
    versioning/index
-   only
    footnote
    i18n/index
 
diff --git a/tests/roots/test-only-directive/conf.py b/tests/roots/test-only-directive/conf.py
new file mode 100644
index 000000000..bcb4305da
--- /dev/null
+++ b/tests/roots/test-only-directive/conf.py
@@ -0,0 +1,2 @@
+
+project = 'test-only-directive'
diff --git a/tests/roots/test-only-directive/contents.rst b/tests/roots/test-only-directive/contents.rst
new file mode 100644
index 000000000..9a93be9e7
--- /dev/null
+++ b/tests/roots/test-only-directive/contents.rst
@@ -0,0 +1,6 @@
+test-only-directive
+===================
+
+.. toctree::
+
+   only
diff --git a/tests/root/only.txt b/tests/roots/test-only-directive/only.rst
similarity index 100%
rename from tests/root/only.txt
rename to tests/roots/test-only-directive/only.rst
diff --git a/tests/test_only_directive.py b/tests/test_only_directive.py
index 2396046e4..af1462c03 100644
--- a/tests/test_only_directive.py
+++ b/tests/test_only_directive.py
@@ -17,10 +17,10 @@ from util import *
 
 
 def teardown_module():
-    (test_root / '_build').rmtree(True)
+    (test_roots / 'test-only-directive' / '_build').rmtree(True)
 
 
-@with_app(buildername='text')
+@with_app(buildername='text', srcdir=(test_roots / 'test-only-directive'))
 def test_sectioning(app):
 
     def getsects(section):
diff --git a/tests/util.py b/tests/util.py
index 817f218f0..3e17d3626 100644
--- a/tests/util.py
+++ b/tests/util.py
@@ -30,7 +30,7 @@ from nose import tools, SkipTest
 
 
 __all__ = [
-    'test_root', 'raises', 'raises_msg',
+    'test_root', 'test_roots', 'raises', 'raises_msg',
     'skip_if', 'skip_unless', 'skip_unless_importable', 'Struct',
     'ListOutput', 'TestApp', 'with_app', 'gen_with_app',
     'path', 'with_tempdir', 'write_file',
@@ -39,6 +39,7 @@ __all__ = [
 
 
 test_root = path(__file__).parent.joinpath('root').abspath()
+test_roots = path(__file__).parent.joinpath('roots').abspath()
 
 
 def _excstr(exc):
@@ -153,6 +154,8 @@ class TestApp(application.Sphinx):
             self.cleanup_trees.insert(0, outdir)
         if doctreedir is None:
             doctreedir = srcdir.joinpath(srcdir, self.builddir, 'doctrees')
+            if not doctreedir.isdir():
+                doctreedir.makedirs()
             if cleanenv:
                 self.cleanup_trees.insert(0, doctreedir)
         if confoverrides is None:

From 64a4c13d63681662456d62535b2d9491cf139eac Mon Sep 17 00:00:00 2001
From: Jonathan Waltman <jonathan.waltman@gmail.com>
Date: Sat, 5 Jan 2013 21:08:22 -0600
Subject: [PATCH 28/29] autodoc: Don't rely on reporter.get_source_and_line
 existing for debug messages.

---
 sphinx/ext/autodoc.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/sphinx/ext/autodoc.py b/sphinx/ext/autodoc.py
index 300c4f22c..4563b35bd 100644
--- a/sphinx/ext/autodoc.py
+++ b/sphinx/ext/autodoc.py
@@ -1305,7 +1305,10 @@ class AutoDirective(Directive):
         self.warnings = []
         self.result = ViewList()
 
-        source, lineno = self.reporter.get_source_and_line(self.lineno)
+        try:
+            source, lineno = self.reporter.get_source_and_line(self.lineno)
+        except AttributeError:
+            source = lineno = None
         self.env.app.debug('%s:%s: <input>\n%s',
                            source, lineno, self.block_text)
 

From 9b9c69042e0981cd5798a5a26ec5fc2725275a6c Mon Sep 17 00:00:00 2001
From: Takayuki Shimizukawa <shimizukawa@gmail.com>
Date: Sun, 6 Jan 2013 16:15:49 +0900
Subject: [PATCH 29/29] Divide test_intl target source files for speed-up.

---
 tests/root/contents.txt                       |   1 -
 tests/roots/test-intl/bom.po                  |  12 ++
 tests/roots/test-intl/bom.txt                 |   5 +
 tests/roots/test-intl/conf.py                 |   7 +
 .../test-intl/contents.txt}                   |   2 +
 .../test-intl}/definition_terms.po            |   0
 .../test-intl}/definition_terms.txt           |   0
 .../test-intl}/external_links.po              |   0
 .../test-intl}/external_links.txt             |   0
 .../test-intl}/figure_caption.po              |   0
 .../test-intl}/figure_caption.txt             |   0
 .../i18n => roots/test-intl}/footnote.po      |   0
 .../i18n => roots/test-intl}/footnote.txt     |   0
 tests/{root/i18n => roots/test-intl}/i18n.png | Bin
 .../i18n => roots/test-intl}/index_entries.po |   0
 .../test-intl}/index_entries.txt              |   0
 .../i18n => roots/test-intl}/literalblock.po  |   0
 .../i18n => roots/test-intl}/literalblock.txt |   0
 .../test-intl}/refs_inconsistency.po          |   0
 .../test-intl}/refs_inconsistency.txt         |   0
 tests/roots/test-intl/subdir/contents.txt     |   2 +
 tests/test_build_gettext.py                   |   7 +-
 tests/test_build_html.py                      |   1 -
 tests/test_intl.py                            | 123 +++++++++---------
 24 files changed, 91 insertions(+), 69 deletions(-)
 create mode 100644 tests/roots/test-intl/bom.po
 create mode 100644 tests/roots/test-intl/bom.txt
 create mode 100644 tests/roots/test-intl/conf.py
 rename tests/{root/i18n/index.txt => roots/test-intl/contents.txt} (86%)
 rename tests/{root/i18n => roots/test-intl}/definition_terms.po (100%)
 rename tests/{root/i18n => roots/test-intl}/definition_terms.txt (100%)
 rename tests/{root/i18n => roots/test-intl}/external_links.po (100%)
 rename tests/{root/i18n => roots/test-intl}/external_links.txt (100%)
 rename tests/{root/i18n => roots/test-intl}/figure_caption.po (100%)
 rename tests/{root/i18n => roots/test-intl}/figure_caption.txt (100%)
 rename tests/{root/i18n => roots/test-intl}/footnote.po (100%)
 rename tests/{root/i18n => roots/test-intl}/footnote.txt (100%)
 rename tests/{root/i18n => roots/test-intl}/i18n.png (100%)
 rename tests/{root/i18n => roots/test-intl}/index_entries.po (100%)
 rename tests/{root/i18n => roots/test-intl}/index_entries.txt (100%)
 rename tests/{root/i18n => roots/test-intl}/literalblock.po (100%)
 rename tests/{root/i18n => roots/test-intl}/literalblock.txt (100%)
 rename tests/{root/i18n => roots/test-intl}/refs_inconsistency.po (100%)
 rename tests/{root/i18n => roots/test-intl}/refs_inconsistency.txt (100%)
 create mode 100644 tests/roots/test-intl/subdir/contents.txt

diff --git a/tests/root/contents.txt b/tests/root/contents.txt
index 0fbd68236..de60ec6dd 100644
--- a/tests/root/contents.txt
+++ b/tests/root/contents.txt
@@ -28,7 +28,6 @@ Contents:
    extensions
    versioning/index
    footnote
-   i18n/index
 
    Python <http://python.org/>
 
diff --git a/tests/roots/test-intl/bom.po b/tests/roots/test-intl/bom.po
new file mode 100644
index 000000000..c6025eb1e
--- /dev/null
+++ b/tests/roots/test-intl/bom.po
@@ -0,0 +1,12 @@
+#, fuzzy
+msgid ""
+msgstr ""
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+msgid "File with UTF-8 BOM"
+msgstr "Datei mit UTF-8"
+
+msgid "This file has a UTF-8 \"BOM\"."
+msgstr "This file has umlauts: äöü."
diff --git a/tests/roots/test-intl/bom.txt b/tests/roots/test-intl/bom.txt
new file mode 100644
index 000000000..3fea824f8
--- /dev/null
+++ b/tests/roots/test-intl/bom.txt
@@ -0,0 +1,5 @@
+File with UTF-8 BOM
+===================
+
+This file has a UTF-8 "BOM".
+
diff --git a/tests/roots/test-intl/conf.py b/tests/roots/test-intl/conf.py
new file mode 100644
index 000000000..457c5056f
--- /dev/null
+++ b/tests/roots/test-intl/conf.py
@@ -0,0 +1,7 @@
+# -*- coding: utf-8 -*-
+
+import sys, os
+
+project = 'Sphinx intl <Tests>'
+source_suffix = '.txt'
+keep_warnings = True
diff --git a/tests/root/i18n/index.txt b/tests/roots/test-intl/contents.txt
similarity index 86%
rename from tests/root/i18n/index.txt
rename to tests/roots/test-intl/contents.txt
index dfacc0193..45db24cc9 100644
--- a/tests/root/i18n/index.txt
+++ b/tests/roots/test-intl/contents.txt
@@ -2,6 +2,8 @@
    :maxdepth: 2
    :numbered:
 
+   subdir/contents
+   bom
    footnote
    external_links
    refs_inconsistency
diff --git a/tests/root/i18n/definition_terms.po b/tests/roots/test-intl/definition_terms.po
similarity index 100%
rename from tests/root/i18n/definition_terms.po
rename to tests/roots/test-intl/definition_terms.po
diff --git a/tests/root/i18n/definition_terms.txt b/tests/roots/test-intl/definition_terms.txt
similarity index 100%
rename from tests/root/i18n/definition_terms.txt
rename to tests/roots/test-intl/definition_terms.txt
diff --git a/tests/root/i18n/external_links.po b/tests/roots/test-intl/external_links.po
similarity index 100%
rename from tests/root/i18n/external_links.po
rename to tests/roots/test-intl/external_links.po
diff --git a/tests/root/i18n/external_links.txt b/tests/roots/test-intl/external_links.txt
similarity index 100%
rename from tests/root/i18n/external_links.txt
rename to tests/roots/test-intl/external_links.txt
diff --git a/tests/root/i18n/figure_caption.po b/tests/roots/test-intl/figure_caption.po
similarity index 100%
rename from tests/root/i18n/figure_caption.po
rename to tests/roots/test-intl/figure_caption.po
diff --git a/tests/root/i18n/figure_caption.txt b/tests/roots/test-intl/figure_caption.txt
similarity index 100%
rename from tests/root/i18n/figure_caption.txt
rename to tests/roots/test-intl/figure_caption.txt
diff --git a/tests/root/i18n/footnote.po b/tests/roots/test-intl/footnote.po
similarity index 100%
rename from tests/root/i18n/footnote.po
rename to tests/roots/test-intl/footnote.po
diff --git a/tests/root/i18n/footnote.txt b/tests/roots/test-intl/footnote.txt
similarity index 100%
rename from tests/root/i18n/footnote.txt
rename to tests/roots/test-intl/footnote.txt
diff --git a/tests/root/i18n/i18n.png b/tests/roots/test-intl/i18n.png
similarity index 100%
rename from tests/root/i18n/i18n.png
rename to tests/roots/test-intl/i18n.png
diff --git a/tests/root/i18n/index_entries.po b/tests/roots/test-intl/index_entries.po
similarity index 100%
rename from tests/root/i18n/index_entries.po
rename to tests/roots/test-intl/index_entries.po
diff --git a/tests/root/i18n/index_entries.txt b/tests/roots/test-intl/index_entries.txt
similarity index 100%
rename from tests/root/i18n/index_entries.txt
rename to tests/roots/test-intl/index_entries.txt
diff --git a/tests/root/i18n/literalblock.po b/tests/roots/test-intl/literalblock.po
similarity index 100%
rename from tests/root/i18n/literalblock.po
rename to tests/roots/test-intl/literalblock.po
diff --git a/tests/root/i18n/literalblock.txt b/tests/roots/test-intl/literalblock.txt
similarity index 100%
rename from tests/root/i18n/literalblock.txt
rename to tests/roots/test-intl/literalblock.txt
diff --git a/tests/root/i18n/refs_inconsistency.po b/tests/roots/test-intl/refs_inconsistency.po
similarity index 100%
rename from tests/root/i18n/refs_inconsistency.po
rename to tests/roots/test-intl/refs_inconsistency.po
diff --git a/tests/root/i18n/refs_inconsistency.txt b/tests/roots/test-intl/refs_inconsistency.txt
similarity index 100%
rename from tests/root/i18n/refs_inconsistency.txt
rename to tests/roots/test-intl/refs_inconsistency.txt
diff --git a/tests/roots/test-intl/subdir/contents.txt b/tests/roots/test-intl/subdir/contents.txt
new file mode 100644
index 000000000..b6509bafb
--- /dev/null
+++ b/tests/roots/test-intl/subdir/contents.txt
@@ -0,0 +1,2 @@
+subdir contents
+===============
diff --git a/tests/test_build_gettext.py b/tests/test_build_gettext.py
index dcbff4849..d98cde86c 100644
--- a/tests/test_build_gettext.py
+++ b/tests/test_build_gettext.py
@@ -20,6 +20,7 @@ from util import SkipTest
 
 def teardown_module():
     (test_root / '_build').rmtree(True)
+    (test_roots / 'test-intl' / '_build').rmtree(True),
 
 
 @with_app(buildername='gettext')
@@ -83,10 +84,12 @@ def test_gettext(app):
 
 
 @with_app(buildername='gettext',
+          srcdir=(test_roots / 'test-intl'),
+          doctreedir=(test_roots / 'test-intl' / '_build' / 'doctree'),
           confoverrides={'gettext_compact': False})
 def test_gettext_index_entries(app):
     # regression test for #976
-    app.builder.build(['i18n/index_entries'])
+    app.builder.build(['index_entries'])
 
     _msgid_getter = re.compile(r'msgid "(.*)"').search
     def msgid_getter(msgid):
@@ -95,7 +98,7 @@ def test_gettext_index_entries(app):
             return m.groups()[0]
         return None
 
-    pot = (app.outdir / 'i18n' / 'index_entries.pot').text(encoding='utf-8')
+    pot = (app.outdir / 'index_entries.pot').text(encoding='utf-8')
     msgids = filter(None, map(msgid_getter, pot.splitlines()))
 
     expected_msgids = [
diff --git a/tests/test_build_html.py b/tests/test_build_html.py
index 182009b98..abd60bbb5 100644
--- a/tests/test_build_html.py
+++ b/tests/test_build_html.py
@@ -35,7 +35,6 @@ ENV_WARNINGS = """\
 %(root)s/autodoc_fodder.py:docstring of autodoc_fodder\\.MarkupError:2: \
 WARNING: Explicit markup ends without a blank line; unexpected \
 unindent\\.\\n?
-%(root)s/i18n/literalblock.txt:13: WARNING: Literal block expected; none found.
 %(root)s/images.txt:9: WARNING: image file not readable: foo.png
 %(root)s/images.txt:23: WARNING: nonlocal image URI found: \
 http://www.python.org/logo.png
diff --git a/tests/test_intl.py b/tests/test_intl.py
index 932142999..d828a8517 100644
--- a/tests/test_intl.py
+++ b/tests/test_intl.py
@@ -22,19 +22,34 @@ from util import SkipTest
 
 
 warnfile = StringIO()
+root = test_roots / 'test-intl'
+doctreedir = root / '_build' / 'doctree'
+
+
+def with_intl_app(*args, **kw):
+    default_kw = {
+        'srcdir': root,
+        'doctreedir': doctreedir,
+        'confoverrides': {
+            'language': 'xx', 'locale_dirs': ['.'],
+            'gettext_compact': False,
+        },
+    }
+    default_kw.update(kw)
+    return with_app(*args, **default_kw)
 
 
 def setup_module():
     # Delete remnants left over after failed build
-    (test_root / 'xx').rmtree(True)
-    (test_root / 'xx' / 'LC_MESSAGES').makedirs()
+    (root / 'xx').rmtree(True)
+    (root / 'xx' / 'LC_MESSAGES').makedirs()
     # Compile all required catalogs into binary format (*.mo).
-    for dirpath, dirs, files in os.walk(test_root):
+    for dirpath, dirs, files in os.walk(root):
         dirpath = path(dirpath)
         for f in [f for f in files if f.endswith('.po')]:
             po = dirpath / f
-            mo = test_root / 'xx' / 'LC_MESSAGES' / (
-                    relpath(po[:-3], test_root) + '.mo')
+            mo = root / 'xx' / 'LC_MESSAGES' / (
+                    relpath(po[:-3], root) + '.mo')
             if not mo.parent.exists():
                 mo.parent.makedirs()
             try:
@@ -52,12 +67,11 @@ def setup_module():
 
 
 def teardown_module():
-    (test_root / '_build').rmtree(True)
-    (test_root / 'xx').rmtree(True)
+    (root / '_build').rmtree(True)
+    (root / 'xx').rmtree(True)
 
 
-@with_app(buildername='text',
-          confoverrides={'language': 'xx', 'locale_dirs': ['.']})
+@with_intl_app(buildername='text')
 def test_simple(app):
     app.builder.build(['bom'])
     result = (app.outdir / 'bom.txt').text(encoding='utf-8')
@@ -67,31 +81,26 @@ def test_simple(app):
     assert result == expect
 
 
-@with_app(buildername='text',
-          confoverrides={'language': 'xx', 'locale_dirs': ['.']})
+@with_intl_app(buildername='text')
 def test_subdir(app):
-    app.builder.build(['subdir/includes'])
-    result = (app.outdir / 'subdir' / 'includes.txt').text(encoding='utf-8')
-    assert result.startswith(u"\ntranslation\n***********\n\n")
+    app.builder.build(['subdir/contents'])
+    result = (app.outdir / 'subdir' / 'contents.txt').text(encoding='utf-8')
+    assert result.startswith(u"\nsubdir contents\n***************\n")
 
 
-@with_app(buildername='html', cleanenv=True,
-          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
-                         'gettext_compact': False})
+@with_intl_app(buildername='html', cleanenv=True)
 def test_i18n_footnote_break_refid(app):
     """test for #955 cant-build-html-with-footnotes-when-using"""
-    app.builder.build(['i18n/footnote'])
-    result = (app.outdir / 'i18n' / 'footnote.html').text(encoding='utf-8')
+    app.builder.build(['footnote'])
+    result = (app.outdir / 'footnote.html').text(encoding='utf-8')
     # expect no error by build
 
 
-@with_app(buildername='text', cleanenv=True,
-          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
-                         'gettext_compact': False})
+@with_intl_app(buildername='text', cleanenv=True)
 def test_i18n_footnote_regression(app):
     """regression test for fix #955"""
-    app.builder.build(['i18n/footnote'])
-    result = (app.outdir / 'i18n' / 'footnote.txt').text(encoding='utf-8')
+    app.builder.build(['footnote'])
+    result = (app.outdir / 'footnote.txt').text(encoding='utf-8')
     expect = (u"\nI18N WITH FOOTNOTE"
               u"\n******************\n"  # underline matches new translation
               u"\nI18N WITH FOOTNOTE INCLUDE THIS CONTENTS [ref] [1] [100]\n"
@@ -101,13 +110,11 @@ def test_i18n_footnote_regression(app):
     assert result == expect
 
 
-@with_app(buildername='html', cleanenv=True,
-          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
-                         'gettext_compact': False})
+@with_intl_app(buildername='html', cleanenv=True)
 def test_i18n_footnote_backlink(app):
     """i18n test for #1058"""
-    app.builder.build(['i18n/footnote'])
-    result = (app.outdir / 'i18n' / 'footnote.html').text(encoding='utf-8')
+    app.builder.build(['footnote'])
+    result = (app.outdir / 'footnote.html').text(encoding='utf-8')
     expects = [
         '<a class="footnote-reference" href="#id5" id="id1">[100]</a>',
         '<a class="footnote-reference" href="#id4" id="id2">[1]</a>',
@@ -121,13 +128,11 @@ def test_i18n_footnote_backlink(app):
         assert len(matches) == 1
 
 
-@with_app(buildername='text', warning=warnfile, cleanenv=True,
-          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
-                         'gettext_compact': False})
+@with_intl_app(buildername='text', warning=warnfile, cleanenv=True)
 def test_i18n_warn_for_number_of_references_inconsistency(app):
     app.builddir.rmtree(True)
-    app.builder.build(['i18n/refs_inconsistency'])
-    result = (app.outdir / 'i18n' / 'refs_inconsistency.txt').text(encoding='utf-8')
+    app.builder.build(['refs_inconsistency'])
+    result = (app.outdir / 'refs_inconsistency.txt').text(encoding='utf-8')
     expect = (u"\nI18N WITH REFS INCONSISTENCY"
               u"\n****************************\n"
               u"\n* FOR FOOTNOTE [ref2].\n"
@@ -139,7 +144,7 @@ def test_i18n_warn_for_number_of_references_inconsistency(app):
     assert result == expect
 
     warnings = warnfile.getvalue().replace(os.sep, '/')
-    warning_fmt = u'.*/i18n/refs_inconsistency.txt:\\d+: ' \
+    warning_fmt = u'.*/refs_inconsistency.txt:\\d+: ' \
           u'WARNING: inconsistent %s in translated message\n'
     expected_warning_expr = (
         warning_fmt % 'footnote references' +
@@ -148,12 +153,10 @@ def test_i18n_warn_for_number_of_references_inconsistency(app):
     assert re.search(expected_warning_expr, warnings)
 
 
-@with_app(buildername='html', cleanenv=True,
-          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
-                         'gettext_compact': False})
+@with_intl_app(buildername='html', cleanenv=True)
 def test_i18n_link_to_undefined_reference(app):
-    app.builder.build(['i18n/refs_inconsistency'])
-    result = (app.outdir / 'i18n' / 'refs_inconsistency.html').text(encoding='utf-8')
+    app.builder.build(['refs_inconsistency'])
+    result = (app.outdir / 'refs_inconsistency.html').text(encoding='utf-8')
 
     expected_expr = """<a class="reference external" href="http://www.example.com">reference</a>"""
     assert len(re.findall(expected_expr, result)) == 2
@@ -165,13 +168,11 @@ def test_i18n_link_to_undefined_reference(app):
     assert len(re.findall(expected_expr, result)) == 1
 
 
-@with_app(buildername='html', cleanenv=True,
-          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
-                         'gettext_compact': False})
+@with_intl_app(buildername='html', cleanenv=True)
 def test_i18n_keep_external_links(app):
     """regression test for #1044"""
-    app.builder.build(['i18n/external_links'])
-    result = (app.outdir / 'i18n' / 'external_links.html').text(encoding='utf-8')
+    app.builder.build(['external_links'])
+    result = (app.outdir / 'external_links.html').text(encoding='utf-8')
 
     # external link check
     expect_line = u"""<li>EXTERNAL LINK TO <a class="reference external" href="http://python.org">Python</a>.</li>"""
@@ -206,13 +207,11 @@ def test_i18n_keep_external_links(app):
     assert expect_line == matched_line
 
 
-@with_app(buildername='text', warning=warnfile, cleanenv=True,
-          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
-                         'gettext_compact': False})
+@with_intl_app(buildername='text', warning=warnfile, cleanenv=True)
 def test_i18n_literalblock_warning(app):
     app.builddir.rmtree(True)  #for warnings acceleration
-    app.builder.build(['i18n/literalblock'])
-    result = (app.outdir / 'i18n' / 'literalblock.txt').text(encoding='utf-8')
+    app.builder.build(['literalblock'])
+    result = (app.outdir / 'literalblock.txt').text(encoding='utf-8')
     expect = (u"\nI18N WITH LITERAL BLOCK"
               u"\n***********************\n"
               u"\nCORRECT LITERAL BLOCK:\n"
@@ -223,18 +222,16 @@ def test_i18n_literalblock_warning(app):
     assert result.startswith(expect)
 
     warnings = warnfile.getvalue().replace(os.sep, '/')
-    expected_warning_expr = u'.*/i18n/literalblock.txt:\\d+: ' \
+    expected_warning_expr = u'.*/literalblock.txt:\\d+: ' \
             u'WARNING: Literal block expected; none found.'
     assert re.search(expected_warning_expr, warnings)
 
 
-@with_app(buildername='text',
-          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
-                         'gettext_compact': False})
+@with_intl_app(buildername='text')
 def test_i18n_definition_terms(app):
     # regression test for #975
-    app.builder.build(['i18n/definition_terms'])
-    result = (app.outdir / 'i18n' / 'definition_terms.txt').text(encoding='utf-8')
+    app.builder.build(['definition_terms'])
+    result = (app.outdir / 'definition_terms.txt').text(encoding='utf-8')
     expect = (u"\nI18N WITH DEFINITION TERMS"
               u"\n**************************\n"
               u"\nSOME TERM"
@@ -245,13 +242,11 @@ def test_i18n_definition_terms(app):
     assert result == expect
 
 
-@with_app(buildername='text',
-          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
-                         'gettext_compact': False})
+@with_intl_app(buildername='text')
 def test_i18n_figure_caption(app):
     # regression test for #940
-    app.builder.build(['i18n/figure_caption'])
-    result = (app.outdir / 'i18n' / 'figure_caption.txt').text(encoding='utf-8')
+    app.builder.build(['figure_caption'])
+    result = (app.outdir / 'figure_caption.txt').text(encoding='utf-8')
     expect = (u"\nI18N WITH FIGURE CAPTION"
               u"\n************************\n"
               u"\n   [image]MY CAPTION OF THE FIGURE\n"
@@ -261,12 +256,10 @@ def test_i18n_figure_caption(app):
     assert result == expect
 
 
-@with_app(buildername='html',
-          confoverrides={'language': 'xx', 'locale_dirs': ['.'],
-                         'gettext_compact': False})
+@with_intl_app(buildername='html')
 def test_i18n_index_entries(app):
     # regression test for #976
-    app.builder.build(['i18n/index_entries'])
+    app.builder.build(['index_entries'])
     result = (app.outdir / 'genindex.html').text(encoding='utf-8')
 
     def wrap(tag, keyword):