Move un-parenthesized syntax docs to "compatibility" for few SQL commands
Melanie Plageman <melanieplageman@gmail.com>
From: Melanie Plageman <melanieplageman@gmail.com>
To: Pg Hackers <pgsql-hackers@postgresql.org>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Date: 2023-04-21T22:29:16Z
Lists: pgsql-hackers
Attachments
- v1-0001-Doc-Move-un-parenthesized-syntax-to-compatibility.patch (text/x-patch) patch v1-0001
Hi, I find the inclusion of the un-parenthesized syntax for VACUUM, ANALYZE, and EXPLAIN in the docs makes it harder to understand the preferred, parenthesized syntax (see [1] as an example). Over in [2], it was suggested that moving the un-parenthesized syntax to the "Compatibility" section of their respective docs pages would be okay. Patch attached. I left out CLUSTER since that syntax change is so new. - Melanie [1] https://www.postgresql.org/docs/devel/sql-analyze.html [2] https://www.postgresql.org/message-id/3024596.1681940741%40sss.pgh.pa.us
Commits
-
Doc: move unparenthesized syntaxes for a few commands.
- ab29a7a9c6ff 17.0 landed
-
Support parenthesized syntax for CLUSTER without a table name.
- cdaedfc96d14 17.0 landed