pgsql: doc: Generate keywords table automatically

From: Peter Eisentraut <peter(at)eisentraut(dot)org>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: doc: Generate keywords table automatically
Date: 2019-05-07 13:30:14
Message-ID: E1hO0Ag-0002Yr-Cx@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers

doc: Generate keywords table automatically

The SQL keywords table in the documentation had until now been
generated by some ad hoc scripting outside the source tree once for
each major release. This changes it to an automated process.

We have the PostgreSQL keywords available in a parseable format in
parser/kwlist.h. For the relevant SQL standard versions, keep the
keyword lists in new text files. A new script
generate-keywords-table.pl pulls it all together and produces a
DocBook table.

The final output in the documentation should be identical after this
change.

Discussion: https://www.postgresql.org/message-id/flat/07daeadd-8c82-0d95-5e19-e350502cb749%402ndquadrant.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/b753bc0c84e51c200ec7de6cefb6f689d13fef62

Modified Files
--------------
doc/src/sgml/.gitignore | 1 +
doc/src/sgml/Makefile | 6 +-
doc/src/sgml/filelist.sgml | 1 +
doc/src/sgml/generate-keywords-table.pl | 122 +
doc/src/sgml/keywords.sgml | 5361 +---------------------
doc/src/sgml/keywords/sql1992-nonreserved.txt | 50 +
doc/src/sgml/keywords/sql1992-reserved.txt | 227 +
doc/src/sgml/keywords/sql2008-02-nonreserved.txt | 218 +
doc/src/sgml/keywords/sql2008-02-reserved.txt | 307 ++
doc/src/sgml/keywords/sql2008-09-nonreserved.txt | 23 +
doc/src/sgml/keywords/sql2008-09-reserved.txt | 13 +
doc/src/sgml/keywords/sql2008-14-nonreserved.txt | 29 +
doc/src/sgml/keywords/sql2008-14-reserved.txt | 20 +
doc/src/sgml/keywords/sql2011-02-nonreserved.txt | 219 +
doc/src/sgml/keywords/sql2011-02-reserved.txt | 324 ++
doc/src/sgml/keywords/sql2011-09-nonreserved.txt | 23 +
doc/src/sgml/keywords/sql2011-09-reserved.txt | 13 +
doc/src/sgml/keywords/sql2011-14-nonreserved.txt | 29 +
doc/src/sgml/keywords/sql2011-14-reserved.txt | 20 +
19 files changed, 1645 insertions(+), 5361 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Andrew Gierth 2019-05-07 13:38:39 Re: pgsql: docs: fist draft version of the PG 12 release notes
Previous Message Thomas Munro 2019-05-07 09:08:06 Re: pgsql: docs: fist draft version of the PG 12 release notes