glance manpage building in rocky is broken due to missing glance-cache-manage

[Thomas Bechtold]

Using the latest commit (b3ff79ffa45f2439d769006fe9eb84ccf5690759) from stable/rocky branch.

When trying to build the man pages with:

sphinx-build -W -b man doc/source doc/build/man

I get:

[snipped]
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... glance-api.1 { } glance-cache-cleaner.1 { } glance-cache-manage.1 {
Exception occurred:
  File "/home/tom/devel/openstack/glance/.tox/docs/lib/python2.7/site-packages/sphinx/environment/__init__.py", line 782, in get_doctree
    with open(doctree_filename, 'rb') as f:
IOError: [Errno 2] No such file or directory: u'/home/tom/devel/openstack/glance/doc/build/man/.doctrees/cli/glancecachemanage.doctree'
The full traceback has been saved in /tmp/sphinx-err-YA1GQ3.log, if you want to report the issue to the developers.

This is because commit f126d3b8cc6ea5b8dc45bba52402cadfb4beb041 removed glancecachemanage.rst and the man page building is not tested in CI.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/rocky
Review: https://review.opendev.org/676882

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/676882
Committed: https://git.openstack.org/cgit/openstack/glance/commit/?id=f992a0b23af02f87226fc45617dfe4d40b10b1cc
Submitter: Zuul
Branch: stable/rocky

commit f992a0b23af02f87226fc45617dfe4d40b10b1cc
Author: Thomas Bechtold <email address hidden>
Date: Fri Aug 16 10:51:06 2019 +0200

    Fix manpage building and remove glance-cache-manage

    Commit f126d3b8cc6ea5b8dc removed glancecachemanage.rst . So man page
    building (which is not tested in CI) is broken and the failure when
    building with:

    sphinx-build -W -b man doc/source doc/build/man

    is:

    [snipped]
    writing... glance-api.1 { } glance-cache-cleaner.1 { } glance-cache-manage.1 {
    Exception occurred:
    [snipped]
    IOError: [Errno 2] No such file or directory: \
        u'/openstack/glance/doc/build/man/.doctrees/cli/glancecachemanage.doctree'

    Change-Id: I07471cdf472789bd149746a687484420a4b8675f
    Closes-Bug: #1840424

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/glance 17.0.1 release.

[Cyril Roelandt (cyril-roelandt)]

This works in master and will not be fixed in stable/stein.