PBR doesn't support builder option for build_sphinx command

[Kenneth Koski]

I'm trying to generate a pdf version of the documentation for a project that uses pbr. This is the command that I'm using to do that:

    python setup.py build_sphinx --builder=pdf

According to the help for that command, that should work. However, HTML and man documentation are the only types that are ever generated. It appears that this is due to pbr intercepting the build_sphinx command, with the subclass located here:

https://github.com/openstack-dev/pbr/blob/master/pbr/builddoc.py#L67

There appears to be some attempt at making the option configurable, as seen later in the file:

https://github.com/openstack-dev/pbr/blob/master/pbr/builddoc.py#L201

But I can't seem to figure out how that might be set from the command line. Running "python setup.py build_sphinx -b man,pdf" didn't change the default builder options.

[Robert Collins (lifeless)]

hmm, I'm not sure sorry. I'll see if I can get someone more familiar with the sphinx stuff to look

[Monty Taylor (mordred)]

This is a bug for sure. we should honor the command line when it's given.

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Change abandoned by Monty Taylor (<email address hidden>) on branch: master
Review: https://review.openstack.org/178878

[Stephen Finucane (stephenfinucane)]

We've determined that we're simply going to remove this feature in a future MAJOR release (likely 5.0). As such, I'm going to close this as won't fix.