pgsql: Doc: improve introductory information about procedures.

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Doc: improve introductory information about procedures.
Date: 2021-03-10 16:34:10
Message-ID: [email protected]
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Doc: improve introductory information about procedures.

Clarify the discussion in "User-Defined Procedures", by laying out
the key differences between functions and procedures in a bulleted
list. Notably, this avoids burying the lede about procedures being
able to do transaction control. Make the back-link in the CREATE
FUNCTION reference page more prominent, and add one in CREATE
PROCEDURE.

Per gripe from Guyren Howe. Thanks to David Johnston for discussion.

Discussion: https://postgr.es/m/BYAPR03MB4903C53A8BB7EFF5EA289674A6949@BYAPR03MB4903.namprd03.prod.outlook.com

Branch
------
REL_11_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/e0fcde7f74a573cd5ebb111f1ddc4ca890b2ec93

Modified Files
--------------
doc/src/sgml/ref/create_function.sgml | 14 ++++-----
doc/src/sgml/ref/create_procedure.sgml | 5 +++
doc/src/sgml/xfunc.sgml | 56 ++++++++++++++++++++++++++--------
3 files changed, 55 insertions(+), 20 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Tom Lane 2021-03-10 17:38:48 pgsql: Doc: get rid of <foreignphrase> tags.
Previous Message Peter Eisentraut 2021-03-10 14:52:31 pgsql: Add bound check before bsearch() for performance