Comment 3 for bug 1695127

Reviewed: https://review.openstack.org/470252
Committed: https://git.openstack.org/cgit/openstack/nova-specs/commit/?id=77b2ae9c5f5efdf1d565794921077458aedd8be9
Submitter: Jenkins
Branch: master

commit 77b2ae9c5f5efdf1d565794921077458aedd8be9
Author: Dirk Mueller <email address hidden>
Date: Fri Jun 2 13:14:04 2017 +0200

    Fix citation references (Sphinx 1.6.x compatibility)

    Sphinx 1.6.x gained a cross-reference check warning that caused
    the build to fail in "tox -e docs" environment. Removing underscores
    from the citation reference identifier ensures that the cross references
    are properly detected. Similarly missing references to footnotes are
    now a warning (which is upgraded to an error in the docs tox
    environment) so adjust references where it makes sense and is needed.

    Closes-Bug: #1695127
    Change-Id: I7e55dcf910e0ba6dd85b565db8cb1ecbdd39634a