From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: zack02469@yahoo.com
Subject: Section 9.7.3.2. Bracket Expressions should be rewritten
Date: Wed, 12 Oct 2022 14:08:29 +0000
Message-ID: <166558370911.591811.13134615993053243791@wrigleys.postgresql.org> (raw)
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/14/functions-matching.html
Description:
I am a Postgres newbie, and I find this part of what is generally excellent
documentation quite confusing. It contains the following disclaimer:
Note
PostgreSQL currently does not support multi-character collating elements.
This information describes possible future behavior.
I am very skeptical of the idea of documentation describing "possible future
behavior." Unless carefully done, this is guaranteed to cause confusion to
newbies such as myself. In this case, it is very unclear as to what the
disclaimer refers to. Is it referring to the previous 3 paragraphs, the
following 3 paragraphs, some subset of those paragraphs, or the entire
section? If reference to possible future behavior is deemed absolutely
necessary, then IMHO that portion of the docs should be blockquoted and
clearly marked as being forward-looking and not part of present behavior.
Furthermore, it appears that this disclaimer has been part of the docs since
at least version 10, so it's not even clear that this feature is even
currently being seriously considered for implementation.
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, zack02469@yahoo.com
Subject: Re: Section 9.7.3.2. Bracket Expressions should be rewritten
In-Reply-To: <166558370911.591811.13134615993053243791@wrigleys.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox