= [wiki:Notes]/RCSUsage ==

== Quick notes on use of the repository ==

=== Basic Usage ===
 * use the {{{mirtree}}} tool to set up a workspace.
{{{
   unix% cd /data/DISK/somewhere
   unix% mkdir miriad_cabb
   unix% cd miriad_cabb
   unix% /nfs/atapplic/miriad/linux/bin/mirtree #creates a "miriad" subdirectory
}}}
 * set the RCSINIT environment variable so it forces use of the CABB tree by default.
{{{
   unix% setenv RCSINIT "-rcabb"   # see ci(1) manpage for syntax
}}}

 * Make sure to use symbolic revision names, in general use.
 * You can use revision numbers in special cases (e.g. you are trying to reverse a checked-in change)
 * When you want to work with RCS files for a different project, you will need to unset RCSINIT
{{{
   unix% unsetenv RCSINIT
}}}

== Background ==
 * The miriad master tree lives in {{{/nfs/atapplic/miriad}}}
 * There is a branch point on the "trunk", with the symbolic name "{{{cabb_branchpoint}}}"
 * The CABB tree branches off from there. The current latest version in the branch is denoted by the symbolic name "{{{cabb}}}".
   Example:
{{{
% rlog -h /nfs/atapplic/miriad/prog/atlod.for

RCS file: /nfs/atapplic/miriad/prog/RCS/atlod.for,v
Working file: /nfs/atapplic/miriad/prog/atlod.for
head: 1.6
branch:
locks: strict
access list:
symbolic names:
   cabb: 1.6.1
   cabb_branchpoint: 1.6
keyword substitution: kv
total revisions: 53; selected revisions: 53
description:
Convert an RPFITS file into Miriad uv format.

}}}

=== See also ===
 * [wiki:Notes/Subversion]

[wiki:Notes Notes Home]