From: | Daniel Gustafsson <daniel(at)yesql(dot)se> |
---|---|
To: | zhangysh1995(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org |
Subject: | Re: Suggestion on Document for Version 12 Section 40.3 |
Date: | 2020-01-09 09:42:10 |
Message-ID: | 6E6064A4-D57B-4DF0-A0BF-4DFA745ACD47@yesql.se |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
> On 9 Jan 2020, at 09:28, PG Doc comments form <noreply(at)postgresql(dot)org> wrote:
>
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/12/rules-materializedviews.html
> Description:
>
> Hello all,
>
>
> I'm reading Section 40.3, and there is an example (the third square by
> reverse order):
>
>
> SELECT word FROM words ORDER BY word <-> 'caterpiler' LIMIT 10;
>
> word
> ---------------
> cater
> caterpillar
> Caterpillar
> caterpillars
> caterpillar's
> Caterpillar's
> caterer
> caterer's
> caters
> catered
> (10 rows)
>
>
> As shown here https://www.postgresql.org/docs/current/pgtrgm.html, the
> operator `<->` is in an additional module. Without the context, the reader
> will need searching to help understand the meaning. It would be better if
> further reference is given.
I agree that this could lead to unnecessary confusion for readers, and since we
are already mentioning that file_fdw is used it seems reasonable to also
mention pg_trgm. A suggested patch is attached.
cheers ./daniel
Attachment | Content-Type | Size |
---|---|---|
rules_trgm.diff | application/octet-stream | 579 bytes |
From | Date | Subject | |
---|---|---|---|
Next Message | Magnus Hagander | 2020-01-09 09:50:14 | Re: Suggestion on Document for Version 12 Section 40.3 |
Previous Message | Octopus ZHANG | 2020-01-09 09:34:52 | Re: Typo in Documentation for Version 12 Section 40.3 |