Path: csiph.com!aioe.org!bofh.it!news.nic.it!robomod
From: PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr>
Newsgroups: linux.debian.maint.python
Subject: RE:building manpages via setup.py
Date: Tue, 01 Aug 2017 17:50:01 +0200
Message-ID: <u9HAJ-5MK-15@gated-at.bofh.it>
References: <u9HAJ-5MK-17@gated-at.bofh.it> <u9GOl-5h7-3@gated-at.bofh.it>
X-Mailbox-Line: From debian-python-request@lists.debian.org  Tue Aug  1 15:42:12 2017
Old-Return-Path: <frederic-emmanuel.picca@synchrotron-soleil.fr>
X-Amavis-Spam-Status: No, score=-0.1 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, THREADTOPIC=2] autolearn=no autolearn_force=no
X-Policyd-Weight: using cached result; rate: -6.1
Dkim-Filter: OpenDKIM Filter v2.10.3 poussette.synchrotron-soleil.fr 54ADC60123
Dkim-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=synchrotron-soleil.fr; s=email; t=1501601198; bh=3pMvRjiDEmsiEHnDay/ANFV3nSf40QaYH4GLhjtJrDY=; h=From:To:Subject:Date:References:In-Reply-To:From; b=TJMtpC2vRNKqE1FgUdEs0WSvKdTIOv300lJWaFIDlPv6P2gAOIQIAtwyRLB/mYLgX z02S4Cphtb5wB4kA4twHCNoygKIy8Iwdjh7lzRbRyYz0tBNg2XgLnkRiaNGpDHrMRK xssJvyUVWGcTgUyPUk9B5ha5irDpiTu5KF5Fj9NU=
Dkim-Filter: OpenDKIM Filter v2.10.3 poussette.synchrotron-soleil.fr 8B088600BC
Dkim-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=synchrotron-soleil.fr; s=email; t=1501601197; bh=3pMvRjiDEmsiEHnDay/ANFV3nSf40QaYH4GLhjtJrDY=; h=From:To:Subject:Date:References:In-Reply-To:From; b=JzEVf50DsyXzqIUBlTpXTk2QdnhLuhUWw5oyV+IbZXLE1ibpSwXVjA1pzGR+c8FKe VnINHWR2Hud0ut+TfQyB4V9d59vNva0vhTxd0iEa/xkjSBBniGdHdeIl2eFqeY065F XOJG7OYwRszpfXupBQxMUJ+zekTxq9r0ArY4lByQ=
Thread-Topic: building manpages via setup.py
Thread-Index: AdMKnYeNbtHGA2ChRMa/5+FgMHXlSAAKD3QAAAUbO2U=
Accept-Language: fr-FR, en-US
Content-Language: fr-FR
X-Originating-IP: [195.221.0.171]
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailing-List: <debian-python@lists.debian.org> archive/latest/15044
List-ID: <debian-python.lists.debian.org>
List-URL: <https://lists.debian.org/debian-python/>
List-Archive: https://lists.debian.org/msgid-search/A2A20EC3B8560D408356CAC2FC148E53BB3F8A93@SUN-DAG3.synchrotron-soleil.fr
Approved: robomod@news.nic.it
Lines: 35
Organization: linux.* mail to news gateway
Sender: robomod@news.nic.it
X-Original-Date: Tue, 1 Aug 2017 15:26:36 +0000
X-Original-Message-ID: <A2A20EC3B8560D408356CAC2FC148E53BB3F8A93@SUN-DAG3.synchrotron-soleil.fr>
X-Original-References: <A2A20EC3B8560D408356CAC2FC148E53BB3F8A26@SUN-DAG3.synchrotron-soleil.fr>,<41a3f00e-cc48-bfac-08c6-787d2e4c41a4@gmail.com> <41a3f00e-cc48-bfac-08c6-787d2e4c41a4@gmail.com>
Xref: csiph.com linux.debian.maint.python:9663

> Simplest I can think of would be to build the extensions inplace
> followed by the call to build_man. Something like:

> override_dh_auto_build:
>         dh_auto_build
>         python3 setup.py build_ext --inplace
>         python3 setup.py build_man

I do not want to build once more the ext (it takes a lot's of time on my co=
mputer and it is a wast of ressources).
I just want to run {interpreter} setup.py build_man <options>

where

<options> are provided by pybuild

> I left the http_proxy exports and nodoc guards out for clarity.

thanks ;)

>  Second questions what is the right way to generate the man pages for a p=
ython application ?

> Usually via Sphinx if the upstream documentation uses it. Regardless of
> the stack, `help2man` is often considered the poor man choice for
> generating manpages.

Thanks, I know this but I need more time to convince the upstream to find a=
 better solution :)

> Let me know if you'd like me to have a look :-)

thanks a lot

Fred=