Comment 0 for bug 1541472

Into watcher-spec project, because we have, in the setup.cfg file the following flag :

[pbr]
warnerrors = True

We have an error about a WARNING generating by Sphinx related to this specification document
specs/mitaka/approved/watcher-add-actions-via-conf.rst

 {master} ~/bcom/OPENSTACK/watcher-specs$ tox -edocs
docs develop-inst-nodeps: /home/dtardivel/bcom/OPENSTACK/watcher-specs
docs installed: cssselect==0.9.1,docutils==0.12,extras==0.0.3,feedformatter==0.4,fixtures==1.4.0,Jinja2==2.8,linecache2==1.0.0,lxml==3.5.0,MarkupSafe==0.23,oslosphinx==4.2.0,pbr==0.11.1,Pygments==2.1,pyquery==1.2.11,pyrsistent==0.11.11,python-mimeparse==1.5.1,python-subunit==1.2.0,requests==2.9.1,six==1.10.0,Sphinx==1.1.3,testrepository==0.0.20,testtools==1.9.0,traceback2==1.4.0,unittest2==1.1.0,-e git+https://review.openstack.org/openstack/watcher-specs@d12ee48f54ee8205ceb2341b4f8f0326d1617704#egg=watcher_specs,wheel==0.24.0,yasfb==0.5.1
docs runtests: PYTHONHASHSEED='1065839482'
docs runtests: commands[0] | find . -type f -name *.pyc -delete
docs runtests: commands[1] | python setup.py build_sphinx
running build_sphinx
[pbr] Writing ChangeLog
[pbr] Generating ChangeLog
[pbr] Generating AUTHORS
Running Sphinx v1.1.3
loading pickled environment... done
Using openstack theme from /home/dtardivel/bcom/OPENSTACK/watcher-specs/.tox/docs/local/lib/python2.7/site-packages/oslosphinx/theme
building [html]: all source files
updating environment: [config changed] 15 added, 3 changed, 0 removed
reading sources... [100%] specs/mitaka/template
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] specs/mitaka/template
scanning /home/dtardivel/bcom/OPENSTACK/watcher-specs/doc/source for redirects...
   found redirects at /home/dtardivel/bcom/OPENSTACK/watcher-specs/doc/source/specs/mitaka/redirects
...done
pickling environment... done
checking consistency... done
Traceback (most recent call last):
  File "setup.py", line 22, in <module>
    pbr=True)
  File "/usr/lib/python2.7/distutils/core.py", line 151, in setup
    dist.run_commands()
  File "/usr/lib/python2.7/distutils/dist.py", line 953, in run_commands
    self.run_command(cmd)
  File "/usr/lib/python2.7/distutils/dist.py", line 972, in run_command
    cmd_obj.run()
  File "/home/dtardivel/bcom/OPENSTACK/watcher-specs/.tox/docs/local/lib/python2.7/site-packages/pbr/builddoc.py", line 186, in run
    self._sphinx_run()
  File "/home/dtardivel/bcom/OPENSTACK/watcher-specs/.tox/docs/local/lib/python2.7/site-packages/pbr/builddoc.py", line 140, in _sphinx_run
    app.build(force_all=self.all_files)
  File "/home/dtardivel/bcom/OPENSTACK/watcher-specs/.tox/docs/local/lib/python2.7/site-packages/sphinx/application.py", line 200, in build
    self.builder.build_all()
  File "/home/dtardivel/bcom/OPENSTACK/watcher-specs/.tox/docs/local/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 159, in build_all
    self.build(None, summary='all source files', method='all')
  File "/home/dtardivel/bcom/OPENSTACK/watcher-specs/.tox/docs/local/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 252, in build
    self.write(docnames, list(updated_docnames), method)
  File "/home/dtardivel/bcom/OPENSTACK/watcher-specs/.tox/docs/local/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 294, in write
    self.warn(*warning)
  File "/home/dtardivel/bcom/OPENSTACK/watcher-specs/.tox/docs/local/lib/python2.7/site-packages/sphinx/application.py", line 222, in warn
    raise SphinxWarning(warntext)
sphinx.errors.SphinxWarning: /home/dtardivel/bcom/OPENSTACK/watcher-specs/doc/source/specs/mitaka/approved/watcher-add-actions-via-conf.rst:217: WARNING: undefined label: problem_description (if the link has no caption the label must precede a section header)

ERROR: InvocationError: '/home/dtardivel/bcom/OPENSTACK/watcher-specs/.tox/docs/bin/python setup.py build_sphinx'