* doc/bison.texinfo (FAQ): this.
* doc/Makefile.am (EXTRA_DIST): Adjust.
+2006-03-10 Akim <akim@sulaco-eth.lrde.epita.fr>
+
+ * doc/FAQ: Remove, merged into...
+ * doc/bison.texinfo (FAQ): this.
+ * doc/Makefile.am (EXTRA_DIST): Adjust.
+
2006-03-10 Akim Demaille <akim@lrde.epita.fr>
* data/c.m4 (b4_token_enum): Always define the enum of tokens,
+++ /dev/null
-Frequently Asked Questions about Bison:
-
-----------------------------------------------------------------------
-
-Q1. Is Bison secure? Does it conform to POSIX?
-
-A1. If you're looking for a guarantee or certification, we don't
- provide it. However, Bison is intended to be a reliable program
- that conforms to the POSIX specification for Yacc. If you run
- into problems, please send us a bug report.
-
-----------------------------------------------------------------------
-
-Q2. I can't build Bison because "make" complains that "msgfmt" is not
- found. What should I do?
-
-A2. Like most GNU packages with internationalization support, that
- feature is turned on by default. If you have problems building
- in the "po" subdirectory, it indicates that your system's
- internationalization support is lacking. You can re-configure
- Bison with "--disable-nls" to turn off this support, or you can
- install GNU gettext from <ftp://ftp.gnu.org/gnu/gettext/> and
- re-configure Bison. See the file "ABOUT-NLS" for more
- information.
-
-----------------------------------------------------------------------
-
-Q3. I'm having trouble using Bison. Where can I find help?
-
-A3. First, read the fine manual which comes with bison. Beyond that,
- you can send mail to <help-bison@gnu.org>. This mailing list is
- intended to be populated with people who are willing to answer
- questions about using and installing Bison. Please keep in mind
- that (most of) the people on the list have aspects of their lives
- which are not related to Bison (!), so you may not receive an
- answer to your question right away. This can be frustrating, but
- please try not to honk them off; remember that any help they
- provide is purely voluntary and out of the kindness of their
- hearts.
-
-----------------------------------------------------------------------
-
-Q4. I found a bug. What should I include in the bug report?
-
-A4. Before you send a bug report, make sure you are using the latest
- version. Check <ftp://ftp.gnu.org/pub/gnu/bison/> or one of its
- mirrors. Be sure to include the version number in your bug
- report. If the bug is present in the latest version but not in a
- previous version, try to determine the most recent version which
- did not contain the bug.
-
- If the bug is parser-related, you should include the smallest
- grammar you can which demonstrates the bug. The grammar file
- should also be complete (i.e., I should be able to run it through
- Bison without having to edit or add anything). The smaller and
- simpler the grammar, the easier it will be to fix the bug.
-
- Include information about your compilation environment, including
- your operating system's name and version and your compiler's name
- and version. If you have trouble compiling, you should also
- include a transcript of the build session, starting with the
- invocation of `configure'. Depending on the nature of the bug,
- you may be asked to send additional files as well (such as
- `config.h' or `config.cache').
-
- Patches are most welcome, but not required. That is, do not
- hesitate to send a bug report just because you can not provide a
- fix.
-
- Send bug reports to <bug-bison@gnu.org>.
-
-----------------------------------------------------------------------
-
-Q5. Will Bison ever have C++ support? How about Java or
- <insert your favorite language here>?
-
-A5. C++ support is there now, and is documented in the manual.
- We'd love to add other languages; contributions are welcome.
-
-----------------------------------------------------------------------
-
-Q6. What is involved in being a beta tester?
-
-A6. It's not terribly involved. Basically, you would download a test
- release, compile it, and use it to build and run a parser or two.
- After that, you would submit either a bug report or a message
- saying that everything is okay. It is important to report
- successes as well as failures because test releases eventually
- become mainstream releases, but only if they are adequately
- tested. If no one tests, development is essentially halted.
-
- Beta testers are particularly needed for operating systems to
- which the developers do not have easy access. They currently
- have easy access to recent GNU/Linux and Solaris versions.
- Reports about other operating systems are especially welcome.
-
-----------------------------------------------------------------------
-
-Q7. How do I join the help-bison and bug-bison mailing lists?
-
-A7. See <http://lists.gnu.org/>.
-
-----------------------------------------------------------------------
-
-Copyright (C) 1999, 2002, 2006 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
-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.
-
-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., 51 Franklin Street, Fifth Floor,
-Boston, MA 02110-1301, USA.
## Process this file with automake to produce Makefile.in -*-Makefile-*-
-## Copyright (C) 2001, 2002, 2003, 2005 Free Software Foundation, Inc.
+## Copyright (C) 2001, 2002, 2003, 2005, 2006 Free Software Foundation, Inc.
## 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
man_MANS = bison.1
bison_TEXINFOS = gpl.texi fdl.texi
-EXTRA_DIST = FAQ bison.1 refcard.tex
+EXTRA_DIST = bison.1 refcard.tex
CLEANFILES = refcard.dvi refcard.log refcard.ps bison.fns
* How Can I Reset the Parser:: @code{yyparse} Keeps some State
* Strings are Destroyed:: @code{yylval} Loses Track of Strings
* Implementing Gotos/Loops:: Control Flow in the Calculator
+* Secure? Conform?:: Is Bison @acronym{POSIX} safe?
+* I can't build Bison:: Troubleshooting
+* Where can I find help?:: Troubleshouting
+* Bug Reports:: Troublereporting
+* Other Languages:: Parsers in Java and others
+* Beta Testing:: Experimenting development versions
+* Mailing Lists:: Meeting other Bison users
Copying This Manual
are addressed.
@menu
-* Memory Exhausted:: Breaking the Stack Limits
-* How Can I Reset the Parser:: @code{yyparse} Keeps some State
-* Strings are Destroyed:: @code{yylval} Loses Track of Strings
-* Implementing Gotos/Loops:: Control Flow in the Calculator
+* Memory Exhausted:: Breaking the Stack Limits
+* How Can I Reset the Parser:: @code{yyparse} Keeps some State
+* Strings are Destroyed:: @code{yylval} Loses Track of Strings
+* Implementing Gotos/Loops:: Control Flow in the Calculator
+* Secure? Conform?:: Is Bison @acronym{POSIX} safe?
+* I can't build Bison:: Troubleshooting
+* Where can I find help?:: Troubleshouting
+* Bug Reports:: Troublereporting
+* Other Languages:: Parsers in Java and others
+* Beta Testing:: Experimenting development versions
+* Mailing Lists:: Meeting other Bison users
@end menu
@node Memory Exhausted
invited to consult the dedicated literature.
+@node Secure? Conform?
+@section Secure? Conform?
+
+@display
+Is Bison secure? Does it conform to POSIX?
+@end display
+
+If you're looking for a guarantee or certification, we don't provide it.
+However, Bison is intended to be a reliable program that conforms to the
+@acronym{POSIX} specification for Yacc. If you run into problems,
+please send us a bug report.
+
+@node I can't build Bison
+@section I can't build Bison
+
+@display
+I can't build Bison because "make" complains that "msgfmt" is not found.
+What should I do?
+@end display
+
+Like most GNU packages with internationalization support, that feature
+is turned on by default. If you have problems building in the @file{po}
+subdirectory, it indicates that your system's internationalization
+support is lacking. You can re-configure Bison with
+@option{--disable-nls} to turn off this support, or you can install GNU
+gettext from @url{ftp://ftp.gnu.org/gnu/gettext/} and re-configure
+Bison. See the file @file{ABOUT-NLS} for more information.
+
+
+@node Where can I find help?
+@section Where can I find help?
+
+@display
+I'm having trouble using Bison. Where can I find help?
+@end display
+
+First, read this fine manual. Beyond that, you can send mail to
+@email{help-bison@@gnu.org}. This mailing list is intended to be
+populated with people who are willing to answer questions about using
+and installing Bison. Please keep in mind that (most of) the people on
+the list have aspects of their lives which are not related to Bison (!),
+so you may not receive an answer to your question right away. This can
+be frustrating, but please try not to honk them off; remember that any
+help they provide is purely voluntary and out of the kindness of their
+hearts.
+
+@node Bug Reports
+@section Bug Reports
+
+@display
+I found a bug. What should I include in the bug report?
+@end display
+
+Before you send a bug report, make sure you are using the latest
+version. Check @url{ftp://ftp.gnu.org/pub/gnu/bison/} or one of its
+mirrors. Be sure to include the version number in your bug report. If
+the bug is present in the latest version but not in a previous version,
+try to determine the most recent version which did not contain the bug.
+
+If the bug is parser-related, you should include the smallest grammar
+you can which demonstrates the bug. The grammar file should also be
+complete (i.e., I should be able to run it through Bison without having
+to edit or add anything). The smaller and simpler the grammar, the
+easier it will be to fix the bug.
+
+Include information about your compilation environment, including your
+operating system's name and version and your compiler's name and
+version. If you have trouble compiling, you should also include a
+transcript of the build session, starting with the invocation of
+`configure'. Depending on the nature of the bug, you may be asked to
+send additional files as well (such as `config.h' or `config.cache').
+
+Patches are most welcome, but not required. That is, do not hesitate to
+send a bug report just because you can not provide a fix.
+
+Send bug reports to @email{bug-bison@@gnu.org}.
+
+@node Other Languages
+@section Other Languages
+
+@display
+Will Bison ever have C++ support? How about Java or @var{insert your
+favorite language here}?
+@end display
+
+C++ support is there now, and is documented. We'd love to add other
+languages; contributions are welcome.
+
+@node Beta Testing
+@section Beta Testing
+
+@display
+What is involved in being a beta tester?
+@end display
+
+It's not terribly involved. Basically, you would download a test
+release, compile it, and use it to build and run a parser or two. After
+that, you would submit either a bug report or a message saying that
+everything is okay. It is important to report successes as well as
+failures because test releases eventually become mainstream releases,
+but only if they are adequately tested. If no one tests, development is
+essentially halted.
+
+Beta testers are particularly needed for operating systems to which the
+developers do not have easy access. They currently have easy access to
+recent GNU/Linux and Solaris versions. Reports about other operating
+systems are especially welcome.
+
+@node Mailing Lists
+@section Mailing Lists
+
+@display
+How do I join the help-bison and bug-bison mailing lists?
+@end display
+
+See @url{http://lists.gnu.org/}.
@c ================================================= Table of Symbols
projects / bison.git / commitdiff
