Author: danielsh
Date: Wed Jan 11 05:39:31 2012
New Revision: 1229896

URL: http://svn.apache.org/viewvc?rev=1229896&view=rev
Log:
Improve docstrings for svn_delta_editor_t's absent_(file|directory) callbacks.

* subversion/include/svn_delta.h
  (svn_delta_editor_t): the absent_file() and absent_directory()
   callbacks will *only* be invoked due to authz
   restrictions; state this clearly in the docstrings.

Patch by: Trent Nelson <[email protected]>

Modified:
    subversion/trunk/subversion/include/svn_delta.h

Modified: subversion/trunk/subversion/include/svn_delta.h
URL: 
http://svn.apache.org/viewvc/subversion/trunk/subversion/include/svn_delta.h?rev=1229896&r1=1229895&r2=1229896&view=diff
==============================================================================
--- subversion/trunk/subversion/include/svn_delta.h (original)
+++ subversion/trunk/subversion/include/svn_delta.h Wed Jan 11 05:39:31 2012
@@ -916,8 +916,9 @@ typedef struct svn_delta_editor_t
 
   /** In the directory represented by @a parent_baton, indicate that
    * @a path is present as a subdirectory in the edit source, but
-   * cannot be conveyed to the edit consumer (perhaps because of
-   * authorization restrictions).
+   * cannot be conveyed to the edit consumer.  Currently, this would
+   * only occur because of authorization restrictions, but may change
+   * in the future.
    *
    * Any temporary allocations may be performed in @a scratch_pool.
    */
@@ -1040,8 +1041,9 @@ typedef struct svn_delta_editor_t
 
   /** In the directory represented by @a parent_baton, indicate that
    * @a path is present as a file in the edit source, but cannot be
-   * conveyed to the edit consumer (perhaps because of authorization
-   * restrictions).
+   * cannot be conveyed to the edit consumer.  Currently, this would
+   * only occur because of authorization restrictions, but may change
+   * in the future.
    *
    * Any temporary allocations may be performed in @a scratch_pool.
    */


Reply via email to