X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=blobdiff_plain;f=resources.dbk;h=dc4a748c5be35bbfc01e4f0baf21fd5b3c34bc8d;hp=6c9deb7c0c7ea7a0d165362d78cff60928e4037a;hb=a6030264a6e43fbaa26bd1b2c18a7d469e653836;hpb=3ef65d37970b7454fc71c878ef05792fa6d15d96
diff --git a/resources.dbk b/resources.dbk
index 6c9deb7..dc4a748 100644
--- a/resources.dbk
+++ b/resources.dbk
@@ -331,28 +331,23 @@ Send mail to &email-debian-devel; if you have any questions.
-
-The CVS server
-
+
+The VCS servers
-Our CVS server is located on cvs.debian.org.
+If you need to use a Version Control System for any of your Debian work,
+you can use one the existing repositories hosted on Alioth or you can
+request a new project and ask for the VCS repository of your choice.
+Alioth supports CVS (alioth.debian.org), Subversion
+(svn.debian.org), Arch (tla/baz, both on arch.debian.org), Bazaar
+(bzr.debian.org), Darcs (darcs.debian.org), Mercurial (hg.debian.org) and Git
+(git.debian.org). Checkout if you plan
+to maintain packages in a VCS repository. See for
+information on the services provided by Alioth.
-If you need to use a publicly accessible CVS server, for instance, to help
-coordinate work on a package between many different developers, you can request
-a CVS area on the server.
-
-
-Generally, cvs.debian.org offers a combination of local CVS
-access, anonymous client-server read-only access, and full client-server access
-through ssh. Also, the CVS area can be accessed read-only
-via the Web at .
-
-
-To request a CVS area, send a request via email to
-&email-debian-admin;. Include the name of the requested CVS
-area, the Debian account that should own the CVS root area, and why you need
-it.
+Historically, Debian first used cvs.debian.org to host
+CVS repositories. But that service is deprecated in favor of Alioth.
+Only a few projects are still using it.
@@ -1057,6 +1052,15 @@ In order to prevent spam, all messages sent to these addresses must contain the
+contact
+
+
+Mails sent to the maintainer through the *@packages.debian.org email
+aliases.
+
+
+
+
summary
@@ -1085,8 +1089,10 @@ how your package gets recompiled for all architectures.
cvs
-CVS commit notifications, if the package has a CVS repository and the
-maintainer has set up forwarding commit notifications to the PTS.
+VCS commit notifications, if the package has a VCS repository and the
+maintainer has set up forwarding of commit notifications to the PTS. The
+"cvs" name is historic, in most cases commit notifications will come
+from some other VCS like subversion or git.
@@ -1185,7 +1191,13 @@ package
-cvs: notification of CVS commits
+contact: mails sent to the maintainer through the
+*@packages.debian.org aliases
+
+
+
+
+cvs: notification of VCS commits
@@ -1298,24 +1310,30 @@ Here is an example of added headers for a source upload notification on the
X-Loop: dpkg@&pts-host;
X-PTS-Package: dpkg
X-PTS-Keyword: upload-source
-X-Unsubscribe: echo 'unsubscribe dpkg' | mail pts@qa.debian.org
+List-Unsubscribe: <mailto:pts@qa.debian.org?body=unsubscribe+dpkg>
-
-Forwarding CVS commits in the PTS
+
+Forwarding VCS commits in the PTS
-If you use a publicly accessible CVS repository for maintaining your Debian
+If you use a publicly accessible VCS repository for maintaining your Debian
package, you may want to forward the commit notification to the PTS so that the
subscribers (and possible co-maintainers) can closely follow the package's
evolution.
-Once you set up the CVS repository to generate commit notifications, you just
+Once you set up the VCS repository to generate commit notifications, you just
have to make sure it sends a copy of those mails to
sourcepackage_cvs@&pts-host;.
Only the people who accept the cvs keyword will receive
-these notifications.
+these notifications. Note that the mail need to be sent from a
+debian.org machine, otherwise you'll have to add
+the X-PTS-Approved: 1 header.
+
+
+For Subversion repositories, the usage of svnmailer is recommended.
+See for an example on how to do it.