X-Git-Url: http://git.kpe.io/?a=blobdiff_plain;f=doc%2Fappendix.xml;h=2e63360a121d729a3c168c53c8b5b851e46d06ef;hb=ca1fbde617aefd39a81c3eaae9ba25c3fd949f59;hp=8ba1baf6eb59b43091e4c8709a66822fc938649c;hpb=967266c94b00f91e5967b8330fe2b9134b0c0447;p=clsql.git

diff --git a/doc/appendix.xml b/doc/appendix.xml
index 8ba1baf..2e63360 100644
--- a/doc/appendix.xml
+++ b/doc/appendix.xml
@@ -12,7 +12,7 @@
       <title>PostgreSQL</title>
       <sect2>
 	<title>Libraries</title>
-	<para>The PostgreSQL back-end needs access to the PostgreSQL C 
+	<para>The PostgreSQL back-end requires the PostgreSQL C 
 	  client library (<filename>libpq.so</filename>).  The
 	  location of this library is specified via 
 	  <symbol>*postgresql-so-load-path*</symbol>, which defaults
@@ -25,7 +25,7 @@
 	<title>Initialization</title>
 	<para>Use 
 	  <screen>
-(asdf:operate 'adsf:load-op 'clsql-postgresql)
+(asdf:operate 'asdf:load-op 'clsql-postgresql)
 	</screen>
 	  to load the PostgreSQL back-end.  The database type for the
 	  PostgreSQL back-end is <symbol>:postgresql</symbol>.</para>
@@ -209,7 +209,7 @@
     <title>MySQL</title>
     <sect2>
       <title>Libraries</title>
-      <para>The &mysql; back-end needs access to the &mysql; C 
+      <para>The &mysql; back-end requires the &mysql; C 
 	client library (<filename>libmysqlclient.so</filename>).
 	The location of this library is specified 
 	via <symbol>*mysql-so-load-path*</symbol>, which defaults
@@ -399,8 +399,8 @@
       <title>&sqlite;</title>
       <sect2>
 	<title>Libraries</title> <para>The &sqlite; back-end requires
-	access to the &sqlite; shared library file. Its default file
-	name is <filename>/usr/lib/libsqlite.so</filename>.</para>
+	the &sqlite; shared library file. Its default file name is
+	<filename>/usr/lib/libsqlite.so</filename>.</para>
       </sect2>
       <sect2>
 	<title>Initialization</title>
@@ -434,4 +434,63 @@
       </sect2>
     </sect1>
 
+  <sect1 id="oracle">
+    <title>Oracle</title>
+    <sect2>
+      <title>Libraries</title>
+      <para>The &oracle; back-end requires the &oracle; OCI client
+      library. (<filename>libclntsh.so</filename>).  The location of
+      this library is specified relative to the
+      <symbol>ORACLE_HOME</symbol> value in the operating system
+      environment. &clsql; has tested sucessfully using the client
+      library from Oracle 9i and Oracle 10g server installations as
+      well as Oracle's 10g Instant Client library.
+      </para>
+    </sect2>
+    <sect2>
+      <title>Initialization</title>
+      <para>
+	Use 
+	<screen>
+(asdf:operate 'asdf:load-op 'clsql-oracle)
+	</screen>
+	to load the &oracle; back-end.  The database type for the Oracle
+	back-end is <symbol>:oracle</symbol>.
+      </para>
+      </sect2>
+      <sect2>
+	<title>Connection Specification</title>
+	<sect3>
+	  <title>Syntax of connection-spec</title>
+	  <synopsis>(<replaceable>global-name</replaceable> <replaceable>user</replaceable> <replaceable>password</replaceable>)</synopsis>
+	</sect3>
+	<sect3>
+	  <title>Description of connection-spec</title>
+	  <variablelist>
+	    <varlistentry>
+	      <term><parameter>global-name</parameter></term>
+	      <listitem>
+		<para>String representing the global name of the Orace database.
+		  This is looked up through the tnsnames.ora file.</para>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term><parameter>user</parameter></term>
+	      <listitem>
+		<para>String representing the user name to use for
+		  authentication.</para>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term><parameter>password</parameter></term>
+	      <listitem>
+		<para>String representing the password to
+		  use for authentication..</para>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</sect3>
+      </sect2>
+    </sect1>
+
   </appendix>