[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
www/server/standards .symlinks README.cvs.html
|
From: |
D E Evans |
|
Subject: |
www/server/standards .symlinks README.cvs.html |
|
Date: |
Sun, 24 Feb 2008 04:23:20 +0000 |
CVSROOT: /web/www
Module name: www
Changes by: D E Evans <sinuhe> 08/02/24 04:23:20
Modified files:
server/standards: .symlinks
Removed files:
server/standards: README.cvs.html
Log message:
Remove README.cvs.html and symlink it to README.html.
CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/www/server/standards/.symlinks?cvsroot=www&r1=1.6&r2=1.7
http://web.cvs.savannah.gnu.org/viewcvs/www/server/standards/README.cvs.html?cvsroot=www&r1=1.7&r2=0
Patches:
Index: .symlinks
===================================================================
RCS file: /web/www/www/server/standards/.symlinks,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -b -r1.6 -r1.7
--- .symlinks 16 Dec 2007 00:05:37 -0000 1.6
+++ .symlinks 24 Feb 2008 04:22:50 -0000 1.7
@@ -1,3 +1,4 @@
readme_index.html index.html
README.html README.software.html
+README.html README.cvs.html
boilerplate.html boilerplate.xhtml
\ No newline at end of file
Index: README.cvs.html
===================================================================
RCS file: README.cvs.html
diff -N README.cvs.html
--- README.cvs.html 5 May 2005 19:37:20 -0000 1.7
+++ /dev/null 1 Jan 1970 00:00:00 -0000
@@ -1,427 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<HTML>
-<HEAD>
-<TITLE>CVS Usage on the GNU Web Site - GNU Project - Free Software Foundation
(FSF)</TITLE>
-<LINK REV="made" HREF="mailto:address@hidden";>
-</HEAD>
-<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000"
VLINK="#9900DD">
-<H3>CVS Usage on the GNU Web Site</H3>
-
-<!-- when you replace this graphics, make sure you change the link
- to also point to the correct html page.
- If you make a new graphics for this page, make sure it has
- a corresponding entry in /graphics/graphics.html -->
-<A HREF="/graphics/atypinggnu.html"><IMG SRC="/graphics/gnu-type-sm.jpg"
- ALT=" [image of the typing GNU] "
- WIDTH="137" HEIGHT="114"></A>
-
-[
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
- <A HREF="/server/standards/README.cvs.html">English</A>
-<!-- | A HREF="/server/standards/README.cvs.LG.html" LANGUAGE /A -->
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
-]
-
-<P>
-
-<HR>
-
-<P>
-
-<H1>OBSOLETED BY THE INTEGRATION OF www.gnu.org:~www/html/ INTO
-<A HREF="/server/standards/README.html#SEC0">CVS</A>.</H1>
-
-<H4>Table of contents</H4>
-<UL>
- <LI><A HREF="#Areasofwww.gnu.orgunderCVS"
NAME="TOCAreasofwww.gnu.orgunderCVS">Areas of www.gnu.org Under CVS</A>
- <LI><A HREF="#HowToPutATreeUnderCVS" NAME="TOCHowToPutATreeUnderCVS">How To
Put a Tree Under CVS</A>
-</UL>
-
-<P>
-
-<HR>
-
-<P>
-
-<H4><A HREF="#TOCAreasofwww.gnu.orgunderCVS"
- NAME="Areasofwww.gnu.orgunderCVS">Areas of www.gnu.org Under
- CVS</A></H4>
-<P>
-
-<STRONG>(Note that some areas on this server, www.gnu.org,
-that are under CVS, have their CVSROOT on remote CVS servers.)
-</STRONG>
-<P>
-
-This page lists (most, if not all) the areas on www.gnu.org that are under
-CVS and how to add new areas to CVS. [@@ The instructions for
-adding new areas is not yet complete. --ttn, 2000/07/24 10:49:51]
-<P>
-
-We don't list volunteers who maintain these areas, because they
-might not want their
-email address exposed to spammers.
-Ask <A HREF="mailto:address@hidden";>address@hidden</A>
-to add them to <CODE>~www/GNU.web-folk.html</CODE> which is not
-published on this site for that reason.
-<P>
-
-<DL>
- <DT>Brave GNU World
- <DD><CODE>/home/www/html/brave-gnu-world/</CODE>
-
- <DT>GNU people home pages
- <DD>greve
-
- <DT>adns
- <DD><CODE>/home/www/html/software/adns/</CODE>
-
- <DT>awacs
- <DD><CODE>/home/www/html/software/awacs/</CODE>
-
- <DT>Guile
- <DD><CODE>/home/www/html/software/guile/</CODE>
-
- <DT>Hurd
- <DD><CODE>/home/www/html/software/hurd/</CODE>
-
- <DT>libtool
- <DD><CODE>/home/www/html/software/libtool/</CODE>
-
- <DT>userv
- <DD><CODE>/home/www/html/software/userv/</CODE>
-
- <DT>Xlogmaster
- <DD><CODE>/home/www/html/software/xlogmaster/</CODE>
-
-</DL>
-
-You might also want to:
-<UL>
- <LI>check CVSROOT/loginfo to see which areas of the
- web tree are automatically updated whenever a change is committed.
- <LI>check for CVS directories in each directory under
- <CODE>/home/www/html/</CODE>.
-</UL>
-
-<P>
-
-<H4><A HREF="#TOCHowToPutATreeUnderCVS"
- NAME="HowToPutATreeUnderCVS">How To Put a Tree Under CVS</A></H4>
-
-<P>
-
-<STRONG>Before you put any of the web site under CVS please consult with
-<A HREF="mailto:address@hidden";><EM>address@hidden</EM></A>.
-</STRONG>
-<P>
-
-Consult the <A HREF="/manual/cvs/">CVS Manual</A> as necessary.
-<P>
-
-If you want to put a portion of the web site under CVS, here's how to
-go about it:
-<P>
-
-<OL>
-
- <LI>Tell CVS you want to work with the GNU web site's CVS repository:
- <PRE>$ export CVSROOT=/home/www/cvs</PRE>
-<P>
-
- <LI>First of all, get the <CODE>html</CODE> module to look the way you want.
- This is the CVS module that contains all the web pages under CVS for
- www.gnu.org. At the end of this step, your subtree under the "live"
- tree (/home/www/html/SUBTREE) will be checked into CVS as html/SUBTREE.
- <P>
-
- <UL>
- <LI>If you are adding a subtree that already exists on the web
- server to CVS for the first time, and you <EM>do not</EM> have
- any Emacs-style (.~N~) backup files, then say:
- <PRE>
- $ cd /home/www/html/SUBTREE
- $ cvs import html/SUBTREE $USER first
- </PRE>
- CVS will start up an editor and prompt you for a log message.
- Enter the message, write it, exit the editor, and
- you are done with this step.
- <P>
-
- <LI>If you are adding a subtree that already exists on the web
- server to CVS for the first time, and you have Emacs-style
- (.~N~) backup files that you <EM>want to save as CVS
- revisions</EM> (this is the preferred default on this server,
- www.gnu.org), then for each directory DIR in SUBTREE, do:
- <PRE>
- $ cd /home/www/html/DIR
- $ mkdir /home/www/cvs/html/DIR
- $ chmod 775 /home/www/cvs/html/DIR
- $ chmod g+s /home/www/cvs/html/DIR
- $ ln -s /home/www/cvs/html/DIR RCS
- $ rcs-checkin .* * # ignore warnings about . and ..
- $ rm RCS
- </PRE>
- You are now done with this step.
- [@@This should be put into a script. -ttn]
- [@@And this script should walk the DIR doing this
- for each sub-dir from the bottom up. -len]
- <P>
-
- <LI>If you are adding a new subdirectory altogether, then check out
- a copy of the <CODE>html</CODE> module:
- <PRE>
- $ [@@ Would a CVS Wizard PLEASE ... ]
- $ [@@ ... ADD SHELL COMMANDS etc. THAT DO THIS]
- </PRE>
- create the directories and files
- you want, add a CVS exculsion file to not store certain files
- in CVS
- (for example, editor backup files, automatically
- generated files (e.g. <CODE>TAGS</CODE>)
- [@@ Would a CVS wizard please add information on how to do
- this -len]
- and then use
- <PRE>
- $ cvs add
- </PRE>
- to add them, working from the
- top to the leaves. Note that CVS can't handle symlinks; we'll
- put them it later.
- [@@This should be put into a script. -ttn]
- [@@And this script should walk the DIR doing this
- for each sub-dir from the bottom up. -len]
-<!-- P -->
-
- </UL>
-
- <P>
-
- <LI>Once you have gotten the right portion of the CVS
- <CODE>html</CODE> module to
- look the way you want the corresponding portion of the web site to
- look, turn the appropriate portion of the web server's tree into a
- CVS working directory. Suppose SUBTREE has the form PARENT/TAIL,
- where TAIL is a single path component.
- <P>
- [@@This should be put into a script. -ttn]
- [@@And this script should walk the DIR doing this
- for each sub-dir from the bottom up. -len]
- <P>
-
- <UL>
- <LI>Get a working dir, as a sibling of the directory you want to
- replace:
- <P>
-
- <PRE>
- $ cd /home/www/html/PARENT
- $ cvs checkout -d temp-dir html/SUBTREE
- </PRE>
- <P>
-
- <LI>Move it into place:
- <PRE>
- $ mv TAIL old-dir; mv temp-dir TAIL
- </PRE>
- <P>
-
- <LI>CVS drops symlinks, so go back through your new tree and
- re-create any missing symlinks:
- <PRE>
- find TAIL -type d ! -name CVS \
- | while read d; do
- ln -s `basename $d`.html $d/index.html
- done
- </PRE>
- We'll just leave them there, and CVS will ignore them.
- <P>
-
- <LI>Use a web browser to check that the new tree looks right.
- Remember to reload the pages. If it's bogus, you still have
- your old, non-CVS copy.
-<!-- P -->
-
- </UL>
- <P>
-
- <LI>Now that the web area is a CVS working tree, you need to tell CVS
- to update it whenever you commit a change. We do this by editing
- a file in the CVSROOT module that CVS uses to trigger actions based
- on the name of the directory and file being committed. Specifically,
- for files under html/SUBTREE, we want CVS to call the track-cvs
- script, which will update the web area CVS working tree.
- (NOTE: you need to be in Unix group <CODE>cvsadmin</CODE> to do this
- step.)
- <P>
-
- [@@This should be put into a script. -ttn]
- [@@And this script should walk the DIR doing this
- for each sub-dir from the bottom up. -len]
- <P>
-
- <UL>
- <LI>Check out a working copy of the CVSROOT module: <P>
-
- <PRE>
- $ cd
- $ cvs checkout CVSROOT
- $ cd CVSROOT
- </PRE>
- <P>
-
- <LI>Add the following line to the file <CODE>loginfo</CODE>
- in the current (CVSROOT) directory:
- <PRE>
- ^html/SUBTREE $CVSROOT/CVSROOT/track-cvs /home/www/html/SUBTREE
- </PRE>
- <P>
-
- <LI>Commit your changes to the file <CODE>loginfo</CODE>,
- so CVS can see them:
- <PRE>
- $ cvs commit -m 'Automatically update SUBTREE' loginfo
- </PRE>
-<!-- P -->
-
- </UL>
-
-<P>
-
- <LI>Verify that the whole arrangement actually works:
- <P>
-
- <UL>
- <LI>Check out a new working copy of your subtree:
- <P>
- <PRE>
- $ cd
- $ cvs checkout html/SUBTREE
- </PRE>
- <STRONG>Debugging Tip</STRONG>:
- In this step, make sure NOT to use
- <PRE>
- $ cvs checkout -d DIR html/SUBTREE
- </PRE>
- If you do so, CVS cannot match
- <PRE>
- ^html/SUBTREE
- </PRE>
- in the <CODE>loginfo</CODE> file and
- the live website will not be updated correctly.
- <BR>
- (This condition bit the
- guile pages and went uncorrected for three months! --ttn)
- <P>
-
- <LI>Commit some trivial change to some file in html/SUBTREE, and
- make sure that CVS correctly updated the web server's tree.
- For example: <P>
- <PRE>
- $ cd
- $ cvs edit html/SUBTREE/somefile.html
- $ echo >> html/SUBTREE/somefile.html
- # trivial change
- C-d
- $ cvs commit -m'testing' html/SUBTREE/somefile.html
- </PRE>
- <P>
-
- After some seconds, /home/www/cvs/html/SUBTREE/somefile.html
- should reflect the trivial change. You can check that file
- manually or with a web browser.
- <P>
-
- <LI>Compare the old and new directories with
- <PRE>
- $ diff -r old-dir html/SUBTREE
- </PRE>
- and fix any problems.
- <P>
-
- <LI>Once things are right, you can delete the old web tree:
- <PRE>
- $ cd /home/www/html/PARENT
- $ rm -rf old-dir
- </PRE>
- <P>
-
- <LI>At the end of each page that has this text, change
- <PRE>
- Updated:
- <!-- hhmts start -->
- 26 Jul 2000 tower
- <!-- hhmts end -->
- <HR>
- </PRE>
- to
- <PRE>
- Updated:
- <!-- timestamp start -->
- $Date$ $Author$
- <!-- timestamp end -->
- <HR>
- </PRE>
- A way to do this, is to
- add the filename <CODE>TAGS</CODE> to the CVS exculsion file
- for html/SUBTREE.
- [@@ Would a CVS wizard please add information on how to do
- this -len]
- Then
- <PRE>
- $ cd html/SUBTREE
- $ find . -name "*.html" -type f -print | xargs /usr/bin/etags -D
-l none -a -o TAGS
- </PRE>
- Then use the GNU Emacs' function
- <CODE>tags-query-replace</CODE>
- to replace the text in each file that has it. Then
- <PRE>
- $ rm html/SUBTREE/TAGS
- </PRE>
- </UL>
-
-</OL>
-
-<P>
-
-<HR>
-
-[
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
- <A HREF="/server/standards/README.cvs.html">English</A>
-<!-- | A HREF="/server/standards/README.cvs.LG.html" LANGUAGE /A -->
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
-]
-<P>
-Return to <A HREF="/home.html">GNU's home page</A>.
-<P>
-
-Please send FSF & GNU inquiries & questions to
-
-<A HREF="mailto:address@hidden";><EM>address@hidden</EM></A>.
-There are also <A HREF="/home.html#ContactInfo">other ways to
-contact</A> the FSF.
-<P>
-
-Please send comments on these web pages to
-
-<A HREF="mailto:address@hidden";><EM>address@hidden</EM></A>,
-send other questions to
-<A HREF="mailto:address@hidden";><EM>address@hidden</EM></A>.
-<P>
-Copyright (C) 1999, 2000 Free Software Foundation, Inc.,
-51 Franklin St, Fifth Floor, Boston, MA 02110, USA
-<P>
-Verbatim copying and distribution of this entire article is
-permitted in any medium, provided this notice is preserved.<P>
-Updated:
-<!-- timestamp start -->
-$Date: 2005/05/05 19:37:20 $ $Author: novalis $
-<!-- timestamp end -->
-<HR>
-</BODY>
-</HTML>
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- www/server/standards .symlinks README.cvs.html,
D E Evans <=