CVS gsasl/doc/reference

[gsasl-commit]

Update of /home/cvs/gsasl/doc/reference
In directory dopio:/tmp/cvs-serv9086

Modified Files:
        Makefile.am gsasl-docs.sgml 
Log Message:
Add image.

--- /home/cvs/gsasl/doc/reference/Makefile.am   2004/10/24 21:41:12     1.17
+++ /home/cvs/gsasl/doc/reference/Makefile.am   2004/11/07 16:24:06     1.18
@@ -47,7 +47,7 @@
 
 # Images to copy into HTML directory.
 # e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
-HTML_IMAGES=../controlflow.png ../controlflow2.png
+HTML_IMAGES=../abstraction.png ../controlflow.png ../controlflow2.png
 
 # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
 # e.g. content_files=running.sgml building.sgml changes-2.0.sgml
--- /home/cvs/gsasl/doc/reference/gsasl-docs.sgml       2004/10/31 15:28:26     
1.6
+++ /home/cvs/gsasl/doc/reference/gsasl-docs.sgml       2004/11/07 16:24:06     
1.7
@@ -15,6 +15,7 @@
 used by network servers (e.g., IMAP, SMTP) to request authentication
 from clients, and in clients to authenticate against servers.
     </para>
+
     <para>
 GNU SASL contains of a library (`libgsasl'), a command line utility
 (`gsasl') to access the library from the shell, and a manual.  The
@@ -23,6 +24,7 @@
 least partial support for the CRAM-MD5, EXTERNAL, GSSAPI, ANONYMOUS,
 PLAIN, SECURID, DIGEST-MD5, LOGIN, NTLM mechanisms.
     </para>
+
     <para>
 The library is easily ported because it does not do network
 communication by itself, but rather leaves it up to the calling
@@ -31,11 +33,13 @@
 application to decide whether a user is authorized or not.  GNU SASL
 has been ported to many Unix flavors.
     </para>
+
     <para>
 GNU SASL is developed for the GNU/Linux system, but runs on over 20
 platforms including most major Unix platforms and Windows, and many
 kind of devices including iPAQ handhelds and S/390 mainframes.
     </para>
+
     <para>
 The GNU SASL library is licensed under the GNU Lesser General Public
 License (LGPL).  The command-line application and test suite (src/,
@@ -43,13 +47,22 @@
 (see COPYING), and the documentation (doc/) is licensed under the GNU
 Free Documentation License (see COPYING.DOC).
     </para>
-    <para>The operation of an application using the library can best
-      be understood in terms of a flow chart diagram, as shown in
-      <xref linkend="controlflow"/>.  The details on how the actual
-      negotiation are carried out are illustrated in <xref
-      linkend="controlflow2"/>.
+
+    <para>
+A conceptual view of how your application, the library, and each
+mechanism interact is shown in <xref linkend="abstraction"/>.  The
+operation of an application using the library can best be understood
+in terms of a flow chart diagram, as shown in <xref
+linkend="controlflow"/>.  The details on how the actual negotiation
+are carried out are illustrated in <xref linkend="controlflow2"/>.
     </para>
 
+    <figure id="abstraction">
+      <title>Illustration of separation between application and
+      individual mechanism</title>
+      <graphic fileref="abstraction.png" format="PNG"></graphic>
+    </figure>
+
     <figure id="controlflow">
       <title>High-level control flow of SASL application</title>
       <graphic fileref="controlflow.png" format="PNG"></graphic>