Future/bison
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/bison.git synced 2026-03-09 12:23:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc: document older compiler issues

Browse Source 
* doc/bison.texi (Compiler Requirements for GLR):
Rename from Compiler Requirements.
(I can't build Bison): Add FAQ for older compilers.
This commit is contained in:
Paul Eggert
2018-09-18 13:16:59 -07:00
parent a60a9e3071
commit f475105c2f
1 changed files with 16 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
doc/bison.texi
View File

@@ -137,7 +137,7 @@ Writing GLR Parsers
* Merging GLR Parses:: Using GLR parsers to resolve ambiguities. * Merging GLR Parses:: Using GLR parsers to resolve ambiguities.
* GLR Semantic Actions:: Considerations for semantic values and deferred actions. * GLR Semantic Actions:: Considerations for semantic values and deferred actions.
* Semantic Predicates:: Controlling a parse with arbitrary computations. * Semantic Predicates:: Controlling a parse with arbitrary computations.
* Compiler Requirements:: GLR parsers require a modern C compiler. * Compiler Requirements for GLR:: GLR parsers require a modern C compiler.
Examples Examples
@@ -795,7 +795,7 @@ merged result.
* Merging GLR Parses:: Using GLR parsers to resolve ambiguities. * Merging GLR Parses:: Using GLR parsers to resolve ambiguities.
* GLR Semantic Actions:: Considerations for semantic values and deferred actions. * GLR Semantic Actions:: Considerations for semantic values and deferred actions.
* Semantic Predicates:: Controlling a parse with arbitrary computations. * Semantic Predicates:: Controlling a parse with arbitrary computations.
* Compiler Requirements:: GLR parsers require a modern C compiler. * Compiler Requirements for GLR:: GLR parsers require a modern C compiler.
@end menu @end menu
@node Simple GLR Parsers @node Simple GLR Parsers
@@ -1276,7 +1276,7 @@ reports an error.
Finally, be careful in writing predicates: deferred actions have not been Finally, be careful in writing predicates: deferred actions have not been
evaluated, so that using them in a predicate will have undefined effects. evaluated, so that using them in a predicate will have undefined effects.
@node Compiler Requirements @node Compiler Requirements for GLR
@subsection Considerations when Compiling GLR Parsers @subsection Considerations when Compiling GLR Parsers
@cindex @code{inline} @cindex @code{inline}
@cindex GLR parsers and @code{inline} @cindex GLR parsers and @code{inline}
@@ -7188,7 +7188,7 @@ cp /usr/local/share/aclocal/bison-i18n.m4 m4/bison-i18n.m4
In the top-level @file{configure.ac}, after the @code{AM_GNU_GETTEXT} In the top-level @file{configure.ac}, after the @code{AM_GNU_GETTEXT}
invocation, add an invocation of @code{BISON_I18N}. This macro is invocation, add an invocation of @code{BISON_I18N}. This macro is
defined in the file @file{bison-i18n.m4} that you copied earlier. It defined in the file @file{bison-i18n.m4} that you copied earlier. It
causes @samp{configure} to find the value of the causes @code{configure} to find the value of the
@code{BISON_LOCALEDIR} variable, and it defines the source-language @code{BISON_LOCALEDIR} variable, and it defines the source-language
symbol @code{YYENABLE_NLS} to enable translations in the symbol @code{YYENABLE_NLS} to enable translations in the
Bison-generated parser. Bison-generated parser.
@@ -12597,6 +12597,17 @@ support is lacking. You can re-configure Bison with
gettext from @url{https://ftp.gnu.org/gnu/gettext/} and re-configure gettext from @url{https://ftp.gnu.org/gnu/gettext/} and re-configure
Bison. See the file @file{ABOUT-NLS} for more information. Bison. See the file @file{ABOUT-NLS} for more information.
@quotation
I can't build Bison because my C compiler is too old.
@end quotation
Except for GLR parsers (@pxref{Compiler Requirements for GLR}), the C
code that Bison generates requires only C89 or later. However, Bison
itself requires common C99 features such as declarations after
statements. Bison's @code{configure} script attempts to enable C99 (or
later) support on compilers that default to pre-C99. If your compiler
lacks these C99 features entirely, GCC may well be a better choice; or
you can try upgrading to your compiler's latest version.
@node Where can I find help? @node Where can I find help?
@section Where can I find help? @section Where can I find help?
@@ -12638,7 +12649,7 @@ Include information about your compilation environment, including your
operating system's name and version and your compiler's name and operating system's name and version and your compiler's name and
version. If you have trouble compiling, you should also include a version. If you have trouble compiling, you should also include a
transcript of the build session, starting with the invocation of transcript of the build session, starting with the invocation of
`configure'. Depending on the nature of the bug, you may be asked to @code{configure}. Depending on the nature of the bug, you may be asked to
send additional files as well (such as @file{config.h} or @file{config.cache}). send additional files as well (such as @file{config.h} or @file{config.cache}).
Patches are most welcome, but not required. That is, do not hesitate to Patches are most welcome, but not required. That is, do not hesitate to