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 `-
Attachment:
signature.asc
Description: PGP signature