pgsql: Doc: improve introductory information about procedures.

Started by Tom Laneover 5 years ago1 messagescomitters

tgl@sss.pgh.pa.us

over 5 years ago

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: /messages/by-id/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(-)