From 5b4aaf787b33fa22b8639c9db5da59fc7ceb1704 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Thu, 25 Aug 2005 19:06:24 +0000 Subject: [PATCH] * README-cvs: Give URLs for recommended tools. Mention Gzip version problem, and bootstrapping issues. Remove troubleshooting section, as it's somewhat obsolete. --- ChangeLog | 4 ++++ README-cvs | 48 +++++++++++++++++++++--------------------------- 2 files changed, 25 insertions(+), 27 deletions(-) diff --git a/ChangeLog b/ChangeLog index b1cc1fb..7d6b6a0 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,9 @@ 2005-08-25 Paul Eggert + * 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 941beb3..c25499b 100644 --- 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 +- Autoconf +- Flex +- Gettext +- Gzip +- Tar +- 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 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. -- 2.7.4