| From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
|---|---|
| To: | Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at> |
| Cc: | rmzgrimes(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org |
| Subject: | Re: Unnecessary use of .* in examples |
| Date: | 2021-02-01 15:08:52 |
| Message-ID: | 3335696.1612192132@sss.pgh.pa.us |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-docs |
Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at> writes:
> On Mon, 2021-02-01 at 05:46 +0000, PG Doc comments form wrote:
>> 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.
> I agree that that is comewhat confusing for people who understand
> regular expressions. On the other hand, the example should show some
> special characters, so that people who don't know regular expressions
> understand that this is more than substring matching.
> Perhaps 'thomas' ~ '^thom' and so on?
There are examples just a bit further down that include special
characters. I agree with the OP that the useless ".*"s add nothing
except confusion as to the semantics; but I don't think we need these
very first examples to use a lot of bells and whistles.
Maybe what would be better is to have an example with embedded .*
such as 'thomas' ~ 't.*m'.
regards, tom lane
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Laurenz Albe | 2021-02-02 09:54:58 | Re: Unnecessary use of .* in examples |
| Previous Message | Laurenz Albe | 2021-02-01 08:53:06 | Re: Unnecessary use of .* in examples |