[pkg-go] Bug#839108: dh-golang: Please document behavior and variables used

[Shengjing Zhu]

On Tue, 20 Jun 2017 09:49:26 +0200 Michael Stapelberg
<stapelberg at debian.org> wrote:
> Hi Guillem,
>
> Thanks for your report!
>
> Guillem Jover <guillem at debian.org> writes:
> > Please document at least the variables from the environment that
> > directly affect the behavior such as GOPATH, DH_GOPKG,
> > DH_GOLANG_INSTALL_ALL, DH_GOLANG_INSTALL_EXTRA, DH_GOLANG_BUILDPKG,
> > DH_GOLANG_GO_GENERATE. And the field control field Go-Import-Path.
>
> What’s the correct place to document them? Stuffing this buildsystem
> related documentation into the dh_golang(1) manpage seems inappropriate,
> as that manpage should only document the dh_golang executable, right?

Add to man 3 Debian::Debhelper::Buildsystem::golang?

If you add the docs to lib/Debian/Debhelper/Buildsystem/golang.pm, the
auto generated manpage is
man3/Debian::Debhelper::Buildsystem::golang.3pm.gz

--
Best regards,
Shengjing Zhu