Re: RAISE concatination/variables in plpgsql

OK, SGML updated.

> I wrote:
> >> Probably.  And 'format' is even more misleading, since it implies that
> >> you write a printf-like format string, which you do not.  The output is
> >> just the concatenation of the literal and the variable values.
>
> Ugh.  Should've read the code before pontificating ;-).  The code makes
> clear what is quite unclear in the docs:
>         /*
>          * Occurences of a single % are replaced by the next arguments
>          * external representation. Double %'s are left as is so elog()
>          * will also don't touch them.
>          */
> So "format" is appropriate, but the next sentence could use some
> improvement.
>
>             regards, tom lane
>

--
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 853-3000
  +  If your life is a hard drive,     |  830 Blythe Avenue
  +  Christ can be your backup.        |  Drexel Hill, Pennsylvania 19026
Index: doc/src/sgml/plsql.sgml
===================================================================
RCS file: /home/projects/pgsql/cvsroot/pgsql/doc/src/sgml/plsql.sgml,v
retrieving revision 2.26
diff -c -r2.26 plsql.sgml
*** doc/src/sgml/plsql.sgml    2001/05/08 00:09:22    2.26
--- doc/src/sgml/plsql.sgml    2001/05/08 00:25:57
***************
*** 1306,1319 ****
      <productname>Postgres</productname> elog mechanism.

  <synopsis>
! RAISE <replaceable class="parameter">level</replaceable> '<replaceable class="parameter">string</replaceable>'
<optional>,<replaceable class="parameter">variable</replaceable> <optional>...</optional></optional>; 
  </synopsis>

!     Inside the format, <literal>%</literal> is used as a placeholder for the
!     subsequent comma-separated identifiers. 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 aborting the transaction).
     </para>

     <para>
--- 1306,1320 ----
      <productname>Postgres</productname> elog mechanism.

  <synopsis>
! RAISE <replaceable class="parameter">level</replaceable> '<replaceable class="parameter">format</replaceable>'
<optional>,<replaceable class="parameter">variable</replaceable> <optional>...</optional></optional>; 
  </synopsis>

!     Inside the format, <literal>%</literal> is replaced by the next argument's
!     external representation. Double %'s are left unchanged for internal
!     reasons.  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
!     aborting the transaction).
     </para>

     <para>