svn commit: r909593 - /subversion/trunk/subversion/libsvn_wc/wc_db.h

[ne...@apache.org]

Author: neels
Date: Fri Feb 12 20:20:19 2010
New Revision: 909593

URL: http://svn.apache.org/viewvc?rev=909593&view=rev
Log:
* subversion/libsvn_wc/wc_db.h: Clarify the general comment on WRI_ABSPATH.

Modified:
    subversion/trunk/subversion/libsvn_wc/wc_db.h

Modified: subversion/trunk/subversion/libsvn_wc/wc_db.h
URL: http://svn.apache.org/viewvc/subversion/trunk/subversion/libsvn_wc/wc_db.h?rev=909593&r1=909592&r2=909593&view=diff
==============================================================================
--- subversion/trunk/subversion/libsvn_wc/wc_db.h (original)
+++ subversion/trunk/subversion/libsvn_wc/wc_db.h Fri Feb 12 20:20:19 2010
@@ -108,10 +108,16 @@
      the working copy.
 
    * WRI_ABSPATH
-     This is a "Working copy Root Indicator" path. It does not refer to a
-     specific versioned node, but rather to an implied location in the
-     local filesystem, which further implies a working copy root. The
-     given operation will be performed within the context of that root.
+     This is a "Working copy Root Indicator" path. This refers to a location
+     in the local filesystem that is anywhere inside a working copy. The given
+     operation will be performed within the context of the root of that
+     working copy. This does necessarily need to refer to a specific versioned
+     node or the root of a working copy (although it can) -- any location,
+     existing or not, is sufficient, as long as it is inside a working copy.
+     ### TODO: Define behaviour for switches and externals.
+     ### Preference has been stated that WRI_ABSPATH should imply the root
+     ### of the parent WC of all switches and externals, but that may
+     ### not play out well, especially with multiple repositories involved.
 */
 
 /** Context data structure for interacting with the administrative data. */