Repository: nilearn/nilearn

Issue:
unknown document: plot_seed_to_voxel_correlation
```
/home/ubuntu/nilearn/nilearn/image/resampling.py:472: UserWarning: Casting data from int64 to float64
  warnings.warn("Casting data from %s to %s" % (data.dtype.name, aux))
/home/ubuntu/miniconda2/envs/testenv/lib/python3.5/site-packages/scipy/ndimage/interpolation.py:430: UserWarning: The behaviour of affine_transform with a one-dimensional array supplied for the matrix parameter has changed in scipy 0.18.0.
  "The behaviour of affine_transform with a one-dimensional "
/home/ubuntu/miniconda2/envs/testenv/lib/python3.5/site-packages/sklearn/utils/validation.py:526: DataConversionWarning: A column-vector y was passed when a 1d array was expected. Please change the shape of y to (n_samples, ), for example using ravel().
  y = column_or_1d(y, warn=True)
/home/ubuntu/miniconda2/envs/testenv/lib/python3.5/site-packages/numpy/lib/function_base.py:3858: RuntimeWarning: Invalid value encountered in median
  r = func(a, **kwargs)

Traceback (most recent call last):
  File "/home/ubuntu/miniconda2/envs/testenv/lib/python3.5/site-packages/Sphinx-1.5.1-py3.5.egg/sphinx/cmdline.py", line 296, in main
    app.build(opts.force_all, filenames)
  File "/home/ubuntu/miniconda2/envs/testenv/lib/python3.5/site-packages/Sphinx-1.5.1-py3.5.egg/sphinx/application.py", line 333, in build
    self.builder.build_update()
  File "/home/ubuntu/miniconda2/envs/testenv/lib/python3.5/site-packages/Sphinx-1.5.1-py3.5.egg/sphinx/builders/__init__.py", line 251, in build_update
    'out of date' % len(to_build))
  File "/home/ubuntu/miniconda2/envs/testenv/lib/python3.5/site-packages/Sphinx-1.5.1-py3.5.egg/sphinx/builders/__init__.py", line 322, in build
    self.write(docnames, list(updated_docnames), method)
  File "/home/ubuntu/miniconda2/envs/testenv/lib/python3.5/site-packages/Sphinx-1.5.1-py3.5.egg/sphinx/builders/__init__.py", line 360, in write
    self._write_serial(sorted(docnames), warnings)
  File "/home/ubuntu/miniconda2/envs/testenv/lib/python3.5/site-packages/Sphinx-1.5.1-py3.5.egg/sphinx/builders/__init__.py", line 370, in _write_serial
    self.warn(*warning, **kwargs)
  File "/home/ubuntu/miniconda2/envs/testenv/lib/python3.5/site-packages/Sphinx-1.5.1-py3.5.egg/sphinx/application.py", line 399, in warn
    raise SphinxWarning(warntext)
sphinx.errors.SphinxWarning: /home/ubuntu/nilearn/doc/auto_examples/01_plotting/plot_surf_stat_map.rst:28: WARNING: unknown document: plot_seed_to_voxel_correlation


Warning, treated as error:
/home/ubuntu/nilearn/doc/auto_examples/01_plotting/plot_surf_stat_map.rst:28: WARNING: unknown document: plot_seed_to_voxel_correlation
```

More details: https://circleci.com/gh/nilearn/nilearn/2276 I believe this was introduced in #1387.


Discussion:

Resolving patch:
diff --git a/examples/01_plotting/plot_surf_stat_map.py b/examples/01_plotting/plot_surf_stat_map.py
--- a/examples/01_plotting/plot_surf_stat_map.py
+++ b/examples/01_plotting/plot_surf_stat_map.py
@@ -21,9 +21,10 @@
 The :func:`nilearn.plotting.plot_surf_stat_map` function is used
 to plot the resulting statistical map on the (inflated) pial surface.
 
-See :ref:`plotting` for more details.
-See also :doc:`plot_seed_to_voxel_correlation` for a similar example using
-volumetric input data.
+See also :ref:`for a similar example but using volumetric input data
+<sphx_glr_auto_examples_03_connectivity_plot_seed_to_voxel_correlation.py>`.
+
+See :ref:`plotting` for more details on plotting tools.
 
 NOTE: This example needs matplotlib version higher than 1.3.1.
 
diff --git a/examples/03_connectivity/plot_seed_to_voxel_correlation.py b/examples/03_connectivity/plot_seed_to_voxel_correlation.py
--- a/examples/03_connectivity/plot_seed_to_voxel_correlation.py
+++ b/examples/03_connectivity/plot_seed_to_voxel_correlation.py
@@ -10,8 +10,8 @@
 Note the difference between images, that lie in brain space, and the
 numpy array, corresponding to the data inside the mask.
 
-See also :doc:`plot_surf_stat_map` for a similar example using cortical surface
-input data.
+See also :ref:`for a similar example using cortical surface input data
+<sphx_glr_auto_examples_01_plotting_plot_surf_stat_map.py>`.
 """
 
 # author: Franz Liem


Test patch: