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

doc: fix inaccuracies wrt --define and --force-define

Browse Source 
The doc says that -Dfoo=bar is the same as %define foo "bar".  It is
not: the quotes are not added (and it makes a difference).

* doc/bison.texi (Tuning the Parser): Fix the definition of -D/-F
* src/getargs.c (usage): Likewise.
This commit is contained in:
Akim Demaille
2019-07-06 09:09:51 +02:00
parent 964c6508b1
commit d90023af5f
2 changed files with 11 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
doc/bison.texi
View File

@@ -10694,9 +10694,14 @@ it is not already defined, so that the debugging facilities are compiled.
@itemx --define=@var{name}[=@var{value}] @itemx --define=@var{name}[=@var{value}]
@itemx -F @var{name}[=@var{value}] @itemx -F @var{name}[=@var{value}]
@itemx --force-define=@var{name}[=@var{value}] @itemx --force-define=@var{name}[=@var{value}]
Each of these is equivalent to @samp{%define @var{name} "@var{value}"} Each of these is equivalent to @samp{%define @var{name} @var{value}}
(@pxref{%define Summary}) except that Bison processes multiple definitions (@pxref{%define Summary}). Note that the delimiters are part of
for the same @var{name} as follows: @var{value}: @option{-Dapi.value.type=union},
@option{-Dapi.value.type=@{union@}} and @option{-Dapi.value.type="union"}
correspond to @samp{%define api.value.type union}, @samp{%define
api.value.type @{union@}} and @samp{%define api.value.type "union"}.
Bison processes multiple definitions for the same @var{name} as follows:
@itemize @itemize
@item @item

6
src/getargs.c
View File

@@ -404,10 +404,10 @@ Tuning the Parser:\n\
-t, --debug instrument the parser for tracing\n\ -t, --debug instrument the parser for tracing\n\
same as '-Dparse.trace'\n\ same as '-Dparse.trace'\n\
--locations enable location support\n\ --locations enable location support\n\
-D, --define=NAME[=VALUE] similar to '%define NAME \"VALUE\"'\n\ -D, --define=NAME[=VALUE] similar to '%define NAME VALUE'\n\
-F, --force-define=NAME[=VALUE] override '%define NAME \"VALUE\"'\n\ -F, --force-define=NAME[=VALUE] override '%define NAME VALUE'\n\
-p, --name-prefix=PREFIX prepend PREFIX to the external symbols\n\ -p, --name-prefix=PREFIX prepend PREFIX to the external symbols\n\
deprecated by '-Dapi.prefix=PREFIX'\n\ deprecated by '-Dapi.prefix={PREFIX}'\n\
-l, --no-lines don't generate '#line' directives\n\ -l, --no-lines don't generate '#line' directives\n\
-k, --token-table include a table of token names\n\ -k, --token-table include a table of token names\n\
-y, --yacc emulate POSIX Yacc\n\ -y, --yacc emulate POSIX Yacc\n\