* subversion/include/private/svn_wc_private.h
(svn_wc__diff7): Document better.
@@ -2044,11 +2044,26 @@ svn_wc__acquire_write_lock_for_resolve(const char **lock_root_abspath,
/* The implemementation of svn_wc_diff6(), but reporting to a diff processor
*
- * If ROOT_RELPATH is not NULL, set *ROOT_RELPATH to the target of the diff
- * within the diff namespace. ("" or a single path component).
+ * New mode: when ROOT_RELPATH and ROOT_IS_DIR are not NULL:
*
- * If ROOT_IS_FILE is NOT NULL set it
- * the first processor call. (The anchor is LOCAL_ABSPATH or an ancestor of it)
+ * If LOCAL_ABSPATH is the WC root, set *ROOT_RELPATH to "" and send
+ * diff processor relpaths relative to LOCAL_ABSPATH; otherwise set
+ * *ROOT_RELPATH to the last component of LOCAL_ABSPATH and send diff
+ * processor relpaths relative to the parent of LOCAL_ABSPATH.
+ * (*ROOT_RELPATH will be either "" or a single path component.)
+ *
+ * Set *ROOT_IS_DIR to TRUE if the working version of LOCAL_ABSPATH is
+ * a directory, else to FALSE.
+ *
+ * Assignments to *ROOT_RELPATH and *ROOT_IS_DIR are made before the first
+ * call to DIFF_PROCESSOR.
+ *
+ * Backward compatibility mode for svn_wc_diff6(): when ROOT_RELPATH and
+ * ROOT_IS_DIR are NULL:
+ *
+ * Send diff processor relpaths relative to LOCAL_ABSPATH if it is a
+ * directory; otherwise, relative to the parent of LOCAL_ABSPATH.
+ * This matches the "anchor and target" semantics of svn_wc_diff6().
*/
svn_error_t *
svn_wc__diff7(const char **root_relpath,
