[pkg-go] patch for packaging docs around versions

[Jonathan Dowland]

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.

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.

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

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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-fixes-for-versioning-section.patch
Type: text/x-diff
Size: 1942 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/pkg-go-maintainers/attachments/20160928/8ef6b430/attachment.patch>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-go-maintainers/attachments/20160928/8ef6b430/attachment.sig>