Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/db-api.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/db-api.xml,v diff -u -r1.8 -r1.9 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/db-api.xml 20 Aug 2003 16:20:18 -0000 1.8 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/db-api.xml 11 Dec 2003 21:39:48 -0000 1.9 @@ -8,9 +8,7 @@ The OpenACS Database Access API - By Pete Su and - Jon Salz. Modified - by Roberto Mello. + By Pete Su and Jon Salz. Modified by Roberto Mello. @@ -135,14 +133,18 @@ + If the literal value is a huge string, then we waste a lot of time in the database server doing useless parsing. + + Second, if the literal value contains characters like single quotes, we have to be careful to double-quote them, because not quoting them will lead to surprising errors. + @@ -542,9 +544,9 @@ Performs the SQL query sql, saving results in variables of the form - var_name:1, var_name:2, etc, - setting var_name:rowcount to the total number - of rows, and setting var_name:columns to a + var_name:1, var_name:2, etc, + setting var_name:rowcount to the total number + of rows, and setting var_name:columns to a list of column names. @@ -573,7 +575,7 @@ You may also add additional, computed columns to the multirow, using the - -extend { col_1 col_2 ... } switch. This is + -extend { col_1 col_2 ... } switch. This is useful for things like constructing a URL for the object retrieved by the query.