pgsql: Doc: document bpchar, clarify relationship of text and varchar. - Mailing list pgsql-committers

From Tom Lane
Subject pgsql: Doc: document bpchar, clarify relationship of text and varchar.
Date
Msg-id E1odZyZ-0000g2-AE@gemulon.postgresql.org
Whole thread Raw
Responses Re: pgsql: Doc: document bpchar, clarify relationship of text and varchar.  (Jeff Davis <pgsql@j-davis.com>)
List pgsql-committers
Doc: document bpchar, clarify relationship of text and varchar.

For some reason the "bpchar" type name was defined nowhere in
our SGML docs, although several places refer to it in passing.
Give it a proper mention under Character Types.

While here, also provide an explanation of how the text and varchar
types relate.  The previous wording seemed to be doing its best
to sweep text under the rug, which doesn't seem very appropriate
given its prominence in other parts of the docs.

Minor rearrangements and word-smithing for clarity, too.

Laurenz Albe and Tom Lane, per gripe from Yanliang Lei

Discussion: https://postgr.es/m/120b3084.56b6.1833b5ffe4b.Coremail.msdnchina@163.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/0937f6d172921202e1b432e206e4c30775d564d8

Modified Files
--------------
doc/src/sgml/datatype.sgml | 59 ++++++++++++++++++++++++++++------------------
1 file changed, 36 insertions(+), 23 deletions(-)


pgsql-committers by date:

Previous
From: Tom Lane
Date:
Subject: pgsql: Allow callback functions to deregister themselves during a call.
Next
From: Bruce Momjian
Date:
Subject: pgsql: revert "warn of SECURITY DEFINER schemas for non-sql_body funcs"