fixed info about the XS-Vcs-* fields

diff --git a/debian/changelog b/debian/changelog
index d2abcad2ca0bc325af915fbd16782d4b89172965..5afac0fbe9cc7885381933a4c5c2f0b3692614ff 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -13,8 +13,9 @@ ocaml (3.09.3-2) UNRELEASED; urgency=low
   * Policy
     - mandate the compilation of *.cm[ao] with debugging information for
       libraries and forbid it for bytecode programs
+    - update the Vcs-Svn info to the latest PTS documentation
 
- -- Stefano Zacchiroli <zack@debian.org>  Mon, 09 Apr 2007 19:46:36 +0200
+ -- Stefano Zacchiroli <zack@debian.org>  Wed, 16 May 2007 13:09:25 +0200
 
 ocaml (3.09.3-1) experimental; urgency=low
 

diff --git a/debian/policy/appendix-svn.xml b/debian/policy/appendix-svn.xml
index 80579f813eeb018abe2601057ff147e4bd9ed4eb..f8def511bba2daa561387e46057564ab4b0e84c5 100644 (file)
--- a/debian/policy/appendix-svn.xml
+++ b/debian/policy/appendix-svn.xml
@@ -17,19 +17,24 @@
   </para>
   <para>
     For this reason <emphasis>it is recommended to add the
-    <code>XS-X-Vcs-Svn</code> field to the <filename>debian/control</filename>
-    of packages maintained in &ocaml-force; SVN repository</emphasis>. Its name
-  specifies that we are using Subversion as our Version Control System
-  (<acronym>VCS</acronym>); its value is the URL pointing to the package's
-  trunk directory.
+      <code>XS-Vcs-Svn</code> and <code>XS-Vcs-Browser</code> fields to the
+      <filename>debian/control</filename> of packages maintained in
+      &ocaml-force; SVN repository</emphasis>. Its name specifies that we are
+    using Subversion as our Version Control System (<acronym>VCS</acronym>);
+    their values are the URLs pointing to the package's trunk directory and to
+    a browsable view of the same directory. See <ulink
+      url="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=391023">Bug
+      #391023</ulink> (which contains the forthcoming text for the Debian
+    Developer's Reference) for more information about these fields.
   </para>
   <para>
-    The general scheme for using the field is thus:
+    The general scheme for using the fields are thus:
     <programlisting>
-  XS-X-Vcs-Svn: svn://svn.debian.org/svn/pkg-ocaml-maint/trunk/packages/<emphasis>PACKAGE_NAME</emphasis>
+  XS-Vcs-Svn: svn://svn.debian.org/svn/pkg-ocaml-maint/trunk/packages/<emphasis>PACKAGE_NAME</emphasis>
+  XS-Vcs-Browser: http://svn.debian.org/wsvn/pkg-ocaml-maint/trunk/packages/<emphasis>PACKAGE_NAME</emphasis>/trunk/
     </programlisting>
     <example>
-      <title>Usage example of the XS-X-Vcs-Svn field, from the
+      <title>Usage example of the XS-Vcs-* fields, from the
         <application>findlib</application> package
       </title>
       <programlisting>
@@ -39,7 +44,8 @@
   Maintainer: Stefano Zacchiroli &lt;zack@debian.org&gt;
   Build-Depends: debhelper (>> 4.0.0), ocaml (>= 3.09.2), m4, gawk | awk, dpatch, cdbs
   Standards-Version: 3.7.2
-  <emphasis>XS-X-Vcs-Svn: svn://svn.debian.org/svn/pkg-ocaml-maint/trunk/packages/findlib</emphasis>
+  <emphasis>XS-Vcs-Svn: svn://svn.debian.org/svn/pkg-ocaml-maint/trunk/packages/findlib</emphasis>
+  <emphasis>XS-Vcs-Browser: http://svn.debian.org/wsvn/pkg-ocaml-maint/trunk/packages/findlib/trunk/</emphasis>
 
   Package: ocaml-findlib
   Section: devel