Index: openacs.org-dev/packages/acs-core-docs/www/xml/kernel/db-api.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs.org-dev/packages/acs-core-docs/www/xml/kernel/db-api.xml,v
diff -u -r1.1.1.2 -r1.1.1.3
--- openacs.org-dev/packages/acs-core-docs/www/xml/kernel/db-api.xml	31 Jul 2002 16:30:50 -0000	1.1.1.2
+++ openacs.org-dev/packages/acs-core-docs/www/xml/kernel/db-api.xml	11 Aug 2002 00:42:49 -0000	1.1.1.3
@@ -1,10 +1,10 @@
 <sect1 id="db-api-detailed" xreflabel="Database Access API">
 <title>Database Access API</title>
 
-<authorblurb><para>
+<authorblurb>
 by <ulink url="mailto:jsalz@mit.edu">Jon Salz</ulink>. Revised and expanded by 
 Roberto Mello (rmello at fslc dot usu dot edu), July 2002. 
-</para></authorblurb>
+</authorblurb>
 
 <itemizedlist>
 <listitem><para>Tcl procedures: /packages/acs-kernel/10-database-procs.tcl</para></listitem>
@@ -750,8 +750,7 @@
 <para>Returns the next value for the sequence <emphasis>sequence-name</emphasis> (using a
 SQL statement like <computeroutput>SELECT</computeroutput> <emphasis><computeroutput>sequence-name</computeroutput></emphasis><computeroutput>.nextval FROM
 DUAL</computeroutput>). If sequence pooling is enabled for the sequence, transparently
-uses a value from the pool if available to save a round-trip to the database
-(see <emphasis><xref linkend="db-api-detailed-pooling"/></emphasis>). 
+uses a value from the pool if available to save a round-trip to the database.
 
 </para></listitem>
 </varlistentry>
@@ -973,13 +972,23 @@
     <computeroutput><emphasis>var_name</emphasis>:1</computeroutput>, <computeroutput><emphasis>var_name</emphasis>:2</computeroutput>, etc,
     setting <computeroutput><emphasis>var_name</emphasis>:rowcount</computeroutput> to the total number
     of rows, and setting <computeroutput><emphasis>var_name</emphasis>:columns</computeroutput> to a
-    list of column names. Each row also has a column, rownum, automatically
+    list of column names. 
+    </para>
+
+    <para>
+    Each row also has a column, rownum, automatically
     added and set to the row number, starting with 1. Note that this will
     override any column in the SQL statement named 'rownum', also if you're
     using the Oracle rownum pseudo-column.
     </para>                                                                                                                                           
-    <para>                                                                                                                                        
 
+    <para>
+    If the <computeroutput>-local</computeroutput> is passed, the variables defined
+    by db_multirow will be set locally (useful if you're compiling dynamic templates
+    in a function or similar situations).
+    </para>
+    
+    <para>                                                                                                                                        
     You may supply a code block, which will be executed for each row in
     the loop. This is very useful if you need to make computations that
     are better done in Tcl than in SQL, for example using ns_urlencode
@@ -1256,3 +1265,8 @@
 </sect2>
 </sect1>
 
+<!--
+   Local Variables:
+   sgml-parent-document: ("../index.xml" "book" "sect1")
+   End:
+-->