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/byapr03mb4903c53a8bb7eff5ea289674a6...@byapr03mb4903.namprd03.prod.outlook.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/227338b00d498d9e1c5705a1ab118585e5d57c87

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

Reply via email to