User Guide - Mks.com

Chapter 6: Member Operations
Checking In a
Member
186
When you are satisfied with the changes you have made to a member, you
should check in the member to preserve those changes as a new revision in
the member’s history. Members should be checked in on a regular basis.
checking in a member creates a new revision of a member and adds it to the
member history. When a member is checked in to a revision other than the
head revision or a branch tip revision, a new branch is created.
The author name is the name you associate with revisions upon check in. By
default, your author name is your user name.
In the Source Integrity Web interface, because sandboxes do not exist, a
source file (working file) for the member is specified and checked in as the
new revision.
Starting a Branch When Checking In a Member
Source Integrity usually places a new revision at the top of the trunk,
assigning it a two-part revision number, such as 1.15. There are times,
however, when you do not want your work to be checked into the trunk.
You may be pursuing a line of development that will not be included in the
finished product, or you may be doing post-release maintenance while
development for the next release continues on the trunk. For information
on branching, see “Branching and Merging Revisions” on page 337.
Divergent lines of development in the same archive are managed through
the use of branches. A branch is an independent revision line that uses an
existing revision as its starting point. Members of a branch revision are
identified by their revision numbers. Whereas revisions on the trunk are
characterized by two-part revision numbers (for example, 1.2 or 3.5),
branch revision numbers are prefixed with the number of the revision they
start from. For example, if a branch revision is started from revision
number 1.2, the members of that branch are numbered
1.2.1.3
1.2.1.2
1.2.1.1
and so on. The first two digits of the number identify the revision where
the branch diverges from the trunk, and the last two represent a position
on the branch.
Assigning Revision Numbers
By default, when you check in a member, Source Integrity automatically
assigns a unique revision number to the new revision. It does this by
incrementing the current revision number by one. For example, if the
previous revision is 1.3, the new revision is assigned number 1.4.
u s e r g u i d e