| 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: | E1lK1mk-0001sg-PO@gemulon.postgresql.org |
| Views: | Raw Message | Whole Thread | 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
------
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(-)
| 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 |