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

[Guillem Jover]

Hi!

On Tue, 2017-06-20 at 09:49:26 +0200, Michael Stapelberg wrote:
> 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?

Yeah, that was my initial reaction as well. And I'm not sure where
the buildsystem and sequence behavior is supposed to be documented, or
whether debhelper maintainers would recommend doing so, so I've CCed
them in case they have any input.

OTOH, dh_golang(1p) already contains a brief note about the golang
buildsystem, so perhaps that man page is not such a bad idea after
all? Also because that's the entry point for the command, but yeah
as mentioned above I also see why it feels wrong.

Thanks,
Guillem