Further cleanup of RAISE discussion; in particular, remove example

that doesn't actually work.

diff --git a/doc/src/sgml/plsql.sgml b/doc/src/sgml/plsql.sgml
index dfc0c8dda98a52d0db9eb820bd99e874d8f96769..0bc49b52cafba4299c32d2b334235557156efda9 100644 (file)
--- a/doc/src/sgml/plsql.sgml
+++ b/doc/src/sgml/plsql.sgml
@@ -1,5 +1,5 @@
 
 
  
@@ -1309,20 +1309,29 @@ END LOOP;
 RAISE level 'format' , variable ...;
 
 
-    Inside the format, % is replaced by the next argument's
-    external representation. Double %'s are output as %.
-    Possible levels are DEBUG (silently suppressed in production
-    running databases), NOTICE (written into the database log and forwarded to
-    the client application) and EXCEPTION (written into the database log and
+    Possible levels are DEBUG (write the message into the postmaster log),
+    NOTICE (write the message into the postmaster log and forward it to
+    the client application) and EXCEPTION (raise an error,
     aborting the transaction).
+    Inside the format string, % is replaced by the next
+    optional argument's external representation.
+    Write %% to emit a literal %.
+    Note that the optional arguments must presently
+    be simple variables, not expressions, and the format must be a simple
+    string literal.
    
 
+   
+
    
 
-RAISE NOTICE ''Id number '' || key || '' not found!'';
 RAISE NOTICE ''Calling cs_create_job(%)'',v_job_id;
 
-    In this last example, v_job_id will replace the % in the
+    In this example, the value of v_job_id will replace the % in the
     string.
    
 
@@ -1330,7 +1339,7 @@ RAISE NOTICE ''Calling cs_create_job(%)'',v_job_id;
 
 RAISE EXCEPTION ''Inexistent ID --> %'',user_id;
 
-    This will abort the transaction and write to the database log.
+    This will abort the transaction with the given error message.