svn commit: r929610 - /subversion/trunk/subversion/include/svn_editor.h

[st...@apache.org]

Author: stsp
Date: Wed Mar 31 16:22:38 2010
New Revision: 929610

URL: http://svn.apache.org/viewvc?rev=929610&view=rev
Log:
* subversion/include/svn_editor.h: Ask a question about this API.

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

Modified: subversion/trunk/subversion/include/svn_editor.h
URL: http://svn.apache.org/viewvc/subversion/trunk/subversion/include/svn_editor.h?rev=929610&r1=929609&r2=929610&view=diff
==============================================================================
--- subversion/trunk/subversion/include/svn_editor.h (original)
+++ subversion/trunk/subversion/include/svn_editor.h Wed Mar 31 16:22:38 2010
@@ -859,6 +859,13 @@ svn_editor_copy(svn_editor_t *editor,
  *
  * For a description of @a replaces_rev, see svn_editor_add_file().
  *
+ * ### stsp: How would I describe a merge of revision range rA-rB,
+ * ###   within which a file foo.c was delete in rN, re-created in rM,
+ * ###   and then renamed to bar.c in rX?
+ * ###   Would the following be valid?
+ * ###   svn_editor_add_file(ed, "foo.c", props, rN);
+ * ###   svn_editor_move(ed, "foo.c", rM, "bar.c", rN);
+ *
  * For all restrictions on driving the editor, see #svn_editor_t.
  * @since New in 1.7.
  */