Re: [PATCH] master: doc: comment changes.

[Joel E. Denny]

On Wed, 16 Sep 2009, Akim Demaille wrote:

>       * doc/bison.texinfo: Comment changes.

> address@hidden ================================================== 
> lr.default-reductions
> +
>  @item lr.default-reductions
>  @cindex default reductions
>  @findex %define lr.default-reductions
> @@ -5074,6 +5079,8 @@ without performing any extra reductions.
>  @end itemize
>  @end itemize
>  
> address@hidden ============================================ 
> lr.keep-unreachable-states
> +
>  @item lr.keep-unreachable-states
>  @findex %define lr.keep-unreachable-states
>  
> @@ -5118,6 +5125,8 @@ However, Bison does not compute which goto actions are 
> useless.
>  @end itemize
>  @c lr.keep-unreachable-states
>  
> address@hidden ================================================== lr.type
> +
>  @item lr.type
>  @findex %define lr.type
>  @cindex @acronym{LALR}

I cherry-picked that to branch-2.5 in order to avoid conflicts whenever I 
get around to working more on this documentation.

I included the following changes.  I'm not an emacs user, but I assume 
these are reasonable in branch-2.5.

> @@ -10837,32 +10846,55 @@ grammatically indivisible.  The piece of text it 
> represents is a token.
>  @c fill-column: 76
>  @c End:
>  
> address@hidden LocalWords: texinfo setfilename settitle setchapternewpage 
> finalout
> address@hidden LocalWords: ifinfo smallbook shorttitlepage titlepage GPL 
> FIXME iftex
> address@hidden LocalWords: akim fn cp syncodeindex vr tp synindex dircategory 
> direntry
> address@hidden LocalWords: ifset vskip pt filll insertcopying sp ISBN Etienne 
> Suvasa
> address@hidden LocalWords: ifnottex yyparse detailmenu GLR RPN Calc var Decls 
> Rpcalc
> address@hidden LocalWords: rpcalc Lexer Expr ltcalc mfcalc yylex
> address@hidden LocalWords: yyerror pxref LR yylval cindex dfn LALR samp gpl 
> BNF xref
> address@hidden LocalWords: const int paren ifnotinfo AC noindent emph expr 
> stmt findex
> address@hidden LocalWords: glr YYSTYPE TYPENAME prog dprec printf decl init 
> stmtMerge
> address@hidden LocalWords: pre STDC GNUC endif yy YY alloca lf stddef stdlib 
> YYDEBUG
> address@hidden LocalWords: NUM exp subsubsection kbd Ctrl ctype EOF getchar 
> isdigit
> address@hidden LocalWords: ungetc stdin scanf sc calc ulator ls lm cc NEG 
> prec yyerrok
> address@hidden LocalWords: longjmp fprintf stderr yylloc YYLTYPE cos ln
> address@hidden LocalWords: smallexample symrec val tptr FNCT fnctptr func 
> struct sym
> address@hidden LocalWords: fnct putsym getsym fname arith fncts atan ptr 
> malloc sizeof
> address@hidden LocalWords: strlen strcpy fctn strcmp isalpha symbuf realloc 
> isalnum
> address@hidden LocalWords: ptypes itype YYPRINT trigraphs yytname expseq 
> vindex dtype
> address@hidden LocalWords: Rhs YYRHSLOC LE nonassoc op deffn typeless yynerrs
> address@hidden LocalWords: yychar yydebug msg YYNTOKENS YYNNTS YYNRULES 
> YYNSTATES
> address@hidden LocalWords: cparse clex deftypefun NE defmac YYACCEPT YYABORT 
> param
> address@hidden LocalWords: strncmp intval tindex lvalp locp llocp typealt 
> YYBACKUP
> address@hidden LocalWords: YYEMPTY YYEOF YYRECOVERING yyclearin GE def UMINUS 
> maybeword
> address@hidden LocalWords: Johnstone Shamsa Sadaf Hussain Tomita TR uref 
> YYMAXDEPTH
> address@hidden LocalWords: YYINITDEPTH stmnts ref stmnt initdcl maybeasm 
> notype
> address@hidden LocalWords: hexflag STR exdent itemset asis DYYDEBUG YYFPRINTF 
> args
> address@hidden LocalWords: infile ypp yxx outfile itemx tex leaderfill
> address@hidden LocalWords: hbox hss hfill tt ly yyin fopen fclose ofirst gcc 
> ll
> address@hidden LocalWords: nbar yytext fst snd osplit ntwo strdup AST
> address@hidden LocalWords: YYSTACK DVI fdl printindex IELR
> address@hidden LocalWords: texinfo setfilename settitle setchapternewpage 
> finalout texi FSF
> address@hidden LocalWords: ifinfo smallbook shorttitlepage titlepage GPL 
> FIXME iftex FSF's
> address@hidden LocalWords: akim fn cp syncodeindex vr tp synindex dircategory 
> direntry Naur
> address@hidden LocalWords: ifset vskip pt filll insertcopying sp ISBN Etienne 
> Suvasa Multi
> address@hidden LocalWords: ifnottex yyparse detailmenu GLR RPN Calc var Decls 
> Rpcalc multi
> address@hidden LocalWords: rpcalc Lexer Expr ltcalc mfcalc yylex defaultprec 
> Donnelly Gotos
> address@hidden LocalWords: yyerror pxref LR yylval cindex dfn LALR samp gpl 
> BNF xref yypush
> address@hidden LocalWords: const int paren ifnotinfo AC noindent emph expr 
> stmt findex lr
> address@hidden LocalWords: glr YYSTYPE TYPENAME prog dprec printf decl init 
> stmtMerge POSIX
> address@hidden LocalWords: pre STDC GNUC endif yy YY alloca lf stddef stdlib 
> YYDEBUG yypull
> address@hidden LocalWords: NUM exp subsubsection kbd Ctrl ctype EOF getchar 
> isdigit nonfree
> address@hidden LocalWords: ungetc stdin scanf sc calc ulator ls lm cc NEG 
> prec yyerrok rr
> address@hidden LocalWords: longjmp fprintf stderr yylloc YYLTYPE cos ln 
> Stallman Destructor
> address@hidden LocalWords: smallexample symrec val tptr FNCT fnctptr func 
> struct sym enum
> address@hidden LocalWords: fnct putsym getsym fname arith fncts atan ptr 
> malloc sizeof Lex
> address@hidden LocalWords: strlen strcpy fctn strcmp isalpha symbuf realloc 
> isalnum DOTDOT
> address@hidden LocalWords: ptypes itype YYPRINT trigraphs yytname expseq 
> vindex dtype Unary
> address@hidden LocalWords: Rhs YYRHSLOC LE nonassoc op deffn typeless yynerrs 
> nonterminal
> address@hidden LocalWords: yychar yydebug msg YYNTOKENS YYNNTS YYNRULES 
> YYNSTATES reentrant
> address@hidden LocalWords: cparse clex deftypefun NE defmac YYACCEPT YYABORT 
> param yypstate
> address@hidden LocalWords: strncmp intval tindex lvalp locp llocp typealt 
> YYBACKUP subrange
> address@hidden LocalWords: YYEMPTY YYEOF YYRECOVERING yyclearin GE def UMINUS 
> maybeword loc
> address@hidden LocalWords: Johnstone Shamsa Sadaf Hussain Tomita TR uref 
> YYMAXDEPTH inline
> address@hidden LocalWords: YYINITDEPTH stmnts ref stmnt initdcl maybeasm 
> notype Lookahead
> address@hidden LocalWords: hexflag STR exdent itemset asis DYYDEBUG YYFPRINTF 
> args Autoconf
> address@hidden LocalWords: infile ypp yxx outfile itemx tex leaderfill 
> Troubleshouting sqrt
> address@hidden LocalWords: hbox hss hfill tt ly yyin fopen fclose ofirst gcc 
> ll lookahead
> address@hidden LocalWords: nbar yytext fst snd osplit ntwo strdup AST 
> Troublereporting th
> address@hidden LocalWords: YYSTACK DVI fdl printindex IELR nondeterministic 
> nonterminals ps
> address@hidden LocalWords: subexpressions declarator nondeferred config 
> libintl postfix
> address@hidden LocalWords: preprocessor nonpositive unary nonnumeric typedef 
> extern rhs
> address@hidden LocalWords: yytokentype filename destructor multicharacter 
> nonnull EBCDIC
> address@hidden LocalWords: lvalue nonnegative XNUM CHR chr TAGLESS tagless 
> stdout api TOK
> address@hidden LocalWords: destructors Reentrancy nonreentrant subgrammar 
> nonassociative
> address@hidden LocalWords: deffnx namespace xml goto lalr ielr runtime lex 
> yacc yyps env
> address@hidden LocalWords: yystate variadic Unshift NLS gettext po UTF 
> Automake LOCALEDIR
> address@hidden LocalWords: YYENABLE bindtextdomain Makefile DEFS CPPFLAGS 
> DBISON DeRemer
> address@hidden LocalWords: autoreconf Pennello multisets nondeterminism 
> Generalised baz
> address@hidden LocalWords: redeclare automata Dparse localedir datadir XSLT 
> midrule Wno
> address@hidden LocalWords: makefiles Graphviz multitable headitem hh basename 
> Doxygen fno
> address@hidden LocalWords: doxygen ival sval deftypemethod deallocate pos 
> deftypemethodx
> address@hidden LocalWords: Ctor defcv defcvx arg accessors arithmetics CPP 
> ifndef CALCXX
> address@hidden LocalWords: lexer's calcxx bool LPAREN RPAREN deallocation 
> cerrno climits
> address@hidden LocalWords: cstdlib Debian undef yywrap unput noyywrap nounput 
> zA yyleng
> address@hidden LocalWords: errno strtol ERANGE str strerror iostream argc 
> argv Javadoc
> address@hidden LocalWords: bytecode initializers superclass stype ASTNode 
> autoboxing nls
> address@hidden LocalWords: toString deftypeivar deftypeivarx deftypeop 
> YYParser strictfp
> address@hidden LocalWords: superclasses boolean getErrorVerbose 
> setErrorVerbose deftypecv
> address@hidden LocalWords: getDebugStream setDebugStream getDebugLevel 
> setDebugLevel url
> address@hidden LocalWords: bisonVersion deftypecvx bisonSkeleton getStartPos 
> getEndPos
> address@hidden LocalWords: getLVal defvar YYFAIL deftypefn deftypefnx gotos 
> msgfmt
> address@hidden LocalWords: subdirectory Solaris nonassociativity
> -- 
> 1.6.4.3