mirror of
https://git.savannah.gnu.org/git/bison.git
synced 2026-03-09 04:13:03 +00:00
doc: use @option consistently
* doc/bison.texi: Use @option, not @code, for options.
This commit is contained in:
@@ -10496,36 +10496,36 @@ Tuning the parser:
|
|||||||
@table @option
|
@table @option
|
||||||
@item -t
|
@item -t
|
||||||
@itemx --debug
|
@itemx --debug
|
||||||
In the parser implementation file, define the macro @code{YYDEBUG} to
|
In the parser implementation file, define the macro @code{YYDEBUG} to 1 if
|
||||||
1 if it is not already defined, so that the debugging facilities are
|
it is not already defined, so that the debugging facilities are compiled.
|
||||||
compiled. @xref{Tracing, ,Tracing Your Parser}.
|
@xref{Tracing, ,Tracing Your Parser}.
|
||||||
|
|
||||||
@item -D @var{name}[=@var{value}]
|
@item -D @var{name}[=@var{value}]
|
||||||
@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
|
(@pxref{%define Summary}) except that Bison processes multiple definitions
|
||||||
definitions for the same @var{name} as follows:
|
for the same @var{name} as follows:
|
||||||
|
|
||||||
@itemize
|
@itemize
|
||||||
@item
|
@item
|
||||||
Bison quietly ignores all command-line definitions for @var{name} except
|
Bison quietly ignores all command-line definitions for @var{name} except
|
||||||
the last.
|
the last.
|
||||||
@item
|
@item
|
||||||
If that command-line definition is specified by a @code{-D} or
|
If that command-line definition is specified by a @option{-D} or
|
||||||
@code{--define}, Bison reports an error for any @code{%define}
|
@option{--define}, Bison reports an error for any @code{%define} definition
|
||||||
definition for @var{name}.
|
for @var{name}.
|
||||||
@item
|
@item
|
||||||
If that command-line definition is specified by a @code{-F} or
|
If that command-line definition is specified by a @option{-F} or
|
||||||
@code{--force-define} instead, Bison quietly ignores all @code{%define}
|
@option{--force-define} instead, Bison quietly ignores all @code{%define}
|
||||||
definitions for @var{name}.
|
definitions for @var{name}.
|
||||||
@item
|
@item
|
||||||
Otherwise, Bison reports an error if there are multiple @code{%define}
|
Otherwise, Bison reports an error if there are multiple @code{%define}
|
||||||
definitions for @var{name}.
|
definitions for @var{name}.
|
||||||
@end itemize
|
@end itemize
|
||||||
|
|
||||||
You should avoid using @code{-F} and @code{--force-define} in your
|
You should avoid using @option{-F} and @option{--force-define} in your
|
||||||
make files unless you are confident that it is safe to quietly ignore
|
make files unless you are confident that it is safe to quietly ignore
|
||||||
any conflicting @code{%define} that may be added to the grammar file.
|
any conflicting @code{%define} that may be added to the grammar file.
|
||||||
|
|
||||||
@@ -10542,7 +10542,7 @@ Pretend that @code{%locations} was specified. @xref{Decl Summary}.
|
|||||||
@item -p @var{prefix}
|
@item -p @var{prefix}
|
||||||
@itemx --name-prefix=@var{prefix}
|
@itemx --name-prefix=@var{prefix}
|
||||||
Pretend that @code{%name-prefix "@var{prefix}"} was specified (@pxref{Decl
|
Pretend that @code{%name-prefix "@var{prefix}"} was specified (@pxref{Decl
|
||||||
Summary}). Obsoleted by @code{-Dapi.prefix=@var{prefix}}. @xref{Multiple
|
Summary}). Obsoleted by @option{-Dapi.prefix=@var{prefix}}. @xref{Multiple
|
||||||
Parsers, ,Multiple Parsers in the Same Program}.
|
Parsers, ,Multiple Parsers in the Same Program}.
|
||||||
|
|
||||||
@item -l
|
@item -l
|
||||||
@@ -10585,8 +10585,8 @@ file containing macro definitions for the token type names defined in
|
|||||||
the grammar, as well as a few other declarations. @xref{Decl Summary}.
|
the grammar, as well as a few other declarations. @xref{Decl Summary}.
|
||||||
|
|
||||||
@item -d
|
@item -d
|
||||||
This is the same as @code{--defines} except @code{-d} does not accept a
|
This is the same as @option{--defines} except @option{-d} does not accept a
|
||||||
@var{file} argument since POSIX Yacc requires that @code{-d} can be bundled
|
@var{file} argument since POSIX Yacc requires that @option{-d} can be bundled
|
||||||
with other short options.
|
with other short options.
|
||||||
|
|
||||||
@item -b @var{file-prefix}
|
@item -b @var{file-prefix}
|
||||||
@@ -11038,7 +11038,7 @@ the lookahead symbol, and the symbols pushed on the stack.
|
|||||||
|
|
||||||
Exception related code in the generated parser is protected by CPP guards
|
Exception related code in the generated parser is protected by CPP guards
|
||||||
(@code{#if}) and disabled when exceptions are not supported (i.e., passing
|
(@code{#if}) and disabled when exceptions are not supported (i.e., passing
|
||||||
@code{-fno-exceptions} to the C++ compiler).
|
@option{-fno-exceptions} to the C++ compiler).
|
||||||
@end deftypemethod
|
@end deftypemethod
|
||||||
|
|
||||||
@deftypemethod {parser} {std::ostream&} debug_stream ()
|
@deftypemethod {parser} {std::ostream&} debug_stream ()
|
||||||
|
|||||||
Reference in New Issue
Block a user