Appendix C. Using the SVN repository

C.1. Use SVN and let your users know about it

(Hopefully) All OCaml-related Debian packages are maintained using a centralized Subversion (SVN for short) repository. This practice reduce the efforts needed to contribute work inside The Debian OCaml Task Force and, in case of need, provides a place where to massively perform changes to all OCaml-related Debian packages.

Nonetheless, Debian users can benefit knowing we are using a SVN repository (they can for instance subscribe to the RSS feed for changes or have a place where to look for finding patches corresponding to bugs tagged "pending" in the BTS).

For this reason it is recommended to add the XS-Vcs-Svn and XS-Vcs-Browser fields to the debian/control of packages maintained in The Debian OCaml Task Force SVN repository. Its name specifies that we are using Subversion as our Version Control System (VCS); their values are the URLs pointing to the package's trunk directory and to a browsable view of the same directory. See Bug #391023 (which contains the forthcoming text for the Debian Developer's Reference) for more information about these fields.

The general scheme for using the fields are thus:


  XS-Vcs-Svn: svn://svn.debian.org/svn/pkg-ocaml-maint/trunk/packages/PACKAGE_NAME
  XS-Vcs-Browser: http://svn.debian.org/wsvn/pkg-ocaml-maint/trunk/packages/PACKAGE_NAME/trunk/
    

Example C-1. Usage example of the XS-Vcs-* fields, from the findlib package


  Source: findlib
  Section: devel
  Priority: optional
  Maintainer: Stefano Zacchiroli <zack@debian.org>
  Build-Depends: debhelper (>> 4.0.0), ocaml (>= 3.09.2), m4, gawk | awk, dpatch, cdbs
  Standards-Version: 3.7.2
  XS-Vcs-Svn: svn://svn.debian.org/svn/pkg-ocaml-maint/trunk/packages/findlib
  XS-Vcs-Browser: http://svn.debian.org/wsvn/pkg-ocaml-maint/trunk/packages/findlib/trunk/

  Package: ocaml-findlib
  Section: devel
  Architecture: any
  Depends: ocaml-nox-${F:OCamlABI}, ${shlibs:Depends}, ${misc:Depends}
  Description: Management tool for OCaml programming language libraries
  ...