www-es-general
[Top][All Lists]
Advanced

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

[GNU-traductores] old-gnudist:/home/www/html/server/standards/README.cvs


From: old-gnudist's file diff daemon
Subject: [GNU-traductores] old-gnudist:/home/www/html/server/standards/README.cvs.html -- New file
Date: Tue, 15 Jan 2002 06:29:22 -0800 (PST)

This is an automated report from old-gnudist.
This appears to be a new file or has only recently been added to
the list of monitored files:

  14 -rw-rw-r--    1 webcvs   www         12766 Dec 20 02:18 
/home/www/html/server/standards/README.cvs.html

Contents:

<!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 &gt;&gt; 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:
              &lt;!-- hhmts start --&gt;
              26 Jul 2000 tower
              &lt;!-- hhmts end --&gt;
              &lt;HR&gt;
              </PRE>
              to
              <PRE>
              Updated:
              &lt;!-- timestamp start --&gt;
              &#36;Date&#36; &#36;Author&#36;
              &lt;!-- timestamp end --&gt;
              &lt;HR&gt;
              </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 &amp; GNU inquiries &amp; 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.,
59 Temple Place - Suite 330, Boston, MA  02111,  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: 2001/12/20 10:18:10 $ $Author: mohit $
<!-- timestamp end -->
<HR>
</BODY>
</HTML>



reply via email to

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