Re: Example package using python3-pbr and Sphinx documentation with manual page

2020-05-04 Thread Jeremy Stanley 
On 2020-05-04 19:07:00 + (+), Jeremy Stanley wrote:
> On 2020-05-04 19:13:38 +0200 (+0200), Florian Weimer wrote:
> > I'm trying to package pwclient, which depends on python3-pbr and has a
> > rudimentary manual page generated from Sphinx documentation.  Is there
> > a similar example package which I can look at, to see how to trigger
> > the manual page generation?
> > 
> > I currently get this:
> > 
> > dh_sphinxdoc: warning: Sphinx documentation not found
> [...]
> 
> Since PBR originated in OpenStack, the python3-openstackclient
> package may serve as a good example. It does a dh_sphinxdoc override
> for manpage building here:
> 
>  https://salsa.debian.org/openstack-team/clients/python-openstackclient/-/blob/88bdecc66a30b4e3d5aec9cdae4cc529c33690e6/debian/rules#L27
>  >
> 
> Then there's a similar dh_installman override a few lines later.

Oh, and since you mentioned the conf.py contents, here's how it's
being done in the upstream source for that repo:

https://opendev.org/openstack/python-openstackclient/src/commit/fdefe5558b7237757d788ee000382f913772bffc/doc/source/conf.py#L225-L233
 >

-- 
Jeremy Stanley


signature.asc
Description: PGP signature

Re: Example package using python3-pbr and Sphinx documentation with manual page

2020-05-04 Thread Jeremy Stanley 
On 2020-05-04 19:13:38 +0200 (+0200), Florian Weimer wrote:
> I'm trying to package pwclient, which depends on python3-pbr and has a
> rudimentary manual page generated from Sphinx documentation.  Is there
> a similar example package which I can look at, to see how to trigger
> the manual page generation?
> 
> I currently get this:
> 
> dh_sphinxdoc: warning: Sphinx documentation not found
[...]

Since PBR originated in OpenStack, the python3-openstackclient
package may serve as a good example. It does a dh_sphinxdoc override
for manpage building here:

https://salsa.debian.org/openstack-team/clients/python-openstackclient/-/blob/88bdecc66a30b4e3d5aec9cdae4cc529c33690e6/debian/rules#L27
 >

Then there's a similar dh_installman override a few lines later.
-- 
Jeremy Stanley


signature.asc
Description: PGP signature

Example package using python3-pbr and Sphinx documentation with manual page

2020-05-04 Thread Florian Weimer 
I'm trying to package pwclient, which depends on python3-pbr and has a
rudimentary manual page generated from Sphinx documentation.  Is there
a similar example package which I can look at, to see how to trigger
the manual page generation?

I currently get this:

dh_sphinxdoc: warning: Sphinx documentation not found

debian/rules has:

#!/usr/bin/make -f

%:
dh $@ --with python3,sphinxdoc --buildsystem=pybuild

I have patched this into docs/conf.py at the end:

# -- Options for manual page output 

man_pages = [
('usage', 'pwclient', 'VCS-agnostic tool for interacting with Patchwork',
 ['The pwclient authors (see AUTHORS file)'],
 1),
]

Any suggestions what to try next?  Thanks.