[pkg-go] patch for packaging docs around versions

[Potter, Tim (HPE Linux Support)]

On 29 Sep 2016, at 1:03 AM, Jonathan Dowland <jmtd at debian.org> wrote:
> 
> Hi,
> 
> I've been reviewing the packaging guidelines and I found a problem with the
> advice on versioning. I attach a patch here to fix that -- essentially, you
> can't use underscores in Debian package versions.

Looks good to me!  dh-make-golang generates version strings using ~ so this
should be reflected the documentation as well.

> Based on looking at the scheme used by existing pkg-go packages, I reworded
> it to suggest using ~ instead. However, you then have the caveat that you
> can't use _ in git tag names -- which is where I imagine the advice about
> _ in the version originated. So I documented that caveat too.

I've given up trying to figure out what to escape in tags and just use "gbp buildpackage
--git-tag-only --git-tag" when I need to make a tag.

> Some pkg-go packages use + rather than ~ which *can* be used in package
> names. Perhaps we should just advise using + for new packages?

From memory I think there was a stage where + was used but this has been
replaced by ~ as far as I can tell.


Tim.

> 
> I also fixed a few other minor issues. I did this before I got my pkg-go
> membership confirmation so I didn't just commit direct; I could do now, I
> suppose, but I thought it best to raise the versioning issue and get
> consensus first.
> 
> Thanks,
> 
> --
> Jonathan Dowland
> <0001-fixes-for-versioning-section.patch>_______________________________________________
> Pkg-go-maintainers mailing list
> Pkg-go-maintainers at lists.alioth.debian.org
> http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-go-maintainers

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 801 bytes
Desc: Message signed with OpenPGP using GPGMail
URL: <http://lists.alioth.debian.org/pipermail/pkg-go-maintainers/attachments/20160928/9faaec15/attachment.sig>