svn commit: r948002 - /subversion/trunk/subversion/include/svn_wc.h

[ju...@apache.org]

Author: julianfoad
Date: Tue May 25 11:21:51 2010
New Revision: 948002

URL: http://svn.apache.org/viewvc?rev=948002&view=rev
Log:
* subversion/include/svn_wc.h
  (svn_wc_relocation_validator3_t, svn_wc_relocation_validator2_t,
   svn_wc_relocate4): Add questioning comments.

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

Modified: subversion/trunk/subversion/include/svn_wc.h
URL: http://svn.apache.org/viewvc/subversion/trunk/subversion/include/svn_wc.h?rev=948002&r1=948001&r2=948002&view=diff
==============================================================================
--- subversion/trunk/subversion/include/svn_wc.h (original)
+++ subversion/trunk/subversion/include/svn_wc.h Tue May 25 11:21:51 2010
@@ -6792,6 +6792,7 @@ svn_wc_upgrade(svn_wc_context_t *wc_ctx,
  * @a baton is a closure object; it should be provided by the
  * implementation, and passed by the caller.
  *
+ * ### This func has a ROOT_URL arg, not a ROOT boolean.
  * If @a root is TRUE, then the implementation should make sure that @a url
  * is the repository root.  Else, it can be an URL inside the repository.
  * @a pool may be used for temporary allocations.
@@ -6807,6 +6808,8 @@ typedef svn_error_t *(*svn_wc_relocation
 /** Similar to #svn_wc_relocation_validator3_t, but without
  * the @a root_url arguments.
  *
+ * ### What about the ROOT argument?
+ *
  * @deprecated Provided for backwards compatibility with the 1.4 API.
  */
 typedef svn_error_t *(*svn_wc_relocation_validator2_t)(void *baton,
@@ -6829,6 +6832,8 @@ typedef svn_error_t *(*svn_wc_relocation
  * The pre-change URL should be @a from, and the post-change URL will be
  * @a to.  @a validator (and its baton, @a validator_baton), will be called
  * for the newly generated base URL and calculated repo root.
+ * ### Doc string of svn_wc_relocation_validator3_t says it's called for
+ *     each file/directory. Is that so?
  *
  * If @a recurse is @c FALSE, none of the children of @a local_abspath will
  * be changed.  @a wc_ctx is an working copy context.