Set up initial test.

doc/config.rst

@@ -524,10 +524,14 @@ that use Sphinx' HTMLWriter class.
 
 .. confval:: html_extra_path
 
-   A list of paths that contain extra files (such as
+   A list of paths that contain extra files not directly related to
-   :file:`robots.txt` or :file:`.htaccess`).  Relative paths are taken
+   the documentation, such as :file:`robots.txt` or :file:`.htaccess`.
-   as relative to the configuration directory.  They are copied to the
+   Relative paths are taken as relative to the configuration
-   output directory, and will overwrite any existing generated file.
+   directory.  They are copied to the output directory.  They will
+   overwrite any existing file of the same name.
+
+   As these files are not meant to be built, they are automatically added to
+   :confval:`exclude_patterns`.
 
    .. versionadded:: 1.2
 

sphinx/environment.py

@@ -335,6 +335,7 @@ class BuildEnvironment:
         """
         matchers = compile_matchers(
             config.exclude_patterns[:] +
+            config.html_extra_path +
             config.exclude_trees +
             [d + config.source_suffix for d in config.unused_docs] +
             ['**/' + d for d in config.exclude_dirnames] +

tests/root/conf.py

@@ -38,6 +38,7 @@ html_sidebars = {'**': 'customsb.html',
                  'contents': ['contentssb.html', 'localtoc.html'] }
 html_style = 'default.css'
 html_static_path = ['_static', 'templated.css_t']
+html_extra_path = ['robots.txt']
 html_last_updated_fmt = '%b %d, %Y'
 html_context = {'hckey': 'hcval', 'hckey_co': 'wrong_hcval_co'}
 

tests/root/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Disallow: /cgi-bin/