pgsql: Doc: improve description of trim() and related functions. - Mailing list pgsql-committers

From Tom Lane
Subject pgsql: Doc: improve description of trim() and related functions.
Date
Msg-id E1cC9iE-0000oh-8W@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
Doc: improve description of trim() and related functions.

Per bug #14441 from Mark Pether, the documentation could be misread,
mainly because some of the examples failed to show what happens with
a multicharacter "characters to trim" string.  Also, while the text
description in most of these entries was fairly clear that the
"characters" argument is a set of characters not a substring to match,
some of them used variant wording that was a bit less clear.
trim() itself suffered from both deficiencies and was thus pretty
misinterpretable.

Also fix failure to explain which of LEADING/TRAILING/BOTH is the
default.

Discussion: https://postgr.es/m/20161130011710.6539.53657@wrigleys.postgresql.org

Branch
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/213c0f2d7880f78c710127920cf4bf7017e0fa57

Modified Files
--------------
doc/src/sgml/func.sgml | 33 +++++++++++++++++----------------
1 file changed, 17 insertions(+), 16 deletions(-)


pgsql-committers by date:

Previous
From: Tom Lane
Date:
Subject: pgsql: Doc: improve description of trim() and related functions.
Next
From: Tom Lane
Date:
Subject: pgsql: Doc: improve description of trim() and related functions.