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-0000ol-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
------
REL9_5_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/bb389ad8cdda3756b93e06a532128c5b34307673

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


pgsql-committers by date:

Previous
From: Heikki Linnakangas
Date:
Subject: pgsql: Make all unicode perl scripts to use strict, rearrange logic for
Next
From: Tom Lane
Date:
Subject: pgsql: Doc: improve description of trim() and related functions.