Horton

Doc: improve introductory information about procedures.

Tom Lane <tgl@sss.pgh.pa.us>

View on postgr.es
Commit: 74207b8fc5a03a902171460aa42f7d816f2c6597
Author: Tom Lane <tgl@sss.pgh.pa.us>
Date: 2021-03-10T16:33:50Z
Releases: 12.7 
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

Files

PathChange+/−
doc/src/sgml/ref/create_function.sgml modified +6 −8
doc/src/sgml/ref/create_procedure.sgml modified +5 −0
doc/src/sgml/xfunc.sgml modified +44 −12

Documentation touched

Discussion