X-Git-Url: https://git.saurik.com/bison.git/blobdiff_plain/85ac3861e7c7de8877562ac0dbb1233d91c705c2..d834eca014bd545fb359d20687b4ce2c6875219d:/README diff --git a/README b/README index a053f4b8..04bf5106 100644 --- a/README +++ b/README @@ -1,41 +1,63 @@ -This directory contains the Bison parser generator. +This package contains the GNU Bison parser generator. -See the file INSTALL for generic compilation and installation instructions. -See the file doc/FAQ for frequently asked questions. +* Installation +** Build +See the file INSTALL for generic compilation and installation +instructions. -Bison requires GNU m4 1.4.3 or later. See: +Bison requires GNU m4 1.4.6 or later. See: -ftp://ftp.gnu.org/gnu/m4/m4-1.4.3.tar.gz + ftp://ftp.gnu.org/gnu/m4/m4-1.4.6.tar.gz -Bison can work with pre-1.4.3 distributions of GNU m4 if they are -sufficiently patched, but if you encounter a bug with an older -distribution and report a bug we will probably suggest that you -upgrade to 1.4.3 as the first step in trying to fix it. +** Internationalization +Bison supports two catalogues: one for Bison itself (i.e., for the +maintainer-side parser generation), and one for the generated parsers +(i.e., for the user-side parser execution). The requirements between +both differ: bison needs ngettext, the generated parsers do not. To +simplify the build system, neither are installed if ngettext is not +supported, even if generated parsers could have been localized. See +http://lists.gnu.org/archive/html/bug-bison/2009-08/msg00006.html for +more details. +* Questions +See the section FAQ in the documentation (doc/bison.info) for +frequently asked questions. The documentation is also available in +PDF and HTML, provided you have a recent version of Texinfo installed: +run "make pdf" or "make html". + +If you have questions about using Bison and the documentation does +not answer them, please send mail to . + +* Bug reports Please send bug reports to . Please include the version number from `bison --version', and a complete, self-contained test case in each bug report. -If you have questions about using Bison and the documentation does -not answer them, please send mail to . +* Copyright statements +For any copyright year range specified as YYYY-ZZZZ in this package, +note that the range specifies every single year in that closed interval. + + +Local Variables: +mode: outline +End: ----- -Copyright (C) 1992, 1998, 1999, 2003, 2004, 2005 Free Software Foundation, Inc. +Copyright (C) 1992, 1998-1999, 2003-2005, 2008-2012 Free Software +Foundation, Inc. This file is part of Bison, the GNU Compiler Compiler. -Bison is free software; you can redistribute it and/or modify +This program 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. +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. -Bison is distributed in the hope that it will be useful, +This program 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., 51 Franklin Street, Fifth Floor, -Boston, MA 02110-1301, USA. +along with this program. If not, see .