bison-patches
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

31-fyi-doc-formatting.patch


From: Akim Demaille
Subject: 31-fyi-doc-formatting.patch
Date: Sat, 29 Dec 2001 15:15:48 +0100

Index: ChangeLog
from  Akim Demaille  <address@hidden>
        * doc/bison.texinfo: Promote `%long-directive' over
        `%long_directive'.
        Remove all references to fixed-output-files, yacc is enough.
        
        
Index: doc/bison.texinfo
--- doc/bison.texinfo Sat, 29 Dec 2001 09:01:10 +0100 akim
+++ doc/bison.texinfo Sat, 29 Dec 2001 13:46:53 +0100 akim
@@ -3163,7 +3163,7 @@ @node Pure Decl
 @subsection A Pure (Reentrant) Parser
 @cindex reentrant parser
 @cindex pure parser
address@hidden %pure_parser
address@hidden %pure-parser
 
 A @dfn{reentrant} program is one which does not alter in the course of
 execution; in other words, it consists entirely of @dfn{pure} (read-only)
@@ -3179,11 +3179,11 @@ @node Pure Decl
 including @code{yylval} and @code{yylloc}.)
 
 Alternatively, you can generate a pure, reentrant parser.  The Bison
-declaration @code{%pure_parser} says that you want the parser to be
+declaration @code{%pure-parser} says that you want the parser to be
 reentrant.  It looks like this:
 
 @example
-%pure_parser
+%pure-parser
 @end example
 
 The result is that the communication variables @code{yylval} and
@@ -3270,12 +3270,12 @@ directives:
 Specify a prefix to use for all Bison output file names.  The names are
 chosen as if the input file were named @address@hidden
 
address@hidden @item %header_extension
address@hidden @item %header-extension
 @c Specify the extension of the parser header file generated when
 @c @code{%define} or @samp{-d} are used.
 @c
 @c For example, a grammar file named @file{foo.ypp} and containing a
address@hidden @code{%header_extension .hh} directive will produce a header file
address@hidden @code{%header-extension .hh} directive will produce a header file
 @c named @file{foo.tab.hh}
 
 @item %locations
@@ -3318,14 +3318,14 @@ directives:
 Request a pure (reentrant) parser program (@pxref{Pure Decl, ,A Pure
 (Reentrant) Parser}).
 
address@hidden @item %source_extension
address@hidden @item %source-extension
 @c Specify the extension of the parser output file.
 @c
 @c For example, a grammar file named @file{foo.yy} and containing a
address@hidden @code{%source_extension .cpp} directive will produce a parser 
file
address@hidden @code{%source-extension .cpp} directive will produce a parser 
file
 @c named @file{foo.tab.cpp}
 
address@hidden %token_table
address@hidden %token-table
 Generate an array of token names in the parser file.  The name of the
 array is @code{yytname}; @address@hidden is the name of the
 token whose internal Bison token code number is @var{i}.  The first three
@@ -3343,7 +3343,7 @@ directives:
 contains @samp{"*"*"}.  (In C, that would be written as
 @code{"\"*\"*\""}).
 
-When you specify @code{%token_table}, Bison also generates macro
+When you specify @code{%token-table}, Bison also generates macro
 definitions for macros @code{YYNTOKENS}, @code{YYNNTS}, and
 @code{YYNRULES}, and @code{YYNSTATES}:
 
@@ -3374,7 +3374,6 @@ directives:
 output file is called @address@hidden
 
 @item %yacc
address@hidden %fixed-output-files
 Pretend the option @option{--yacc} was given, i.e., imitate Yacc,
 including its naming conventions.  @xref{Bison Options}, for more.
 @end table
@@ -3565,7 +3564,7 @@ @node Calling Convention
 @end smallexample
 
 The @code{yytname} table is generated only if you use the
address@hidden declaration.  @xref{Decl Summary}.
address@hidden declaration.  @xref{Decl Summary}.
 @end itemize
 
 @node Token Values
@@ -3639,7 +3638,7 @@ @node Token Positions
 @node Pure Calling
 @subsection Calling Conventions for Pure Parsers
 
-When you use the Bison declaration @code{%pure_parser} to request a
+When you use the Bison declaration @code{%pure-parser} to request a
 pure, reentrant parser, the global communication variables @code{yylval}
 and @code{yylloc} cannot be used.  (@xref{Pure Decl, ,A Pure (Reentrant)
 Parser}.)  In such parsers the two global variables are replaced by
@@ -3739,7 +3738,7 @@ @node Pure Calling
 the proper object type, or you can declare it as @code{void *} and
 access the contents as shown above.
 
-You can use @samp{%pure_parser} to request a reentrant parser without
+You can use @samp{%pure-parser} to request a reentrant parser without
 also using @code{YYPARSE_PARAM}.  Then you should call @code{yyparse}
 with no arguments, as usual.
 
@@ -5096,7 +5095,6 @@ @node Bison Options
 @need 1750
 @item -y
 @itemx --yacc
address@hidden --fixed-output-files
 Equivalent to @samp{-o y.tab.c}; the parser output file is called
 @file{y.tab.c}, and the other outputs are called @file{y.output} and
 @file{y.tab.h}.  The purpose of this option is to imitate Yacc's output
@@ -5209,7 +5207,7 @@ @node Environment Variables
 environment variable @code{BISON_SIMPLE} to the path of the file will
 cause Bison to use that copy instead.
 
-When the @samp{%semantic_parser} declaration is used, Bison copies from
+When the @samp{%semantic-parser} declaration is used, Bison copies from
 a file called @file{bison.hairy} instead.  The location of this file can
 also be specified or overridden in a similar fashion, with the
 @code{BISON_HAIRY} environment variable.
@@ -5229,7 +5227,6 @@ @node Option Cross Key
 \line{ --debug \leaderfill -t}
 \line{ --defines \leaderfill -d}
 \line{ --file-prefix \leaderfill -b}
-\line{ --fixed-output-files \leaderfill -y}
 \line{ --graph \leaderfill -g}
 \line{ --help \leaderfill -h}
 \line{ --name-prefix \leaderfill -p}
@@ -5248,7 +5245,6 @@ @node Option Cross Key
 --debug                               -t
 address@hidden          -d
 address@hidden                  -b @var{file-prefix}
---fixed-output-files --yacc           -y
 address@hidden              -d
 --help                                -h
 address@hidden                  -p @var{name-prefix}
@@ -5258,6 +5254,7 @@ @node Option Cross Key
 --token-table                         -k
 --verbose                             -v
 --version                             -V
+--yacc                                -y
 @end example
 @end ifinfo
 
@@ -5433,11 +5430,11 @@ @node Table of Symbols
 Bison declaration to set tge prefix of the output files. @xref{Decl
 Summary}.
 
address@hidden @item %source_extension
address@hidden @item %source-extension
 @c Bison declaration to specify the generated parser output file extension.
 @c @xref{Decl Summary}.
 @c
address@hidden @item %header_extension
address@hidden @item %header-extension
 @c Bison declaration to specify the generated parser header file extension
 @c if required. @xref{Decl Summary}.
 



reply via email to

[Prev in Thread] Current Thread [Next in Thread]