Can no more generate watcher-spec HTML doc.

[David TARDIVEL]

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 generated by Sphinx and 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'

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/275795
Committed: https://git.openstack.org/cgit/openstack/watcher-specs/commit/?id=e392b809bb5e550a89ff7a4bfa47aeaa09e54ace
Submitter: Jenkins
Branch: master

commit e392b809bb5e550a89ff7a4bfa47aeaa09e54ace
Author: David TARDIVEL <email address hidden>
Date: Wed Feb 3 16:39:52 2016 +0100

    Fix WARNING on bad reference

    Reference to 'problem description' section was incorrect.

    Change-Id: Ib91bcea7c3c318e2f2e1a6a43e3888b3c5d771f0
    Closes-Bug: #1541472