From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: rmzgrimes@gmail.com
Subject: Unnecessary use of .* in examples
Date: Mon, 01 Feb 2021 05:46:58 +0000
Message-ID: <161215841824.14653.8969016349304314299@wrigleys.postgresql.org> (raw)
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/13/functions-matching.html
Description:
In the table for the ~ (and friends) operator, every example has a pointless
set of '.*' surrounding the text to be matched. These unnecessary operators
add visual clutter making the examples both harder to read and understand,
and since they're official examples, they teach bad habits.
That is to say, 'thomas' ~ 'thom' is the exact same regex as 'thomas' ~
'.*thom.*' but the first is shorter, easier to read and easier to
understand, and, presumably, faster as well.
Operator
Description
Example(s)
text ~ text → boolean
String matches regular expression, case sensitively
'thomas' ~ '.*thom.*' → t
text ~* text → boolean
String matches regular expression, case insensitively
'thomas' ~* '.*Thom.*' → t
text !~ text → boolean
String does not match regular expression, case sensitively
'thomas' !~ '.*thomas.*' → f
text !~* text → boolean
String does not match regular expression, case insensitively
'thomas' !~* '.*vadim.*' → t
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, rmzgrimes@gmail.com
Subject: Re: Unnecessary use of .* in examples
In-Reply-To: <161215841824.14653.8969016349304314299@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