<varlistentry>
<term><parameter>success</parameter></term>
<listitem>
- <para>A boolean flag. If &t;, a new database wa
+ <para>A boolean flag. If &t;, a new database was
successfully created.
</para>
</listitem>
=> T
(create-database '("localhost" "new" "dent" "badpasswd") :database-type :mysql)
+=>
Error: While trying to access database localhost/new/dent
using database-type MYSQL:
Error database-create failed: mysqladmin: connect to server at 'localhost' failed
<title>Exceptional Situations</title>
<para>An exception will be thrown if the database system does
not allow new databases to be created or if database creation
- fails. Currently, only the <symbol>:postgresql-socket</symbol>
- does not allow new databases to be created.</para>
+ fails.</para>
</refsect1>
<refsect1>
<title>Notes</title>
<varlistentry>
<term><parameter>success</parameter></term>
<listitem>
- <para>A boolean flag. If &t;, a new database wa
+ <para>A boolean flag. If &t;, the database was
successfully destroyed.
</para>
</listitem>
=> T
(destroy-database '("localhost" "new" "dent" "dent") :database-type :postgresql)
+=>
Error: While trying to access database localhost/test2/root
using database-type POSTGRESQL:
Error database-destory failed: dropdb: database removal failed: ERROR: database "test2" does not exist
<title>Exceptional Situations</title>
<para>An exception will be thrown if the database system does not
allow databases to be removed, the database does not exist, or
- if database removal fails. Currently, only the
- <symbol>:postgresql-socket</symbol> does not allow
- databases to be destroyed.</para>
+ if database removal fails.</para>
</refsect1>
<refsect1>
<title>Notes</title>
<refentry id="probe_db">
<refnamediv>
<refname>PROBE-DATABASE</refname>
- <refpurpose>tests for existance of a database</refpurpose>
+ <refpurpose>tests for existence of a database</refpurpose>
<refclass>Function</refclass>
</refnamediv>
<refsect1>
</refsect1>
<refsect1>
<title>Description</title>
- <para>This function tests for the existance of a database in
+ <para>This function tests for the existence of a database in
the database system specified by
<parameter>database-type</parameter>.
</para>
<refsect1>
<title>Exceptional Situations</title>
<para>An exception maybe thrown if the database system does
- not receive administrator-level authentication. This function
- may need to read the administrative table of the database
+ not receive administrator-level authentication since function
+ may need to read the administrative database of the database
system.</para>
</refsect1>
<refsect1>
</refnamediv>
<refsect1>
<title>Syntax</title>
- <synopsis><function>query</function> <replaceable>query-expression</replaceable> &key <replaceable>database</replaceable> <replaceable>result-types</replaceable> => <returnvalue>result</returnvalue></synopsis>
+ <synopsis><function>query</function> <replaceable>query-expression</replaceable> &key <replaceable>database</replaceable> <replaceable>result-types</replaceable> <replaceable>field-names</replaceable> => <returnvalue>result</returnvalue></synopsis>
</refsect1>
<refsect1>
<title>Arguments and Values</title>
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><parameter>field-names</parameter></term>
+ <para>
+ A boolean with a default value of &t;. When &t;, this
+ function results a second value of a list of field
+ names. When &nil;, this function only returns one value
+ - the list of rows.
+ </para>
+ </varlistentry>
<varlistentry>
<term><returnvalue>result</returnvalue></term>
<listitem>