X Strike Force XFree86 SVN commit: rev 808 - /
Author: branden
Date: 2003-12-04 00:11:53 -0500 (Thu, 04 Dec 2003)
New Revision: 808
Modified:
README
Log:
Reorganize document to give prominence to Subversion protocol, ViewCVS, and
snapshots, in that order.
Modified: README
===================================================================
--- README 2003-12-04 05:01:55 UTC (rev 807)
+++ README 2003-12-04 05:11:53 UTC (rev 808)
@@ -1,12 +1,9 @@
README for Debian X Strike Force Subversion repository
======================================================
-Browsing the available resources
---------------------------------
+Browsing the repository via the Subversion protocol
+---------------------------------------------------
-Unfortunately, direct web browser access to the Subversion repository is only
-available with Apache 2.x, which I am not running on the repository host.
-
Read-only access is available via the SVN protocol. A daemon is running on the
standard svn port on necrotic.deadbeast.net.
@@ -41,14 +38,59 @@
Write access is restricted to people with SSH access to the host.
-A ViewCVS interface to the repository is available, but it sometimes does not
-work (see "Notes on using ViewCVS" below).
-A number of alternative means of viewing the ongoing development process are
-available. These alternative means all reside at the following URL:
+Browsing the repository via the World Wide Web (ViewCVS)
+--------------------------------------------------------
+Unfortunately, direct web browser access to the Subversion repository is only
+available with Apache 2.x, which I am not running on the repository host.
+
+ViewCVS is sometimes broken entirely; and its support for Subversion
+repositories is still alpha quality. If it doesn't work, please use one of the
+alternative resources enumerated above.
+
+To access the repository via ViewCVS, point your web browser at the following
+URL:
+ http://necrotic.deadbeast.net/cgi-bin/viewcvs.cgi/
+
+When attempting to use ViewCVS, even when it appears to be working, you may
+encounter some problems.
+
+The biggest one is that ViewCVS doesn't know how to traverse backwards across
+copy or rename operations. For instance, if you're trying to view the following
+URL:
+ http://necrotic.deadbeast.net/cgi-bin/viewcvs.cgi/tags/4.2.1-7/debian/changelog?rev=99&content-type=text/vnd.viewcvs-markup
+
+You'll get an error like this:
+
+ /cgi-bin/viewcvs.cgi/tags/4.2.1-7/debian/changelog: unknown location
+
+(Plus further error messages.)
+
+This is because revision 99 of the "changelog" file was committed before the
+Subversion copy operation that placed the debian directory into the tags/4.2.1-7
+location. Eventually, it is expected that ViewCVS will support history
+traversal across copy and rename operations, so please be patient, and do not
+report errors of this exact sort to me, the ViewCVS Debian package maintainer,
+or to the ViewCVS upstream author(s). All of us are well aware of the issue.
+
+You may also occasionally experience failures due to permission problems. This
+is due to the perversity of the Berkeley DB software, and is corrected by the
+repository administrator as soon as possible.
+
+
+Browsing the repository via the World Wide Web (snapshots)
+----------------------------------------------------------
+
+If Subversion and ViewCVS do not meet your needs, you may be interested in the
+daily snapshots that are taken of the repository and selected development trees.
+
+These resources are available at the following URL:
+
http://necrotic.deadbeast.net/xfree86/
+The resources include:
+
1) daily snapshot tar archives
Every day, tar archives of the "interesting" branches of the repository are
@@ -81,42 +123,7 @@
where YYYY, MM, and DD are the date the dump was made.
-Notes on using ViewCVS
-----------------------
-ViewCVS is sometimes broken entirely; and its support for Subversion
-repositories is still alpha quality. If it doesn't work, please use one of the
-alternative resources enumerated above.
-
-To access the repository via ViewCVS, point your web browser at the following
-URL:
- http://necrotic.deadbeast.net/cgi-bin/viewcvs.cgi/
-
-When attempting to use ViewCVS, even when it appears to be working, you may
-encounter some problems.
-
-The biggest one is that ViewCVS doesn't know how to traverse backwards across
-copy or rename operations. For instance, if you're trying to view the following
-URL:
- http://necrotic.deadbeast.net/cgi-bin/viewcvs.cgi/tags/4.2.1-7/debian/changelog?rev=99&content-type=text/vnd.viewcvs-markup
-
-You'll get an error like this:
-
- /cgi-bin/viewcvs.cgi/tags/4.2.1-7/debian/changelog: unknown location
-
-(Plus further error messages.)
-
-This is because revision 99 of the "changelog" file was committed before the
-Subversion copy operation that placed the debian directory into the tags/4.2.1-7
-location. Eventually, it is expected that ViewCVS will support history
-traversal across copy and rename operations, so please be patient, and do not
-report errors of this exact sort to me, the ViewCVS Debian package maintainer,
-or to the ViewCVS upstream author(s). All of us are well aware of the issue.
-
-You may also occasionally experience failures due to permission problems. This
-is due to the perversity of the Berkeley DB software, and is corrected by the
-repository administrator as soon as possible.
-
Understanding the repository's directory structure
--------------------------------------------------
Reply to: