Your message dated Sat, 07 Feb 2026 17:08:39 -0800
with message-id <[email protected]>
and subject line Re: Bug#1084911: debian-policy: include a Vcs-* example
has caused the Debian Bug report #1084911,
regarding debian-policy: include a Vcs-* example
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
1084911: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1084911
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: debian-policy
Found: 4.7.0.1
Tags: patch
When presenting the Vcs-Browser and Vcs-<type> fields, start by showing
one typical example. With the illustration visible it is much easier for
a new maintainer to read and grasp the technical definition on what all
syntax is allowed and what it means.
Patch from https://salsa.debian.org/otto/policy/-/tree/vcs-example attached.
From aabf7692ce50d3ab3a01bb334ed38cacfd909fad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Otto=20Kek=C3=A4l=C3=A4inen?= <[email protected]>
Date: Thu, 10 Oct 2024 17:05:07 -0700
Subject: [PATCH] Add an example of Vsc-* usage to make section easy to
understand
When presenting the Vcs-Browser and Vcs-<type> fields, start by showing
one typical example. With the illustration visible it is much easier for
a new maintainer to read and grasp the technical definition on what all
syntax is allowed and what it means.
---
policy/ch-controlfields.rst | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/policy/ch-controlfields.rst b/policy/ch-controlfields.rst
index 530755a..eb673ff 100644
--- a/policy/ch-controlfields.rst
+++ b/policy/ch-controlfields.rst
@@ -1080,6 +1080,14 @@ repository where the Debian source package is developed.
``Vcs-Browser``
URL of a web interface for browsing the repository.
+ The example below illustrates the difference between the browsing location and actual VCS
+ location:
+
+ .. code-block:: debcontrol
+
+ Vcs-Browser: https://salsa.debian.org/debian/grep
+ Vcs-Git: https://salsa.debian.org/debian/grep.git
+
``Vcs-<type>``
The field name identifies the VCS. The field's value uses the version
control system's conventional syntax for describing repository
--
2.25.1
--- End Message ---
--- Begin Message ---
Version: 4.7.3.0
Otto Kekäläinen <[email protected]> writes:
>> with just
>>
>> Here is an example of the form the two values take for Debian's
>> GitLab instance, salsa:
> Sure, that makes sense. Updated accordingly at
> https://salsa.debian.org/otto/policy/-/commits/vcs-example which you
> can pull to your next/* branches with `git pull
> https://salsa.debian.org/otto/policy.git vcs-example`.
This was incorporated into the 4.7.3.0 release.
--
Russ Allbery ([email protected]) <https://www.eyrie.org/~eagle/>
--- End Message ---
