* etc/README: Rename/reformat as... * etc/README.md: this. And ship it. --- NEWS | 102 ++++++++++++++++++++++------------------------ README | 20 ++++----- README-hacking.md | 3 ++ TODO | 18 +++----- etc/README | 38 ----------------- etc/README.md | 36 ++++++++++++++++ etc/local.mk | 3 +- 7 files changed, 105 insertions(+), 115 deletions(-) delete mode 100644 etc/README create mode 100644 etc/README.md
diff --git a/NEWS b/NEWS index 60587f7f..a715694c 100644 --- a/NEWS +++ b/NEWS @@ -4206,63 +4206,57 @@ Output file does not redefine const for C++. ----- -Copyright (C) 1995-2015, 2018-2020 Free Software Foundation, Inc. - -This file is part of Bison, the GNU Parser Generator. - -This program is free software: you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation, either version 3 of the License, or -(at your option) any later version. - -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details. - -You should have received a copy of the GNU General Public License -along with this program. If not, see <http://www.gnu.org/licenses/>. - - LocalWords: yacc YYBACKUP glr GCC lalr ArrayIndexOutOfBoundsException nullptr - LocalWords: cplusplus liby rpl fprintf mfcalc Wyacc stmt cond expr mk sym lr - LocalWords: IELR ielr Lookahead YYERROR nonassoc LALR's api lookaheads yychar - LocalWords: destructor lookahead YYRHSLOC YYLLOC Rhs ifndef YYFAIL cpp sr rr - LocalWords: preprocessor initializer Wno Wnone Werror FreeBSD prec livelocks - LocalWords: Solaris AIX UX RHEL Tru LHS gcc's Wundef YYENABLE NLS YYLTYPE VCG - LocalWords: yyerror cpp's Wunused yylval yylloc prepend yyparse yylex yypush - LocalWords: Graphviz xml nonterminals midrule destructor's YYSTYPE typedef ly - LocalWords: CHR chr printf stdout namespace preprocessing enum pre include's - LocalWords: YYRECOVERING nonfree destructors YYABORT YYACCEPT params enums de - LocalWords: struct yystype DJGPP lex param Haible NUM alloca YYSTACK NUL goto - LocalWords: YYMAXDEPTH Unescaped UCNs YYLTYPE's yyltype typedefs inline Yaccs - LocalWords: Heriyanto Reenable dprec Hilfinger Eggert MYEOF Folle Menezes EOF - LocalWords: Lackovic define's itemset Groff Gettext malloc NEWS'ed YYDEBUG YY - LocalWords: namespaces strerror const autoconfiguration Dconst Autoconf's FDL - LocalWords: Automake TMPDIR LESSEQ ylwrap endif yydebug YYTOKEN YYLSP ival hh - LocalWords: extern YYTOKENTYPE TOKENTYPE yytokentype tokentype STYPE lval pdf - LocalWords: lang yyoutput dvi html ps POSIX lvalp llocp Wother nterm arg init - LocalWords: TOK calc yyo fval Wconflicts parsers yystackp yyval yynerrs - LocalWords: Théophile Ranquet Santet fno fnone stype associativity Tolmer - LocalWords: Wprecedence Rassoul Wempty Paolo Bonzini parser's Michiel loc - LocalWords: redeclaration sval fcaret reentrant XSLT xsl Wmaybe yyvsp Tedi - LocalWords: pragmas noreturn untyped Rozenman unexpanded Wojciech Polak - LocalWords: Alexandre MERCHANTABILITY yytype emplace ptr automove lvalues - LocalWords: nonterminal yy args Pragma dereference yyformat rhs docdir bw - LocalWords: Redeclarations rpcalc Autoconf YFLAGS Makefiles PROG DECL num - LocalWords: Heimbigner AST src ast Makefile srcdir MinGW xxlex XXSTYPE - LocalWords: XXLTYPE strictfp IDEs ffixit fdiagnostics parseable fixits - LocalWords: Wdeprecated yytext Variadic variadic yyrhs yyphrs RCS README - LocalWords: noexcept constexpr ispell american deprecations backend Teoh - LocalWords: YYPRINT Mangold Bonzini's Wdangling exVal baz checkable gcc - LocalWords: fsanitize Vogelsgesang lis redeclared stdint automata yytname - LocalWords: yysymbol yytnamerr yyreport ctx ARGMAX yysyntax stderr LPAREN - LocalWords: symrec yypcontext TOKENMAX yyexpected YYEMPTY yypstate YYEOF - LocalWords: autocompletion bistromathic submessages Cayuela lexcalc hoc - LocalWords: yytoken YYUNDEF YYerror basename Automake's UTF ifdef ffile - LocalWords: gotos readline +LocalWords: yacc YYBACKUP glr GCC lalr ArrayIndexOutOfBoundsException nullptr +LocalWords: cplusplus liby rpl fprintf mfcalc Wyacc stmt cond expr mk sym lr +LocalWords: IELR ielr Lookahead YYERROR nonassoc LALR's api lookaheads yychar +LocalWords: destructor lookahead YYRHSLOC YYLLOC Rhs ifndef YYFAIL cpp sr rr +LocalWords: preprocessor initializer Wno Wnone Werror FreeBSD prec livelocks +LocalWords: Solaris AIX UX RHEL Tru LHS gcc's Wundef YYENABLE NLS YYLTYPE VCG +LocalWords: yyerror cpp's Wunused yylval yylloc prepend yyparse yylex yypush +LocalWords: Graphviz xml nonterminals midrule destructor's YYSTYPE typedef ly +LocalWords: CHR chr printf stdout namespace preprocessing enum pre include's +LocalWords: YYRECOVERING nonfree destructors YYABORT YYACCEPT params enums de +LocalWords: struct yystype DJGPP lex param Haible NUM alloca YYSTACK NUL goto +LocalWords: YYMAXDEPTH Unescaped UCNs YYLTYPE's yyltype typedefs inline Yaccs +LocalWords: Heriyanto Reenable dprec Hilfinger Eggert MYEOF Folle Menezes EOF +LocalWords: Lackovic define's itemset Groff Gettext malloc NEWS'ed YYDEBUG YY +LocalWords: namespaces strerror const autoconfiguration Dconst Autoconf's FDL +LocalWords: Automake TMPDIR LESSEQ ylwrap endif yydebug YYTOKEN YYLSP ival hh +LocalWords: extern YYTOKENTYPE TOKENTYPE yytokentype tokentype STYPE lval pdf +LocalWords: lang yyoutput dvi html ps POSIX lvalp llocp Wother nterm arg init +LocalWords: TOK calc yyo fval Wconflicts parsers yystackp yyval yynerrs +LocalWords: Théophile Ranquet Santet fno fnone stype associativity Tolmer +LocalWords: Wprecedence Rassoul Wempty Paolo Bonzini parser's Michiel loc +LocalWords: redeclaration sval fcaret reentrant XSLT xsl Wmaybe yyvsp Tedi +LocalWords: pragmas noreturn untyped Rozenman unexpanded Wojciech Polak +LocalWords: Alexandre MERCHANTABILITY yytype emplace ptr automove lvalues +LocalWords: nonterminal yy args Pragma dereference yyformat rhs docdir bw +LocalWords: Redeclarations rpcalc Autoconf YFLAGS Makefiles PROG DECL num +LocalWords: Heimbigner AST src ast Makefile srcdir MinGW xxlex XXSTYPE +LocalWords: XXLTYPE strictfp IDEs ffixit fdiagnostics parseable fixits +LocalWords: Wdeprecated yytext Variadic variadic yyrhs yyphrs RCS README +LocalWords: noexcept constexpr ispell american deprecations backend Teoh +LocalWords: YYPRINT Mangold Bonzini's Wdangling exVal baz checkable gcc +LocalWords: fsanitize Vogelsgesang lis redeclared stdint automata yytname +LocalWords: yysymbol yytnamerr yyreport ctx ARGMAX yysyntax stderr LPAREN +LocalWords: symrec yypcontext TOKENMAX yyexpected YYEMPTY yypstate YYEOF +LocalWords: autocompletion bistromathic submessages Cayuela lexcalc hoc +LocalWords: yytoken YYUNDEF YYerror basename Automake's UTF ifdef ffile +LocalWords: gotos readline Local Variables: ispell-dictionary: "american" mode: outline fill-column: 76 End: + +Copyright (C) 1995-2015, 2018-2020 Free Software Foundation, Inc. + +This file is part of Bison, the GNU Parser Generator. + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 or +any later version published by the Free Software Foundation; with no +Invariant Sections, with no Front-Cover Texts, and with no Back-Cover +Texts. A copy of the license is included in the "GNU Free +Documentation License" file as part of this distribution. diff --git a/README b/README index 705cbd7d..489caa70 100644 --- a/README +++ b/README @@ -101,6 +101,16 @@ that the range specifies every single year in that closed interval. <!-- +LocalWords: parsers ngettext Texinfo pdf html YYYY ZZZZ ispell american md +LocalWords: MERCHANTABILITY GLR LALR IELR submodule init README src bw +LocalWords: Relocatability symlinks symlink + +Local Variables: +mode: markdown +fill-column: 76 +ispell-dictionary: "american" +End: + Copyright (C) 1992, 1998-1999, 2003-2005, 2008-2015, 2018-2020 Free Software Foundation, Inc. @@ -113,14 +123,4 @@ Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the "GNU Free Documentation License" file as part of this distribution. -Local Variables: -mode: markdown -fill-column: 76 -ispell-dictionary: "american" -End: - -LocalWords: parsers ngettext Texinfo pdf html YYYY ZZZZ ispell american md -LocalWords: MERCHANTABILITY GLR LALR IELR submodule init README src bw -LocalWords: Relocatability symlinks symlink - --> diff --git a/README-hacking.md b/README-hacking.md index 12b1b264..533b5e35 100644 --- a/README-hacking.md +++ b/README-hacking.md @@ -243,6 +243,9 @@ processes tabs in its input. Prefer `res` as the name of the local variable that will be "return"ed by the function. +In writing arithmetic comparisons, use "<" and "<=" rather than ">" and ">=" +(http://www.gelato.unsw.edu.au/archives/git/0505/4507.html). + ### Bison Follow the GNU Coding Standards. diff --git a/TODO b/TODO index f8799078..31734891 100644 --- a/TODO +++ b/TODO @@ -617,15 +617,9 @@ Foundation, Inc. This file is part of Bison, the GNU Compiler Compiler. -This program is free software: you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation, either version 3 of the License, or -(at your option) any later version. - -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details. - -You should have received a copy of the GNU General Public License -along with this program. If not, see <http://www.gnu.org/licenses/>. +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 or +any later version published by the Free Software Foundation; with no +Invariant Sections, with no Front-Cover Texts, and with no Back-Cover +Texts. A copy of the license is included in the "GNU Free +Documentation License" file as part of this distribution. diff --git a/etc/README b/etc/README deleted file mode 100644 index d3122855..00000000 --- a/etc/README +++ /dev/null @@ -1,38 +0,0 @@ -* bench.pl -A primitive Perl script to run benches. Currently its only bench is -the usual calculator: it has a lightweight processing part (but not -null), so it is really emphasizing the cost of the whole parsing -(including scanning and I/O). - -Set the envvars BISON and CC to the programs and flags you want to -use. They default to bison and gcc. To run a non-installed bison -from a tarball built in _build, I suggest the following. - - BISON=_build/tests/bison CC='gcc -O2' ./bench.pl - -(The _build/tests/bison wrapper makes sure that _build/src/bison will -use the tarballs' skeletons, not those already installed as a -straightforward use of _build/src/bison would.) - --- - -Copyright (C) 2006, 2009-2015, 2018-2020 Free Software Foundation, Inc. - -This file is part of Bison, the GNU Compiler Compiler. - -This program is free software: you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation, either version 3 of the License, or -(at your option) any later version. - -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details. - -You should have received a copy of the GNU General Public License -along with this program. If not, see <http://www.gnu.org/licenses/>. - -Local Variables: -mode: outline -End: diff --git a/etc/README.md b/etc/README.md new file mode 100644 index 00000000..c7c67b4a --- /dev/null +++ b/etc/README.md @@ -0,0 +1,36 @@ +# bench.pl +A primitive Perl script to run benches. Currently its only bench is the +usual calculator: it has a lightweight processing part (but not null), so it +is really emphasizing the cost of the whole parsing (including scanning and +I/O). + +Set the envvars `BISON` and `CC` to the programs and flags you want to use. +They default to `bison` and `gcc`. To run a non-installed bison from a +tarball built in _build, I suggest the following. + + BISON=_build/tests/bison CC='gcc -O2' ./bench.pl + +(The `_build/tests/bison` wrapper makes sure that `_build/src/bison` will +use the tarballs' skeletons, not those already installed as a +straightforward use of `_build/src/bison` would.) + +<!-- + +Local Variables: +mode: markdown +fill-column: 76 +ispell-dictionary: "american" +End: + +Copyright (C) 2006, 2009-2015, 2018-2020 Free Software Foundation, Inc. + +This file is part of Bison, the GNU Compiler Compiler. + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 or +any later version published by the Free Software Foundation; with no +Invariant Sections, with no Front-Cover Texts, and with no Back-Cover +Texts. A copy of the license is included in the "GNU Free +Documentation License" file as part of this distribution. + +--> diff --git a/etc/local.mk b/etc/local.mk index 53985069..d03db45f 100644 --- a/etc/local.mk +++ b/etc/local.mk @@ -14,4 +14,5 @@ ## You should have received a copy of the GNU General Public License ## along with this program. If not, see <http://www.gnu.org/licenses/>. -nodist_noinst_SCRIPTS = etc/bench.pl +dist_noinst_DATA = %D%/README.md +nodist_noinst_SCRIPTS = %D%/bench.pl -- 2.27.0
