2007-01-29 Paolo Bonzini <bonzini@gnu.org>

[bison.git] / README-cvs

diff --git a/README-cvs b/README-cvs
index 0b9b27050d5b028c3a04b69620e08efe70218e87..6f3bcb4c0d8d762d9984f403b040c09bfb5b473b 100644 (file)
--- a/README-cvs
+++ b/README-cvs
@@ -6,19 +6,31 @@ Bison.
 * Requirements
 
 Only the sources are installed in the CVS repository (to ease the
-maintenance, merges etc.), therefore you will have to the maintainer
-tools we depend upon:
+maintenance, merges etc.), therefore you will have to get the latest
+stable versions of the maintainer tools we depend upon, including:
 
-- Automake 1.7
+- 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/>
 
-- Autoconf 2.57
+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).
 
-- Gettext 0.12.1
+Valgrind <http://valgrind.org/> is also highly recommended, if
+Valgrind supports your architecture.
 
-- CVS Bison itself
+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.
+later, a plain `cvs update -P && make' should be sufficient.
 
 * First CVS checkout
 
@@ -41,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:
-   http://www.lrde.epita.fr/~akim/download/
-
-3. Extract it
-
-4. Override the content of your checkout with the content of this
-   tarball, i.e.:
-   cp -r bison-1.49b/* bison-cvs
-
-5. Proceed on ./configure && make etc.
-
 -----
 
-Copyright (C) 2002, 2003 Free Software Foundation, Inc.
+Copyright (C) 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
 
 This file is part of GNU Bison.
 
@@ -83,5 +75,5 @@ GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
 along with Bison; see the file COPYING.  If not, write to
-the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-Boston, MA 02111-1307, USA.
+the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+Boston, MA 02110-1301, USA.