X-Git-Url: https://git.saurik.com/bison.git/blobdiff_plain/0df72d78ffbbada9870afdcc6b8f035e7395e902..c981ce9b2b825d09920e70ffe5a5045f13b6341f:/README diff --git a/README b/README index a6bfe732..2bf62bf2 100644 --- a/README +++ b/README @@ -1,31 +1,47 @@ -This package contains the Bison parser generator. +This package contains the GNU Bison parser generator. -See the file INSTALL for generic compilation and installation instructions. +* Installation +** Build +See the file INSTALL for generic compilation and installation +instructions. +Bison requires GNU m4 1.4.6 or later. See: + + ftp://ftp.gnu.org/gnu/m4/m4-1.4.6.tar.gz + +** 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". -Bison requires GNU m4 1.4.3 or later. See: - -ftp://ftp.gnu.org/gnu/m4/m4-1.4.3.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. +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 . + +Local Variables: +mode: outline +End: ----- -Copyright (C) 1992, 1998, 1999, 2003, 2004, 2005, 2008 Free Software Foundation, Inc. +Copyright (C) 1992, 1998, 1999, 2003, 2004, 2005, 2008-2009 Free +Software Foundation, Inc. This file is part of Bison, the GNU Compiler Compiler.