Bug#932696: Please document Haskell team style Vcs-Git sytax [and 1 more messages]

[Ian Jackson]

Russ Allbery writes ("Re: Bug#932696: Please document Haskell team style Vcs-Git sytax [and 1 more messages]"):
> So, maybe something like:
> 
>     <url> -b <branch> [<path>; <key>=<value> ...]
> 
> to build off of what we already have?  (With, obviously, a bunch of that
> syntax marked as optional.)  If we ban "=" in <path>, we can allow for
> <path> to be optional but some other key/value pair to be provided.

SGTM.  We can specify that [ ] contains optional information.  I guess
that is why that syntax was chosen...

Then critical information which *should* cause an old parser to fail
can also be added.

So the overall syntax is roughly

  <url> [ " -b " <branch> ] [ " " <other critial information> ]
     [ " [" ( <path> | <key> "=" <value> "; " )* "]" ]

We can say that it's <key> if it has "=" before any "/".  Then paths
containing = are expressable as ./foo=bar

Ian.

-- 
Ian Jackson <ijackson at chiark.greenend.org.uk>   These opinions are my own.

If I emailed you from an address @fyvzl.net or @evade.org.uk, that is
a private address which bypasses my fierce spamfilter.