Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

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

RE:building manpages via setup.py

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> (permalink)
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

Show key headers only | View raw

> 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 computer 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 python 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

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

Thread

building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-01 16:50 +0200
  Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-01 17:00 +0200
    RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-01 17:50 +0200
  Re: building manpages via setup.py Piotr Ożarowski <piotr@debian.org> - 2017-08-01 17:40 +0200
    RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 09:20 +0200
      Re: building manpages via setup.py Piotr Ożarowski <piotr@debian.org> - 2017-08-02 09:30 +0200
        Re: building manpages via setup.py Piotr Ożarowski <piotr@debian.org> - 2017-08-02 09:50 +0200
          Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-02 09:50 +0200
            Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-02 10:20 +0200
              RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 10:40 +0200
                Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-02 10:40 +0200
                RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 11:20 +0200
                Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-02 11:30 +0200
                RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 12:10 +0200
                Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-02 12:50 +0200
                RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 14:30 +0200
            RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 10:30 +0200
        RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 09:50 +0200
        RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-03 12:20 +0200
          RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-03 15:50 +0200
            RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-03 16:20 +0200

csiph-web