svn commit: r1675678 - /subversion/branches/move-tracking-2/subversion/include/private/svn_branch.h

[ju...@apache.org]

Author: julianfoad
Date: Thu Apr 23 16:52:32 2015
New Revision: 1675678

URL: http://svn.apache.org/r1675678
Log:
On the 'move-tracking-2' branch: Document 'EID' better.

* subversion/include/private/svn_branch.h
  (svn_branch_eid_t): Improve comments.

Modified:
    subversion/branches/move-tracking-2/subversion/include/private/svn_branch.h

Modified: subversion/branches/move-tracking-2/subversion/include/private/svn_branch.h
URL: http://svn.apache.org/viewvc/subversion/branches/move-tracking-2/subversion/include/private/svn_branch.h?rev=1675678&r1=1675677&r2=1675678&view=diff
==============================================================================
--- subversion/branches/move-tracking-2/subversion/include/private/svn_branch.h (original)
+++ subversion/branches/move-tracking-2/subversion/include/private/svn_branch.h Thu Apr 23 16:52:32 2015
@@ -46,9 +46,15 @@ extern "C" {
 /* ### */
 #define SVN_ERR_BRANCHING 123456
 
-/** Element Identifier.
+/** Element Identifier (EID).
  *
- * This does not contain an implied revision number or branch identifier.
+ * An element may appear in any or all branches, and its EID is the same in
+ * each branch in which the element appears.
+ * 
+ * By definition, an element keeps the same EID for its whole lifetime, even
+ * if deleted from all branches and later 'resurrected'.
+ * 
+ * ### In most places the code currently says 'int', verbatim.
  */
 typedef int svn_branch_eid_t;