Bug#654958: debian-policy: Document VCS fields.

[Charles Plessy <plessy@debian.org>]

Package: debian-policy
Version: 3.9.2.0
Severity: normal

Dear all,

now that thousands of pakcages use the VCS fields, I think that it is time to
document them in the Policy.  Please see the attached patch as a starting
point.

The Developers Reference already documents the VCS fields, and discusses
related points such as their use by the PTS.  I intentionally made the attached
patch very dry to avoid unnecessary overlaps.  If it is accepted, I will submit
a patch against the Def. Ref. to link to the Policy.

  http://www.debian.org/doc/manuals/developers-reference/best-pkging-practices#bpp-vcs

Have a nice day,

-- 
Charles
>From 3d7f84e3b7b1c0d17bb2312d99273f261c042179 Mon Sep 17 00:00:00 2001
From: Charles Plessy

Date: Sat, 7 Jan 2012 15:00:30 +0900 Subject: [PATCH] =?UTF-8?q?Document=20VCS=20fields,=20using=20Developers's=20?= =?UTF-8?q?Reference=20=C2=A76.2.5=20for=20inspiration.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- policy.sgml | 36 ++++++++++++++++++++++++++++++++++++ 1 files changed, 36 insertions(+), 0 deletions(-) diff --git a/policy.sgml b/policy.sgml index c1ff4b4..babcf0f 100644 --- a/policy.sgml +++ b/policy.sgml @@ -2616,6 +2616,7 @@ Package: libc6 Build-Depends et al Standards-Version (recommended) Homepage + VCS fields

@@ -2713,6 +2714,7 @@ Package: libc6 Checksums-Sha1 and Checksums-Sha256 (recommended) Files (mandatory) + VCS fields

@@ -3720,6 +3722,40 @@ Checksums-Sha256: details.

+ + + Version Control System (VCS) fields + +

+ Debian source packages are increasingly developed using VCSs. The + purpose of the following fields is to give the user an easy access + to the package's repository. + + + Vcs-Browser + +

+ HTTP URL of a web-browsable repository. +

+ + + + Vcs-arch, Vcs-bzr (Bazaar), Vcs-cvs, + Vcs-darcs, Vcs-git, Vcs-hg + (Mercurial), Vcs-mtn (Monotone), Vcs-svn + (Subversion) + + +

+ String identifying unequivocally the location of the + repository for anonymous access. The field name identifies + the VCS. More than one different VCS may be specified for the + same package. +

+ + +

+ -- 1.7.7.3