| 1 | -*- outline -*- |
| 2 | |
| 3 | These notes intend to help people working on the CVS versions of |
| 4 | Bison. |
| 5 | |
| 6 | * Requirements |
| 7 | |
| 8 | Only the sources are installed in the CVS repository (to ease the |
| 9 | maintenance, merges etc.), therefore you will have to get the latest |
| 10 | stable versions of the maintainer tools we depend upon, including: |
| 11 | |
| 12 | - Automake <http://www.gnu.org/software/automake/> |
| 13 | - Autoconf <http://www.gnu.org/software/autoconf/> |
| 14 | - Flex <http://www.gnu.org/software/flex/> |
| 15 | - Gettext <http://www.gnu.org/software/gettext/> |
| 16 | - Gzip <http://www.gnu.org/software/gzip/> |
| 17 | - Tar <http://www.gnu.org/software/tar/> |
| 18 | - Wget <http://www.gnu.org/software/wget/> |
| 19 | |
| 20 | As of this writing, the latest stable version of Gzip is 1.2.4 but we |
| 21 | suggest using test version 1.3.5 (or later, if one becomes available). |
| 22 | |
| 23 | Valgrind <http://valgrind.org/> is also highly recommended, if |
| 24 | Valgrind supports your architecture. |
| 25 | |
| 26 | Bison is written using Bison grammars, so there are bootstrapping |
| 27 | issues. The bootstrap script attempts to discover when the C code |
| 28 | generated from the grammars is out of date, and to bootstrap with an |
| 29 | out-of-date version of the C code, but the process is not foolproof. |
| 30 | Also, you may run into similar problems yourself if you modify Bison. |
| 31 | |
| 32 | Only building the initial full source tree will be a bit painful, |
| 33 | later, a plain `cvs update -P & make' should be sufficient. |
| 34 | |
| 35 | * First CVS checkout |
| 36 | |
| 37 | Obviously, if you are reading these notes, you did manage to check out |
| 38 | Bison from CVS. For the records, you will find all the relevant |
| 39 | information on: |
| 40 | |
| 41 | http://savannah.gnu.org/cvs/?group_id=56 |
| 42 | |
| 43 | The next step is asking the installation of all the missing files: |
| 44 | |
| 45 | $ ./bootstrap |
| 46 | |
| 47 | And there you are! Just |
| 48 | |
| 49 | $ ./configure && make && make check |
| 50 | |
| 51 | At this point, there should be no difference between your local copy, |
| 52 | and the CVS master copy: |
| 53 | |
| 54 | $ cvs diff |
| 55 | |
| 56 | should output no difference. |
| 57 | |
| 58 | Enjoy! |
| 59 | |
| 60 | ----- |
| 61 | |
| 62 | Copyright (C) 2002, 2003, 2004, 2005 Free Software Foundation, Inc. |
| 63 | |
| 64 | This file is part of GNU Bison. |
| 65 | |
| 66 | GNU Bison is free software; you can redistribute it and/or modify |
| 67 | it under the terms of the GNU General Public License as published by |
| 68 | the Free Software Foundation; either version 2, or (at your option) |
| 69 | any later version. |
| 70 | |
| 71 | GNU Bison is distributed in the hope that it will be useful, |
| 72 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 73 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 74 | GNU General Public License for more details. |
| 75 | |
| 76 | You should have received a copy of the GNU General Public License |
| 77 | along with Bison; see the file COPYING. If not, write to |
| 78 | the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
| 79 | Boston, MA 02110-1301, USA. |