Author: sf
Date: Sun Jan 22 10:19:09 2012
New Revision: 1234476

URL: http://svn.apache.org/viewvc?rev=1234476&view=rev
Log:
Merge r1234474:
clarify docs

Modified:
    apr/apr-util/branches/1.4.x/include/apr_buckets.h

Modified: apr/apr-util/branches/1.4.x/include/apr_buckets.h
URL: http://svn.apache.org/viewvc/apr/apr-util/branches/1.4.x/include/apr_buckets.h?rev=1234476&r1=1234475&r2=1234476&view=diff
==============================================================================
--- apr/apr-util/branches/1.4.x/include/apr_buckets.h (original)
+++ apr/apr-util/branches/1.4.x/include/apr_buckets.h Sun Jan 22 10:19:09 2012
@@ -687,7 +687,8 @@ APU_DECLARE(apr_status_t) apr_brigade_cl
  * @param b The brigade to split
  * @param e The first bucket to move
  * @param a The brigade which should be used for the result or NULL if
- *          a new brigade should be created.
+ *          a new brigade should be created. The brigade @param a will be
+ *          cleared if it is not empty.
  * @return The brigade supplied in @param a or a new one if @param a was NULL.
  * @warning Note that this function allocates a new brigade if @param a is
  * NULL so memory consumption should be carefully considered.