| From: | Melanie Plageman <melanieplageman(at)gmail(dot)com> |
|---|---|
| To: | Pg Hackers <pgsql-hackers(at)postgresql(dot)org> |
| Cc: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
| Subject: | Move un-parenthesized syntax docs to "compatibility" for few SQL commands |
| Date: | 2023-04-21 22:29:16 |
| Message-ID: | CAAKRu_bc5uHieG1976kGqJKxyWtyQt9yvktjsVX+i7NOigDjOA@mail.gmail.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
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
| Attachment | Content-Type | Size |
|---|---|---|
| v1-0001-Doc-Move-un-parenthesized-syntax-to-compatibility.patch | text/x-patch | 3.9 KB |
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Regina Obe | 2023-04-21 22:39:26 | RE: Order changes in PG16 since ICU introduction |
| Previous Message | Jeff Davis | 2023-04-21 21:56:19 | Re: Order changes in PG16 since ICU introduction |