include/private/svn_branch.h

100  * each branch in which the element appears.
159 /* Create a new branch txn object.
180 /* Return the branch whose id is BRANCH_ID in TXN.
184  * Note: a branch id is, in behavioural terms, an arbitrary token. In the
186  * root EIDs leading to the branch, but that may be changed in future.
207 /** Open for writing, either a new branch or an existing branch.
209  * When creating a new branch, declare its root element id to be ROOT_EID. Do
213  * tree. It overwrites any existing tree, even if the branch was already
216  * If TREE_REF is null, then the initial tree is empty for a new branch
217  * (not already present in the txn), or the branch's current tree if the
218  * branch was already present (readable or mutable) in the txn.
226  * This method returns a mutable 'branch state' object which is a part of
229  * ### When opening ('finding') an existing branch, ROOT_EID should match
286  *      branch 1: (root-EID=100)
289  *      branch 2: (root-EID=100)
293  * However, the root element of one branch may correspond to a non-root
294  * element of another branch.
297  * /trunk/D (which is not itself a branch root) results in:
299  *      branch 3: (root-EID=104)
302  *          EID 104 => /branches/branch-of-trunk-subtree-D
306 /* Methods (conceptually public, but called indirectly) for a branch state.
310 /* Private data for a branch state.
314 /* A branch state.
316  * A branch state object describes one version of one branch.
328   /* The branch identifier (starting with 'B') */
331   /* The revision to which this branch state belongs */
338 /* Create a new branch state object.
346 /* Get the full id of branch BRANCH.
349  *      B<top-level-branch-num>[.<1st-level-eid>[.<2nd-level-eid>[...]]]
351  * Note: a branch id is, in behavioural terms, an arbitrary token. In the
353  * root EIDs leading to the branch, but that may be changed in future.
358 svn_branch__get_id(const svn_branch__state_t *branch,
364 svn_branch__root_eid(const svn_branch__state_t *branch);
366 /* Return the id of the branch nested in OUTER_BID at element OUTER_EID.
368  * For a top-level branch, OUTER_BID is null and OUTER_EID is the
369  * top-level branch number.
372  * of the fact that nested branch ids are predictable based on the nesting
380 /* Given a nested branch id BID, set *OUTER_BID to the outer branch's id
381  * and *OUTER_EID to the nesting element in the outer branch.
383  * For a top-level branch, set *OUTER_BID to NULL and *OUTER_EID to the
384  * top-level branch number.
387  * of the fact that nested branch ids are predictable based on the nesting
396 /* Remove the branch with id BID from the list of branches in TXN.
406   /* The branch state that applies to REV. */
407   svn_branch__state_t *branch;
411      ### Do we need this if BRANCH refers to a particular branch-revision? */
416 /* Revision-branch-element id. */
421   /* The branch id in revision REV. */
428 /* Revision-branch id. */
433   /* The branch id in revision REV. */
442 svn_branch__el_rev_id_create(svn_branch__state_t *branch,
481   /* The immediate parents of this state in the branch/merge graph.
497 /* Return the mapping of elements in branch BRANCH.
500 svn_branch__state_get_elements(const svn_branch__state_t *branch,
509 svn_branch__state_get_element(const svn_branch__state_t *branch,
520 svn_branch__state_set_element(svn_branch__state_t *branch,
525 /** Specify that the element of @a branch identified by @a eid shall not
529  * final 'flattening' of a branch state into a single tree, each element
533  * The element @a eid must not be the root element of @a branch.
563 svn_branch__state_delete_one(svn_branch__state_t *branch,
567 /** Specify the tree position and payload of the element of @a branch
577  *   exists in the branch               =>  altering it;
578  *   previously existed in the branch   =>  resurrecting it;
583  * For example, if it existed previously in this branch and another, then
586  * Duplicate @a new_name and @a new_payload into the branch's pool.
589 svn_branch__state_alter_one(svn_branch__state_t *branch,
597 svn_branch__state_copy_tree(svn_branch__state_t *branch,
606 svn_branch__state_purge(svn_branch__state_t *branch,
612 svn_branch__state_get_history(svn_branch__state_t *branch,
619 svn_branch__state_set_history(svn_branch__state_t *branch,
623 /* Return the branch-relative path of element EID in BRANCH.
630 svn_branch__get_path_by_eid(const svn_branch__state_t *branch,
634 /* Return the EID for the branch-relative path PATH in BRANCH.
641 svn_branch__get_eid_by_path(const svn_branch__state_t *branch,
671                             svn_branch__state_t *branch,