From 46feb01bf75b7f9f9db15c8a573efb6423519724 Mon Sep 17 00:00:00 2001
From: joe <joe@61a7d7f5-40b7-0310-9c16-bb0ea8cb1845>
Date: Fri, 20 Jul 2007 11:52:33 +0000
Subject: * doc/ref/neon.xml: Add a list of the functions using global state,
 for clarity. Add more symbol namespaces used by dependencies of neon.

git-svn-id: http://svn.webdav.org/repos/projects/neon/trunk@1211 61a7d7f5-40b7-0310-9c16-bb0ea8cb1845
---
 doc/ref/neon.xml | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

(limited to 'doc')

diff --git a/doc/ref/neon.xml b/doc/ref/neon.xml
index fa5586a..dcc61bc 100644
--- a/doc/ref/neon.xml
+++ b/doc/ref/neon.xml
@@ -78,6 +78,35 @@
 
   </refsect2>
 
+  <refsect2>
+    <title>Functions using global state</title>
+
+    <para>Any function call in &neon; may modify the
+    <literal>errno</literal> global variable as a side-effect.  Except
+    where explicitly documented, the value of <literal>errno</literal>
+    is unspecified after any &neon; function call.</para>
+
+    <para>Other than in the use of <literal>errno</literal>, the only
+    functions which use or modify process-global state in &neon; are
+    as follows:
+
+    <itemizedlist>
+      <listitem><simpara><xref linkend="ne_sock_init"/>, <xref
+      linkend="ne_i18n_init"/>, and <xref linkend="ne_sock_exit"/>, as
+      described above</simpara></listitem>
+
+      <listitem><simpara><function>ne_debug_init</function> and
+      <function>ne_debug</function>, if enabled at compile time; for
+      debugging output</simpara></listitem>
+
+      <listitem><simpara><xref linkend="ne_oom_callback"/> for
+      installing a process-global callback to be invoked on
+      <function>malloc</function> failure</simpara></listitem>
+
+    </itemizedlist></para>
+
+  </refsect2>      
+
   <refsect2>
     <title>Namespaces</title>
 
@@ -109,6 +138,12 @@
 	library.</simpara></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term>gnutls_, gcry_, gpg_</term>
+        <listitem><simpara>Namespaces used by the GnuTLS library (and
+        dependencies thereof)</simpara></listitem>
+      </varlistentry>        
+
       <varlistentry>
 	<term>XML_, Xml[A-Z]</term> <listitem><simpara>Namespaces
 	used by the expat library.</simpara></listitem>
@@ -121,6 +156,23 @@
 	prefixes.</simpara></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term>inflate, deflate, crc32, compress, uncompres, adler32,
+        zlib</term>
+	<listitem><simpara>Namespaces used by the zlib library; a
+	relatively small number of symbols are used without these
+	prefixes.</simpara></listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>krb5, gss, GSS, asn1, decode_krb5, encode_krb5, profile,
+        mit</term>
+
+        <listitem><simpara>Some of the prefixes used by the MIT GSSAPI
+        library and dependencies thereof; a number of symbols lie
+        outside these prefixes.</simpara></listitem>
+      </varlistentry>
+
     </variablelist>
 
   </refsect2>
-- 
cgit v1.2.1