You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@subversion.apache.org by ju...@apache.org on 2015/04/28 19:22:43 UTC

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

Author: julianfoad
Date: Tue Apr 28 17:22:43 2015
New Revision: 1676580

URL: http://svn.apache.org/r1676580
Log:
On the 'move-tracking-2' branch: Add a comment about branch ids being
arbitrary.

* subversion/include/private/svn_branch.h,
  (svn_branch_revision_root_get_branch_by_id,
   svn_branch_get_id): Add a comment and a cross-reference.

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=1676580&r1=1676579&r2=1676580&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 Tue Apr 28 17:22:43 2015
@@ -137,6 +137,12 @@ svn_branch_revision_root_get_branches(sv
 /* Return the branch whose id is BRANCH_ID in REV_ROOT.
  *
  * Return NULL if not found.
+ *
+ * Note: a branch id is, in behavioural terms, an arbitrary token. In the
+ * current implementation it is constructed from the hierarchy of subbranch
+ * root EIDs leading to the branch, but that may be changed in future.
+ *
+ * See also: svn_branch_get_id().
  */
 svn_branch_state_t *
 svn_branch_revision_root_get_branch_by_id(const svn_branch_revision_root_t *rev_root,
@@ -645,6 +651,12 @@ svn_branch_branch_into(svn_branch_state_
                        apr_pool_t *scratch_pool);
 
 /* Get the full id of branch BRANCH.
+ *
+ * Note: a branch id is, in behavioural terms, an arbitrary token. In the
+ * current implementation it is constructed from the hierarchy of subbranch
+ * root EIDs leading to the branch, but that may be changed in future.
+ *
+ * See also: svn_branch_revision_root_get_branch_by_id().
  */
 const char *
 svn_branch_get_id(svn_branch_state_t *branch,