mirror of
https://git.savannah.gnu.org/git/bison.git
synced 2026-03-09 12:23:04 +00:00
111 lines
3.9 KiB
Plaintext
111 lines
3.9 KiB
Plaintext
This package contains the GNU Bison parser generator.
|
|
|
|
# Installation
|
|
## Build from git
|
|
Here are basic installation instructions for a repository checkout:
|
|
|
|
$ git submodule update --init
|
|
$ ./bootstrap
|
|
|
|
then proceed with the usual `configure && make` steps.
|
|
|
|
The file README-hacking.md is about building, modifying and checking Bison.
|
|
|
|
## Build from tarball
|
|
See the file INSTALL for generic compilation and installation instructions.
|
|
|
|
Bison requires GNU m4 1.4.6 or later. See
|
|
https://ftp.gnu.org/gnu/m4/m4-1.4.6.tar.gz.
|
|
|
|
## Colored diagnostics
|
|
As an experimental feature, diagnostics are now colored, controlled by the
|
|
`--color` and `--style` options.
|
|
|
|
To use them, install the libtextstyle library before configuring Bison. It
|
|
is available from https://alpha.gnu.org/gnu/gettext/, for instance
|
|
https://alpha.gnu.org/gnu/gettext/libtextstyle-0.8.tar.gz.
|
|
|
|
The option --color supports the following arguments:
|
|
- always, yes: Enable colors.
|
|
- never, no: Disable colors.
|
|
- auto, tty (default): Enable colors if the output device is a tty.
|
|
|
|
To customize the styles, create a CSS file, say `bison-bw.css`, similar to
|
|
|
|
/* bison-bw.css */
|
|
.warning { }
|
|
.error { font-weight: 800; text-decoration: underline; }
|
|
.note { }
|
|
|
|
then invoke bison with `--style=bison-bw.css`, or set the `BISON_STYLE`
|
|
environment variable to `bison-bw.css`.
|
|
|
|
## Relocatability
|
|
If you pass `--enable-relocatable` to `configure`, Bison is relocatable.
|
|
|
|
A relocatable program can be moved or copied to a different location on the
|
|
file system. It can also be used through mount points for network sharing.
|
|
It is possible to make symlinks to the installed and moved programs, and
|
|
invoke them through the symlink.
|
|
|
|
See "Enabling Relocatability" in the documentation.
|
|
|
|
## Internationalization
|
|
Bison supports two catalogs: 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 <help-bison@gnu.org>.
|
|
|
|
# Bug reports
|
|
Please send bug reports to <bug-bison@gnu.org>. Be sure to include the
|
|
version number from `bison --version`, and a complete, self-contained test
|
|
case in each bug report.
|
|
|
|
# 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.
|
|
|
|
<!--
|
|
|
|
Copyright (C) 1992, 1998-1999, 2003-2005, 2008-2015, 2018-2019 Free
|
|
Software Foundation, Inc.
|
|
|
|
This file is part of GNU bison, the GNU Compiler Compiler.
|
|
|
|
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 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
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 this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
Local Variables:
|
|
mode: markdown
|
|
fill-column: 76
|
|
ispell-dictionary: "american"
|
|
End:
|
|
|
|
LocalWords: parsers ngettext Texinfo pdf html YYYY ZZZZ ispell american
|
|
LocalWords: MERCHANTABILITY
|
|
|
|
-->
|