Warn about dubious constructions like "%token T T".

[bison.git] / README-cvs

diff --git a/README-cvs b/README-cvs
index cc52e4021e618027fa3a2d718c60237288a3e115..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.
 
@@ -81,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.