pỳthon setup.py --builder man doesn't work with pbr=2.0

[Alfredo Moralejo]

When using pbr=2.0 and try to build manpages using setup.py build_sphinx --builder man, following messages appear:

$ python setup.py build_sphinx --builder man
running build_sphinx
[pbr] Writing ChangeLog
[pbr] Generating ChangeLog
[pbr] ChangeLog complete (1.2s)
[pbr] Generating AUTHORS
[pbr] AUTHORS complete (1.9s)

But man pages are not generated.

I'm using following versions of pbr and sphinx:

pbr (2.0.0)
Sphinx (1.5.3)

The problem is that parameter man_pages is not processed when using init_values from sphinx.config.Config as it has been moved to the manpage plugin, so we need to initialize the config in a different way.

[Alfredo Moralejo (amoralej)]

using command:

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

it works as expected

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/448455

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/448455
Committed: https://git.openstack.org/cgit/openstack-dev/pbr/commit/?id=2d7c0045f402b31d6223437ba25423eeb32278e1
Submitter: Jenkins
Branch: master

commit 2d7c0045f402b31d6223437ba25423eeb32278e1
Author: Alfredo Moralejo <email address hidden>
Date: Wed Mar 22 04:56:56 2017 -0400

    Initialize sphinx config using application instead of config

    Currently sphinx config is initialized using sphinx.config,
    however in recent versions of Sphinx, plugin specific parameters
    as man_pages for man builder has been moved to the extension
    and is not initialized from sphinx.config but using sphinx.application.
    This is making man_pages to be empty when using sphinx 1.5 and man
    builder is not properly called.

    This patch initializes sphinx config using sphinx.application which
    works fine with both old and new Sphinx versions.

    Closes-Bug: #1674795

    Depends-On: I7bde8fc1f2a7db5bd73635aa197377bf5ac614d2
    Change-Id: Ib7c1a6fe8fbb5acfcfcfac61d0b53f080ff2b1e4

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack-dev/pbr 2.1.0 release.