X-Git-Url: http://git.kpe.io/?a=blobdiff_plain;f=doc%2Fref.sgml;h=aaf1feac499abe4fde3a6c841017de27e7a7328e;hb=8f3d2ca349d5e9848438b5545e83a0f1d41c9f38;hp=81c75aad198724057b3791d17134ef4787403350;hpb=d9322041cff941cfa0ee5a4a916259177b6dbe61;p=uffi.git

diff --git a/doc/ref.sgml b/doc/ref.sgml
index 81c75aa..aaf1fea 100644
--- a/doc/ref.sgml
+++ b/doc/ref.sgml
@@ -27,45 +27,27 @@
 	</para>
       </sect2>
 
-      <sect2 id="uffi-declare">
-	<title>uffi-declare</title>
-	<para>
-	  This is used wherever a <function>declare</function>
-	  expression can be placed. For example:
-	</para>
-	<para>
-	  <programlisting>
-(let ((my-structure (uffi:allocate-foreign-object 'a-struct)))
-   (uffi:uffi-declare a-struct my-structure))
-	  </programlisting>
-	</para>
-      </sect2>
-
-      <sect2 id="slot-type">
-	<title>slot-type</title>
+      <sect2 id="def-type">
+	<title>def-type</title>
 	<para>
-	  This is used inside of <function>defclass</function> and
-	  <function>defstruct</function> expressions to set the type
-	  for a field. Because the type identifier is not evaluated in
-	  &cl;, the expression must be backquoted for effect. For
-	  example:
-	</para>
+	  This is used wherever a &cl; <function>deftype</function>
+	  expression can be placed. Used to declare types to
+the compiler for optimization. Currently, on &cmucl; takes advantage
+of this.	</para>
 	<para>
 	  <programlisting>
-(eval 
-  `(defclass a-class ()
-     ((char-ptr :type ,(uffi:slot-type (* :char))))))
+(uffi:def-type my-struct-def my-struct-foreign-type)
 	  </programlisting>
 	</para>
       </sect2>
     </sect1>
 
     <sect1>
-      <title>Immediate Types</title>
+      <title>Primitive Types</title>
       <sect2>
 	<title>Overview</title>
 	<para>
-	  Immediate types have a single value, these include
+	  Primitive types have a single value, these include
 	  characters, numbers, and pointers. They are all symbols in
 	  the keyword package.
 	</para>
@@ -344,7 +326,9 @@ always need to have memory for them.
 	<synopsis>
 	  <function>def-function</function> <replaceable>name args &amp;key module returning</replaceable>
 	</synopsis>
-	<para>Arguments and Values</para>
+      </refsynopsisdiv>
+      <refsect1>
+	<title>Arguments and Values</title>
 	<variablelist>
 	  <varlistentry>
 	    <term><parameter>name</parameter></term>
@@ -375,7 +359,7 @@ foreign function.
 	    </listitem>
 	  </varlistentry>
 	</variablelist>
-      </refsynopsisdiv>
+      </refsect1>
       <refsect1>
 	<title>Description</title>
 	<para>Declares a foreign function.
@@ -417,7 +401,7 @@ foreign function.
       <refsect1>
 	<title>Syntax</title>
 <synopsis>
-	  <function>load-foreign-library</function> <replaceable>filename module supporting-libraries</replaceable> => <returnvalue>success</returnvalue>
+	  <function>load-foreign-library</function> <replaceable>filename &amp;key module supporting-libraries</replaceable> => <returnvalue>success</returnvalue>
 </synopsis>
       </refsect1>
       <refsect1>
@@ -427,7 +411,8 @@ foreign function.
 	    <term><parameter>filename</parameter></term>
 	    <listitem>
 	      <para>A string or pathname specifying the library location
-in the filesystem.
+in the filesystem. At least one implementation (&lw;) can not
+accept a logical pathname.
 	      </para>
 	    </listitem>
 	  </varlistentry>
@@ -468,7 +453,9 @@ a session.
       <refsect1>
 	<title>Examples</title>
 	<programlisting>
-  (load-foreign-library #p"/usr/lib/libmysqlclient.so" "mysql" '("c"))
+  (load-foreign-library #p"/usr/lib/libmysqlclient.so" 
+                        :module "mysql" 
+                        :supporting-libraries '("c"))
     => T
 	</programlisting>
       </refsect1>