+-*- outline -*-
+
These notes intend to help people working on the CVS versions of
-Bison. 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:
+Bison.
+
+* Requirements
+
+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 <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.
-- Automake 1.6 or 1.6.1
-- Autoconf 2.53 or better
- (actually, CVS Autoconf provides a better autoreconf...
- http://www.lrde.epita.fr/~akim/download/autoconf-2.53a.tar.gz)
-- Gettext 0.10.1
+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.
The next step is asking the installation of all the missing files:
- $ autoreconf -f -v -i
-
-Unfortunately, this will change a few files that should not have been
-replaced, so remove them, and ask for the original copies:
-
- $ rm Makefile.am configure.in m4/Makefile.am
- $ cvs update
-
-(Hopefully, these steps will no longer be needed in the future.)
-Because of these changes, running autoreconf a second, and last time,
-is needed. Pay attention that the options are different this time:
-
- $ autoreconf -v -f
+ $ ./bootstrap
And there you are! Just
$ cvs diff
-should output no difference, except maybe the date in po/*.po files.
+should output no difference.
Enjoy!
-
-----
-Copyright (C) 2002 Free Software Foundation, Inc.
+Copyright (C) 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
-This file is part of GNU Autoconf.
+This file is part of GNU Bison.
-GNU Autoconf is free software; you can redistribute it and/or modify
+GNU Bison is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
-GNU Autoconf is distributed in the hope that it will be useful,
+GNU Bison is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
-along with autoconf; see the file COPYING. If not, write to
-the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-Boston, MA 02111-1307, USA.
+along with Bison; see the file COPYING. If not, write to
+the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+Boston, MA 02110-1301, USA.
projects / bison.git / blobdiff