You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@subversion.apache.org by da...@apache.org on 2011/01/03 02:22:29 UTC
svn commit: r1054513 - /subversion/trunk/subversion/include/svn_repos.h
Author: danielsh
Date: Mon Jan 3 01:22:28 2011
New Revision: 1054513
URL: http://svn.apache.org/viewvc?rev=1054513&view=rev
Log:
Update the documentation for svn_repos_node_editor() and friends to
mention all drivers that can be used to drive the editor.
As r846201 added svn_repos_replay() as a "replacement not so much
for svn_repos_dir_delta, but for at least a whole class of
functionality that svn_repos_dir_delta was never intended to
handle." Also add a note that svn_repos_replay2() is the preferred
driver.
See this thread:
http://mid.gmane.org/AANLkTimPcE6H16HnbAxb7kRCxJXO_3NZ-FSrUdzLwtpw@mail.gmail.com
* subversion/include/svn_repos.h
(svn_repos_node_editor, svn_repos_node_from_baton): Update docstrings.
(@defgroup svn_repos_inspection): Update documentation.
Patch by: Erik Johansson <er...@ejohansson.se>
(tweaked by me)
Modified:
subversion/trunk/subversion/include/svn_repos.h
Modified: subversion/trunk/subversion/include/svn_repos.h
URL: http://svn.apache.org/viewvc/subversion/trunk/subversion/include/svn_repos.h?rev=1054513&r1=1054512&r2=1054513&view=diff
==============================================================================
--- subversion/trunk/subversion/include/svn_repos.h (original)
+++ subversion/trunk/subversion/include/svn_repos.h Mon Jan 3 01:22:28 2011
@@ -2235,20 +2235,20 @@ svn_repos_fs_change_txn_props(svn_fs_txn
/* ---------------------------------------------------------------*/
/**
- * @defgroup svn_repos_inspection Data structures and editor things for
+ * @defgroup svn_repos_inspection Data structures and editor things for \
* repository inspection.
* @{
*
- * As it turns out, the svn_repos_dir_delta2() interface can be
- * extremely useful for examining the repository, or more exactly,
- * changes to the repository. svn_repos_dir_delta2() allows for
- * differences between two trees to be described using an editor.
- *
- * By using the editor obtained from svn_repos_node_editor() with
- * svn_repos_dir_delta2(), the description of how to transform one tree
- * into another can be used to build an in-memory linked-list tree,
- * which each node representing a repository node that was changed as a
- * result of having svn_repos_dir_delta2() drive that editor.
+ * As it turns out, the svn_repos_replay2(), svn_repos_dir_delta2() and
+ * svn_repos_begin_report2() interfaces can be extremely useful for
+ * examining the repository, or more exactly, changes to the repository.
+ * These drivers allows for differences between two trees to be
+ * described using an editor.
+ *
+ * By using the editor obtained from svn_repos_node_editor() with one of
+ * the drivers mentioned above, the description of how to transform one
+ * tree into another can be used to build an in-memory linked-list tree,
+ * which each node representing a repository node that was changed.
*/
/** A node in the repository. */
@@ -2288,9 +2288,13 @@ typedef struct svn_repos_node_t
/** Set @a *editor and @a *edit_baton to an editor that, when driven by
- * svn_repos_dir_delta2(), builds an <tt>svn_repos_node_t *</tt> tree
- * representing the delta from @a base_root to @a root in @a repos's
- * filesystem.
+ * a driver such as svn_repos_replay2(), builds an <tt>svn_repos_node_t *</tt>
+ * tree representing the delta from @a base_root to @a root in @a
+ * repos's filesystem.
+ *
+ * The editor can also be driven by svn_repos_dir_delta2() or
+ * svn_repos_begin_report2(), but unless you have special needs,
+ * svn_repos_replay2() is preferred.
*
* Invoke svn_repos_node_from_baton() on @a edit_baton to obtain the root
* node afterwards.
@@ -2310,10 +2314,9 @@ svn_repos_node_editor(const svn_delta_ed
apr_pool_t *node_pool,
apr_pool_t *pool);
-/** Return the root node of the linked-list tree generated by driving
- * the editor created by svn_repos_node_editor() with
- * svn_repos_dir_delta2(), which is stored in @a edit_baton. This is
- * only really useful if used *after* the editor drive is completed.
+/** Return the root node of the linked-list tree generated by driving the
+ * editor (associated with @a edit_baton) created by svn_repos_node_editor().
+ * This is only really useful if used *after* the editor drive is completed.
*/
svn_repos_node_t *
svn_repos_node_from_baton(void *edit_baton);