06.01.2015 Views

Manual

Manual

Manual

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Chapter 11: Frequently Asked Questions 115<br />

First, read this fine manual. Beyond that, you can send mail to help-bison@gnu.org.<br />

This mailing list is intended to be populated with people who are willing to answer questions<br />

about using and installing Bison. Please keep in mind that (most of) the people on the<br />

list have aspects of their lives which are not related to Bison (!), so you may not receive<br />

an answer to your question right away. This can be frustrating, but please try not to honk<br />

them off; remember that any help they provide is purely voluntary and out of the kindness<br />

of their hearts.<br />

11.9 Bug Reports<br />

I found a bug. What should I include in the bug report<br />

Before you send a bug report, make sure you are using the latest version. Check<br />

ftp://ftp.gnu.org/pub/gnu/bison/ or one of its mirrors. Be sure to include the version<br />

number in your bug report. If the bug is present in the latest version but not in a<br />

previous version, try to determine the most recent version which did not contain the bug.<br />

If the bug is parser-related, you should include the smallest grammar you can which<br />

demonstrates the bug. The grammar file should also be complete (i.e., I should be able to<br />

run it through Bison without having to edit or add anything). The smaller and simpler the<br />

grammar, the easier it will be to fix the bug.<br />

Include information about your compilation environment, including your operating system’s<br />

name and version and your compiler’s name and version. If you have trouble compiling,<br />

you should also include a transcript of the build session, starting with the invocation<br />

of ‘configure’. Depending on the nature of the bug, you may be asked to send additional<br />

files as well (such as ‘config.h’ or ‘config.cache’).<br />

Patches are most welcome, but not required. That is, do not hesitate to send a bug<br />

report just because you can not provide a fix.<br />

Send bug reports to bug-bison@gnu.org.<br />

11.10 Other Languages<br />

Will Bison ever have C++ support How about Java or insert your<br />

favorite language here<br />

C++ support is there now, and is documented. We’d love to add other languages; contributions<br />

are welcome.<br />

11.11 Beta Testing<br />

What is involved in being a beta tester<br />

It’s not terribly involved. Basically, you would download a test release, compile it, and<br />

use it to build and run a parser or two. After that, you would submit either a bug report<br />

or a message saying that everything is okay. It is important to report successes as well as<br />

failures because test releases eventually become mainstream releases, but only if they are<br />

adequately tested. If no one tests, development is essentially halted.<br />

Beta testers are particularly needed for operating systems to which the developers do<br />

not have easy access. They currently have easy access to recent GNU/Linux and Solaris<br />

versions. Reports about other operating systems are especially welcome.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!