Bug#933804: Improve dpt-forward documentation

[Aniol Marti]

Source: pkg-perl-tools
Severity: wishlist

Dear maintainer,

In the dpt-forward man page the need to belong in an organization when
forwarding a patch to GitHub is not stated, so the user won't know that
the default organization is pkg-perl-tools and it may have to be changed
with the variable DPT_GITHUB_ORGNAME. I think that both the need to be
in a organization and how to change it should be added to the man page.

On the other hand, it is also not explained that the clone process is
done through SSH, and it may cause problems if you expect it to be HTTPS.
In this case I think that adding a variable DPT_GITHUB_PROTOCOL={https,
ssh} would be very useful.

I have given more details to alexm in a private conversation.


Thanks,

Aniol Marti