[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#924099: RFP: click-man -- Automate generation of man pages for python click applications



I created a package for this as a part of packaging a Click-based tool
where, as you described, I didn't like the manual options for manpage
creation. (Started with py2dsp output but have made it better than
that.) I'd be happy to collaborate with you on it.


Ryan


On Sat, 09 Mar 2019 16:05:08 +0100 Nicolas Braud-Santoni
<nicoo@debian.org> wrote:

> Package: wnpp
> Severity: wishlist
>
> * Package name : click-man
> Version : 0.3.0
> Upstream Author : Timo Furrer <tuxtimo@gmail.com>
> * URL : https://github.com/click-contrib/click-man
> * License : MIT
> Programming Lang: Python
> Description : Automate generation of man pages for python click
> applications
> 
> 
> click-man is a tool that can automatically generate manpages for
> application
> written with the click CLI framework. It provides setuptools
> integration and
> can easily be used during the build of a Debian package:
> 
> https://github.com/click-contrib/click-man#debian-packages
> 
> 
> As far as I know, current packaging practices involve either
> 1. writing a manpage by hand, which is a lot of work
> 2. generating it ahead-of-time with help2man or somesuch, and
> commiting it to
> the debian/ directory, where it might get out-of-sync with the actual
> program
> 3. not shipping manpages at all :(
> 
> Automatically generating a manpage during package build would
> definitely be
> preferable to (2) and (3), and possibly to (1) if the result is of
> sufficient
> quality.
> 
> 
> I cannot currently commit to packaging and maintaining this package,
> hence why I
> am filing a RFP, and in any case I would probably appreciate having a
> comaintainer. :)
> 
> 
> Best,
> 
> nicoo
> 
>

Attachment: 0xCBC55E3D986A54C7.asc
Description: application/pgp-keys


Reply to: