[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
doc: use @option consistently
From: |
Akim Demaille |
Subject: |
doc: use @option consistently |
Date: |
Sat, 5 Jan 2019 15:07:31 +0100 |
commit e01bba7a3f78a692f3aedd12d765abd703a208ea
Author: Akim Demaille <address@hidden>
Date: Sat Jan 5 15:05:46 2019 +0100
doc: use @option consistently
* doc/bison.texi: Use @option, not @code, for options.
diff --git a/doc/bison.texi b/doc/bison.texi
index a4e3fce3..c66a9746 100644
--- a/doc/bison.texi
+++ b/doc/bison.texi
@@ -10496,36 +10496,36 @@ Tuning the parser:
@table @option
@item -t
@itemx --debug
-In the parser implementation file, define the macro @code{YYDEBUG} to
-1 if it is not already defined, so that the debugging facilities are
-compiled. @xref{Tracing, ,Tracing Your Parser}.
+In the parser implementation file, define the macro @code{YYDEBUG} to 1 if
+it is not already defined, so that the debugging facilities are compiled.
address@hidden, ,Tracing Your Parser}.
@item -D @address@hidden
@itemx address@hidden@var{value}]
@itemx -F @address@hidden
@itemx address@hidden@var{value}]
Each of these is equivalent to @samp{%define @var{name} "@var{value}"}
-(@pxref{%define Summary}) except that Bison processes multiple
-definitions for the same @var{name} as follows:
+(@pxref{%define Summary}) except that Bison processes multiple definitions
+for the same @var{name} as follows:
@itemize
@item
Bison quietly ignores all command-line definitions for @var{name} except
the last.
@item
-If that command-line definition is specified by a @code{-D} or
address@hidden, Bison reports an error for any @code{%define}
-definition for @var{name}.
+If that command-line definition is specified by a @option{-D} or
address@hidden, Bison reports an error for any @code{%define} definition
+for @var{name}.
@item
-If that command-line definition is specified by a @code{-F} or
address@hidden instead, Bison quietly ignores all @code{%define}
+If that command-line definition is specified by a @option{-F} or
address@hidden instead, Bison quietly ignores all @code{%define}
definitions for @var{name}.
@item
Otherwise, Bison reports an error if there are multiple @code{%define}
definitions for @var{name}.
@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
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}
@itemx address@hidden
Pretend that @code{%name-prefix "@var{prefix}"} was specified (@pxref{Decl
-Summary}). Obsoleted by @address@hidden @xref{Multiple
+Summary}). Obsoleted by @address@hidden @xref{Multiple
Parsers, ,Multiple Parsers in the Same Program}.
@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}.
@item -d
-This is the same as @code{--defines} except @code{-d} does not accept a
address@hidden argument since POSIX Yacc requires that @code{-d} can be bundled
+This is the same as @option{--defines} except @option{-d} does not accept a
address@hidden argument since POSIX Yacc requires that @option{-d} can be
bundled
with other short options.
@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
(@code{#if}) and disabled when exceptions are not supported (i.e., passing
address@hidden to the C++ compiler).
address@hidden to the C++ compiler).
@end deftypemethod
@deftypemethod {parser} {std::ostream&} debug_stream ()
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- doc: use @option consistently,
Akim Demaille <=