Bug#932696: Please document Haskell team style Vcs-Git sytax [and 1 more messages]
Ian Jackson <ijackson@chiark.greenend.org.uk> writes:
> I wrote:
>> Many packages' .dscs contain something like this:
>> Source: bustle
>> Version: 0.7.4-1
>> Vcs-Git: https://salsa.debian.org/haskell-team/DHG_packages.git [p/bustle]
>> The semantics do not appearr to be documented in policy.
> But I foolishly didn't even CC the Haskell team! Sorry.
> Haskell folks, would you care to suggest a wording ?
> Policy folks: can I suggest that we should define an extensible
> syntax ? If the syntax had been made extensible last time it was
> extended, devscripts and dgit would probably have coped here.
> (#932697 in devscripts and #932699 in dgit.)
Sure, an extensible syntax sounds great. The problem is that we kind of
had one (Vcs-Git was a subset of a git checkout command line, which
allowed support of the -b option), but this (if I understand it correctly)
is a whole new type of thing that I don't think corresponds to any git
command-line flags.
It's kind of hard to design an extensible format with any well-defined
meaning if we don't know what sorts of things people will want to add via
extensions....
What we would ideally have is a git URL that allows representing the
branch and path within the repository, along with the transport. Surely
there must be prior work out there -- has anyone defined such a thing
already? https isn't going to cut it, unfortunately, since a lot of the
information we want to represent isn't part of the https URL to the Git
repository itself. Subversion was closer to getting this right, although
made easier by Subversion's repository structure.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: