Index: openacs-4/packages/acs-core-docs/www/db-api.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/db-api.adp,v
diff -u -N -r1.5 -r1.6
--- openacs-4/packages/acs-core-docs/www/db-api.adp	24 May 2018 06:54:57 -0000	1.5
+++ openacs-4/packages/acs-core-docs/www/db-api.adp	12 Feb 2019 17:12:18 -0000	1.6
@@ -216,19 +216,7 @@
 # null, because Oracle has coerced the empty string (even for the
 # numeric column "bar") into null in both cases
 
-      </pre><p>Since databases other than Oracle do not coerce empty strings
-into <code class="computeroutput">null</code>, this code has
-different semantics depending on the underlying database (i.e., the
-row that gets inserted may not have null as its column values),
-which defeats the purpose of SQL abstraction.</p><p>Therefore, the Database Access API provides a
-database-independent way to represent <code class="computeroutput">null</code> (instead of the Oracle-specific idiom
-of the empty string): <code class="computeroutput">db_null</code>.</p><p>Use it instead of the empty string whenever you want to set a
-column value explicitly to <code class="computeroutput">null</code>, e.g.:</p><pre class="programlisting">set bar [db_null]
-set baz [db_null]
-
-db_dml foo_create "insert into foo(bar, baz) values(:bar, :baz)"
-#
-# sets the values for both the "bar" and "baz" columns to null</pre>
+      </pre>
 </div>
 </div><div class="sect2">
 <div class="titlepage"><div><div><h3 class="title">
@@ -332,12 +320,6 @@
           </pre><p>Technically it&#39;s equivalent to using a code block on the end
 of your db_multirow.</p>
 </dd><dt><span class="term"><code class="computeroutput">
-<a name="devguide.dbapi_db_null" id="devguide.dbapi_db_null"></a>db_null</code></span></dt><dd>
-<pre class="programlisting"><code class="computeroutput">db_null</code></pre><p>Returns a value which can be used in a bind variable to
-represent the SQL value <code class="computeroutput">null</code>.
-See <a class="link" href="db-api" title="Nulls and Bind Variables">Nulls and Bind Variables</a>
-above.</p>
-</dd><dt><span class="term"><code class="computeroutput">
 <a name="devguide.dbapi_db_foreach" id="devguide.dbapi_db_foreach"></a>db_foreach</code></span></dt><dd>
 <pre class="programlisting">
 db_foreach <span class="emphasis"><em>statement-name sql</em></span> [ -bind <span class="emphasis"><em>bind_set_id</em></span> | -bind <span class="emphasis"><em>bind_value_list</em></span> ] \
@@ -615,4 +597,4 @@
 			rightLink="templates" rightLabel="Next" rightTitle="Using Templates in OpenACS"
 			homeLink="index" homeLabel="Home" 
 			upLink="dev-guide" upLabel="Up"> 
-		    
\ No newline at end of file
+