Groups > linux.debian.maint.python > #12551

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

Path	csiph.com!5.us.feeder.erje.net!4.us.feeder.erje.net!3.eu.feeder.erje.net!2.eu.feeder.erje.net!feeder.erje.net!news2.arglkargh.de!news.mixmin.net!aioe.org!bofh.it!news.nic.it!robomod
From	Florian Weimer <fw@deneb.enyo.de>
Newsgroups	linux.debian.maint.python
Subject	Example package using python3-pbr and Sphinx documentation with manual page
Date	Mon, 04 May 2020 19:20:01 +0200
Message-ID	<A2MV3-5TB-5@gated-at.bofh.it> (permalink)
X-Original-To	debian-python@lists.debian.org
X-Mailbox-Line	From debian-python-request@lists.debian.org Mon May 4 17:13:55 2020
Old-Return-Path	<fw@deneb.enyo.de>
X-Amavis-Spam-Status	No, score=-9.28 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, LDO_WHITELIST=-5, MURPHY_DRUGS_REL8=0.02, RCVD_IN_DNSWL_MED=-2.3] autolearn=ham autolearn_force=no
X-Policyd-Weight	using cached result; rate: -4.6
MIME-Version	1.0
Content-Type	text/plain
X-Mailing-List	<debian-python@lists.debian.org> archive/latest/18236
List-ID	<debian-python.lists.debian.org>
List-URL	<https://lists.debian.org/debian-python/>
List-Archive	https://lists.debian.org/msgid-search/87368fvd19.fsf@mid.deneb.enyo.de
Approved	robomod@news.nic.it
Lines	27
Organization	linux.* mail to news gateway
Sender	robomod@news.nic.it
X-Original-Date	Mon, 04 May 2020 19:13:38 +0200
X-Original-Message-ID	<87368fvd19.fsf@mid.deneb.enyo.de>
Xref	csiph.com linux.debian.maint.python:12551

Show key headers only | View raw

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.

Back to linux.debian.maint.python | Previous | Next — Next in thread | Find similar | Unroll thread

Thread

Example package using python3-pbr and Sphinx documentation with manual page Florian Weimer <fw@deneb.enyo.de> - 2020-05-04 19:20 +0200
  Re: Example package using python3-pbr and Sphinx documentation with  manual page Jeremy Stanley <fungi@yuggoth.org> - 2020-05-04 21:10 +0200
    Re: Example package using python3-pbr and Sphinx documentation with  manual page Jeremy Stanley <fungi@yuggoth.org> - 2020-05-04 21:20 +0200

csiph-web