[Digicool-CVS] CVS: CVSROOT - repolinks:1.2
Fri, 3 Aug 2001 16:03:58 -0400
Update of /cvs-repository/CVSROOT
In directory cvs.zope.org:/tmp/cvs-serv5404
Some somewhat gratuitous comment refinements, to trigger processing
There should be a lot of output, since all the links are being
created. The output should typically be much less, since unchanged
links don't elicit any messages.
=== CVSROOT/repolinks 1.1 => 1.2 ===
# wind up pointing outside the repository are also deleted.
-# Lines beginning with a '#' sign, like this, and blank lines are
+# Blank lines and lines beginning with '#' are ignored.
-# The other lines should be white-space separated pairs of paths:
+# The other lines should contain one or two white-space separated paths:
# - The first path indicates where the symlink is situated. It is
# interepreted relative to the repository root, whether or not it
@@ -18,10 +17,12 @@
# interpreted relative to the repo root if it is absolute, otherwise
# it is used as is, for relative links within the repository.
-# To gracefully retire an existing symlink, include an entry but
-# omit the second path. This will cause a link to be created
-# pointing to an empty directory - the CVS equivalent of a removed
+# The second path can be empty, to indicate retirement of an
+# existing symlink. You should not just remove entries for symlinks
+# - their absence will break checkouts that included them, unless
+# they're replaced by actual directories. Not specifying the second
+# path translates to a link that points to an empty directory
+# (CVSROOT/Emptydir) - the CVS equivalent of a removed directory.