diff --git a/doc/src/sgml/plpgsql.sgml b/doc/src/sgml/plpgsql.sgml
index 6f880b705f..eccba15cdc 100644
*** a/doc/src/sgml/plpgsql.sgml
--- b/doc/src/sgml/plpgsql.sgml
***************
*** 3805,3814 **** CALL transaction_test2();
raise errors.
! RAISE level 'format' , expression , ... USING option = expression , ... ;
! RAISE level condition_name USING option = expression , ... ;
! RAISE level SQLSTATE 'sqlstate' USING option = expression , ... ;
! RAISE level USING option = expression , ... ;
RAISE ;
--- 3805,3814 ----
raise errors.
! RAISE level 'format' , expression , ... USING option { = | := } expression , ... ;
! RAISE level condition_name USING option { = | := } expression , ... ;
! RAISE level SQLSTATE 'sqlstate' USING option { = | := } expression , ... ;
! RAISE level USING option { = | := } expression , ... ;
RAISE ;
***************
*** 3852,3862 **** RAISE NOTICE 'Calling cs_create_job(%)', v_job_id;
You can attach additional information to the error report by writing
USING followed by option = expression items. Each
expression can be any
string-valued expression. The allowed option key words are:
--- 3852,3881 ----
+
+ condition_name and
+ sqlstate specify
+ error condition name and the five-character SQLSTATE code respectively.
+ See for more information.
+
+
+
+ The example below shows condition_name
+ and sqlstate options usage:
+
+ RAISE division_by_zero;
+ RAISE SQLSTATE '22012';
+
+
+
You can attach additional information to the error report by writing
USING followed by option = expression or
! option :=
! expression
! items, where
expression can be any
string-valued expression. The allowed option key words are:
***************
*** 3925,3939 **** RAISE 'Duplicate user ID: %', user_id USING ERRCODE = '23505';
! There is a second RAISE syntax in which the main argument
! is the condition name or SQLSTATE to be reported, for example:
!
! RAISE division_by_zero;
! RAISE SQLSTATE '22012';
!
! In this syntax, USING can be used to supply a custom
! error message, detail, or hint. Another way to do the earlier
! example is
RAISE unique_violation USING MESSAGE = 'Duplicate user ID: ' || user_id;
--- 3944,3954 ----
! In the RAISE command syntax with
! condition_name or
! sqlstate you can
! additionally use the USING clause too.
! A variation of the example above:
RAISE unique_violation USING MESSAGE = 'Duplicate user ID: ' || user_id;