svn commit: r1183683 - /apr/apr/trunk/include/apr_general.h

[sf...@apache.org]

Author: sf
Date: Sat Oct 15 20:46:08 2011
New Revision: 1183683

URL: http://svn.apache.org/viewvc?rev=1183683&view=rev
Log:
Clarify that it is save to call apr_initialize several times.

Modified:
    apr/apr/trunk/include/apr_general.h

Modified: apr/apr/trunk/include/apr_general.h
URL: http://svn.apache.org/viewvc/apr/apr/trunk/include/apr_general.h?rev=1183683&r1=1183682&r2=1183683&view=diff
==============================================================================
--- apr/apr/trunk/include/apr_general.h (original)
+++ apr/apr/trunk/include/apr_general.h Sat Oct 15 20:46:08 2011
@@ -182,7 +182,8 @@ struct type { \
 
 /**
  * Setup any APR internal data structures.  This MUST be the first function 
- * called for any APR library.
+ * called for any APR library. It is save to call apr_initialize several
+ * times as long as apr_terminate is called the same number of times.
  * @remark See apr_app_initialize if this is an application, rather than
  * a library consumer of apr.
  */
@@ -206,7 +207,8 @@ APR_DECLARE(apr_status_t) apr_app_initia
 
 /**
  * Tear down any APR internal data structures which aren't torn down 
- * automatically.
+ * automatically. apr_terminate must be called once for every call to
+ * apr_initialize() or apr_app_initialize().
  * @remark An APR program must call this function at termination once it 
  *         has stopped using APR services.  The APR developers suggest using
  *         atexit to ensure this is called.  When using APR from a language