On Thu, Apr 01, 2021 at 01:40:06PM -0700, Russ Allbery wrote: > diff --git a/policy/ch-controlfields.rst b/policy/ch-controlfields.rst > index a21a510..2a2e364 100644 > --- a/policy/ch-controlfields.rst > +++ b/policy/ch-controlfields.rst > @@ -972,11 +972,33 @@ repository where the Debian source package is developed. > - Mtn (Monotone) > - Svn (Subversion) > > - In the case of Git and Mercurial, the value consists of a URL, > - optionally followed by the word ``-b`` and the name of a branch in > - the indicated repository, following the syntax of the ``git clone`` > - or ``hg clone`` command. If no branch is specified, the packaging > - should be on the default branch. > + In the case of Git, the value must have the following syntax:: > + > + <url> [ " -b " <branch> ] [ " [" <path> "]" ] > + > + where the portions enclosed in brackets are optional and the portions > + enclosed in double quotes are literal strings. ``<url>`` indicates > + the repository. If the ``<branch>`` stanza is present, it names a > + branch in the indicated repository. If no branch is specified, the > + packaging should be on the default branch. If the ``<path>`` stanza > + is present, it specifies the relative path to the top of the packaging > + tree (the parent directory of the ``debian`` directory). If no path > + is specified, it defaults to ``.`` (the top level of the indicated > + repository and branch). > + > + For example:: > + > + Vcs-Git: https://example.org/repo -b debian [p/package] > + > + indicates a subdirectory named ``p/package`` in the ``debian`` branch > + of the repository at ``https://example.org/repo``. > + > + In the case of Mercurial, the value must have the following syntax:: > + > + <url> [ " -b " <branch> ] > + > + This is interpreted the same way as the Git syntax except a path > + within the repository is not supported. > > A package control file must not have more than one ``Vcs-<type>`` > field. If the package is maintained in multiple version control
Seconded.
Thank you for formalizing this syntax.
--
regards,
Mattia Rizzolo
GPG Key: 66AE 2B4A FCCF 3F52 DA18 4D18 4B04 3FCD B944 4540 .''`.
More about me: https://mapreri.org : :' :
Launchpad user: https://launchpad.net/~mapreri `. `'`
Debian QA page: https://qa.debian.org/developer.php?login=mattia `-
signature.asc
Description: PGP signature
