[Subversion Wiki] Update of "TreeApi" by JulianFoad

[Apache subversion Wiki <co...@subversion.apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Subversion Wiki" for change notification.

The "TreeApi" page has been changed by JulianFoad:
http://wiki.apache.org/subversion/TreeApi

New page:
= Introduction =

== Tree Classes ==
=== svn_tree_t ===
Abstract representation of a tree of ''svn_tree_node_t''.

This object presents an interface for referring to, accessing and traversing a tree, usually a versioned tree, of the kind of nodes that Subversion versions.

A tree always has a root node: a completely empty tree is not allowed.

An implementation of this interface could represent, among other trees:

 * a tree in some revision of a repository,
 * the base or working version of a Working Copy tree,
 * an unversioned tree on disk (presumably without properties),
 * a temporary tree in memory, constructed on the fly.

==== Methods: ====
 * find node by relpath

=== svn_tree_node_t ===
Abstract representation of a tree node.

 * Each node is a file, a directory or a symbolic link, and has a set of properties.

==== Attributes: ====
 * relpath (relative to root of the tree)
 * kind (dir, file, symlink)

==== Methods: ====
 * read props
 * read children -> list of ''svn_tree_node_t''
 * read text

== Operations On Trees ==
 * Walk a tree -- visit each directory or each node
 * Walk two trees in parallel