* README-cvs: Give URLs for recommended tools.

Mention Gzip version problem, and bootstrapping issues.
Remove troubleshooting section, as it's somewhat obsolete.

diff --git a/ChangeLog b/ChangeLog
index b1cc1fb045be58e90959aab1d84d892d60aa97ce..7d6b6a07b18ef00e0bd5e695ffa26e66c341b6cb 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2005-08-25  Paul Eggert  <eggert@cs.ucla.edu>
 
+       * README-cvs: Give URLs for recommended tools.
+       Mention Gzip version problem, and bootstrapping issues.
+       Remove troubleshooting section, as it's somewhat obsolete.
+
        * bootstrap (no_cache): New var, to accommodate different wget
        variants.  Use it instead of '-C off'.  Problem reported by
        twlevo@xs4all.nl.

diff --git a/README-cvs b/README-cvs
index 941beb372f2da701d899cdf488b31d9e53db3c5c..c25499be702612194354e52c5d5d1bb9df4e2662 100644 (file)
--- a/README-cvs
+++ b/README-cvs
@@ -9,11 +9,25 @@ Only the sources are installed in the CVS repository (to ease the
 maintenance, merges etc.), therefore you will have to get the latest
 stable versions of the maintainer tools we depend upon, including:
 
-- Automake
-- Autoconf
-- Flex
-- Gettext
-- CVS Bison itself
+- Automake <http://www.gnu.org/software/automake/>
+- Autoconf <http://www.gnu.org/software/autoconf/>
+- Flex <http://www.gnu.org/software/flex/>
+- Gettext <http://www.gnu.org/software/gettext/>
+- Gzip <http://www.gnu.org/software/gzip/>
+- Tar <http://www.gnu.org/software/tar/>
+- Wget <http://www.gnu.org/software/wget/>
+
+As of this writing, the latest stable version of Gzip is 1.2.4 but we
+suggest using test version 1.3.5 (or later, if one becomes available).
+
+Valgrind <http://valgrind.org/> is also highly recommended, if
+Valgrind supports your architecture.
+
+Bison is written using Bison grammars, so there are bootstrapping
+issues.  The bootstrap script attempts to discover when the C code
+generated from the grammars is out of date, and to bootstrap with an
+out-of-date version of the C code, but the process is not foolproof.
+Also, you may run into similar problems yourself if you modify Bison.
 
 Only building the initial full source tree will be a bit painful,
 later, a plain `cvs update -P & make' should be sufficient.
@@ -39,33 +53,13 @@ and the CVS master copy:
 
        $ cvs diff
 
-should output no difference, except maybe the date in po/*.po files.
+should output no difference.
 
 Enjoy!
 
-* Troubleshooting
-
-Unfortunately the current Gettext still does not include all the
-needed tools so that the bootstrapping always perform successfully.
-
-If you experience problems, I suggest the following:
-
-1. Do a regular CVS checkout
-
-2. Fetch a recent tarball in:
-   ftp://alpha.gnu.org/gnu/bison/
-
-3. Extract it
-
-4. Override the content of your checkout with the content of this
-   tarball, i.e.:
-   cp -r bison-1.875c/* bison-cvs
-
-5. Proceed on ./configure && make etc.
-
 -----
 
-Copyright (C) 2002, 2003, 2004 Free Software Foundation, Inc.
+Copyright (C) 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
 
 This file is part of GNU Bison.