www-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

www/server/standards README.webmastering.html


From: Karl Berry
Subject: www/server/standards README.webmastering.html
Date: Sun, 14 Sep 2008 18:52:33 +0000

CVSROOT:        /web/www
Module name:    www
Changes by:     Karl Berry <karl>       08/09/14 18:52:33

Modified files:
        server/standards: README.webmastering.html 

Log message:
        updates are instant now, except for .symlinks which are half-hourly

CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/www/server/standards/README.webmastering.html?cvsroot=www&r1=1.70&r2=1.71

Patches:
Index: README.webmastering.html
===================================================================
RCS file: /web/www/www/server/standards/README.webmastering.html,v
retrieving revision 1.70
retrieving revision 1.71
diff -u -b -r1.70 -r1.71
--- README.webmastering.html    12 Jul 2008 20:00:31 -0000      1.70
+++ README.webmastering.html    14 Sep 2008 18:52:03 -0000      1.71
@@ -732,20 +732,18 @@
 check that file and add contact information if it's not there already.</p>
 
 
-<h4>Symbolic Links</h4>
+<a id="symlinks"></a>
+<h4>Symbolic links</h4>
 
-<p>
-Since CVS is not able to handle symbolic links, a simple mechanism has been
-implemented on the machine hosting the www.gnu.org to allow webmasters to
-control the symbolic link from the CVS tree.
-</p>
-
-<p>
-Special files, named .symlinks, can be committed to the CVS tree that are
-interpreted as specficiations to build symbolic links. The "symlinks"
-script can be run immediately after a "cvs update" to fix the symbolic
-links according to the specifications included in the .symlinks files.
-</p>
+<p>Since CVS is not able to handle symbolic links directly, a separate
+mechanism has been implemented to allow webmasters to maintain symbolic
+links, as follows.</p>
+
+<p>Special files, named .symlinks, can be committed to the CVS tree
+that are interpreted as specficiations to build symbolic links. The
+"symlinks" script can be run immediately after a "cvs update" to fix the
+symbolic links according to the specifications included in the .symlinks
+files.</p>
 
 <p>
 The current directory is searched recursively for .symlinks
@@ -789,24 +787,24 @@
 </p>
 
 <pre>
-        #
-       # Link foo.html to bar.html.
-       # Stricly equivalent to ln -s foo.html bar.html
-       #
-       foo.html bar.html
+# Link l.html to t.html.
+# Stricly equivalent to ln -s t.html l.html
+#
+t.html l.html
 </pre>
 
 <p>
 On each line the first file name must be a relative path name to an
 existing file. The file designated by this path must not be outside the
-document root. The second file name may not contain any slash, it is the
-name of the symbolic link to be created.
+document root. The second file name may not contain any slash; it is the
+name of the symbolic link to be created in the present directory.
 </p>
 
-<p>
-The actual command used to implement this feature is symlinks(1) and the
-sources can be found in gnudist.gnu.org:/usr/local/src/symlinks-1.1.tar.gz.
-</p>
+<p>The actual command used to implement this feature is named
+&lsquo;symlinks&rsquo;.  It runs from cron every half hour, so changes
+to .symlinks files (unlike the rest of the tree), are not instantly
+reflected in the live site.</p>
+
 
 <h4 id="pollinking">Linking Policies</h4>
 
@@ -1176,16 +1174,12 @@
 of our web site.</p>
 
 <p>Use "cvs add foo" to add a file or directory.  Use "cvs update
--P foo" before you commit a file (or "cvs update &lt;foo&gt;"), and "cvs
-commit foo" to actually commit it.  Use "cvs log foo" to review
+-P foo" before you commit a file, and "cvs commit foo" to perform the
+commit.  Changes (except to <a href="#symlinks">.symlinks files</a>)
+should be instantly visible on www.gnu.org.  Use "cvs log foo" to review
 its log history.  For further details on cvs, such as reverting to a
 previous version, or see diff output of particular changes, see the cvs
-man file.</p>
-
-<p>After a commit, you can immediately see the results (except for
-.symlinks changes) on www-test.gnu.org; this lets you correct mistakes
-before they are visible to users.  www.gnu.org itself is updated every
-half hour or so.</p>
+documentation.</p>
 
 <p>Many software packages have their own projects on savannah and hence
 their own www/software directory.  If the maintainer needs your help
@@ -1237,7 +1231,7 @@
 
   <p>Updated:
      <!-- timestamp start -->
-     $Date: 2008/07/12 20:00:31 $
+     $Date: 2008/09/14 18:52:03 $
      <!-- timestamp end -->
   </p>
   </div>




reply via email to

[Prev in Thread] Current Thread [Next in Thread]