Nicolas Peugnet <[email protected]> writes: > Hi, > > I wanted to present you the tool I made recently that generates man > pages for Go programs that use the stdlib's "flag" package: > https://github.com/n-peugnet/gohelp2man ... > P.S. I will need a sponsor for the future Debian package :)
Great! I'm happy to test and sponsor eventually, I'm using help2man to
generate man-pages for several Go packages and while it is working fine,
the help2man approach has some limits. Let's get gohelp2man into Debian
and then we can compare generated man pages to make sure they are not
regressing anything compared to help2man.
Btw, it may be nice to provide a Go-team policy/recommendations on this,
I'm using this pattern, for example gitsign's debian/control:
B = $(CURDIR)/debian/tmp/usr/bin
M = $(CURDIR)/debian/tmp/usr/share/man/man1
ifeq (,$(filter nodoc,$(DEB_BUILD_PROFILES)))
execute_before_dh_installman-arch:
mkdir -pv $(M)
env PATH=$(PATH):$(B) \
help2man --version-string="$(DEB_VERSION)" \
--no-info --no-discard-stderr \
--name="Keyless Git signing using Sigstore" \
--output $(M)/gitsign.1 \
gitsign
env PATH=$(PATH):$(B) \
help2man --version-string="$(DEB_VERSION)" \
--no-info --no-discard-stderr \
--name="Gitsign(1) credential caching helper" \
--output $(M)/gitsign-credential-cache.1 \
gitsign-credential-cache
endif
/Simon
signature.asc
Description: PGP signature
