svn commit: r1182573 - /subversion/branches/tree-read-api/BRANCH-README

[ju...@apache.org]

Author: julianfoad
Date: Wed Oct 12 20:30:42 2011
New Revision: 1182573

URL: http://svn.apache.org/viewvc?rev=1182573&view=rev
Log:
On the 'tree-read-api' branch: Add a BRANCH-README file describing the branch.

Added:
    subversion/branches/tree-read-api/BRANCH-README

Added: subversion/branches/tree-read-api/BRANCH-README
URL: http://svn.apache.org/viewvc/subversion/branches/tree-read-api/BRANCH-README?rev=1182573&view=auto
==============================================================================
--- subversion/branches/tree-read-api/BRANCH-README (added)
+++ subversion/branches/tree-read-api/BRANCH-README Wed Oct 12 20:30:42 2011
@@ -0,0 +1,19 @@
+This 'tree-read-api' branch is a feature branch to develop a new API.
+As a 'feature' branch, it is maintained by periodic 'catch-up' (aka
+'sync') merges from trunk, and may one day be reintegrated to trunk.
+
+The new API is an abstraction of a generic tree of (probably) versioned
+nodes -- files, directories and symbolic links, each node optionally
+having a set of versioned properties.  The idea is that client code that
+reads from a tree can use the same interface to read the WC base as it
+uses to read revision X in a repository.  Some examples of such client
+functionality are 'list', 'proplist', 'propget' and 'export'.
+
+If this works out and can be made efficient, it should enable existing
+libsvn_client code to be simplified and new client code to be written
+more easily.
+
+At the time of this writing, the API is in subversion/libsvn_client/tree.h,
+but I expect to move it.
+
+- Julian Foad, October 2011