bk get(7.3ce) BitKeeper User's Manual bk get(7.3ce)
NAME
bk get - check out BitKeeper files
SYNOPSIS
bk get [options] [<file> ... | -]
ALTERNATE
bk checkout [-qT] [<file> ... | -]
DESCRIPTION
bk get is used to check out files for viewing or editing. By default,
files are checked out unlocked and read-only.
bk checkout is used to to checkout files in the repository's checkout
mode (bk get defaults to read-only, this form matches the checkout con-
fig).
OPTIONS
-A<bdnpru> Align prefix output in a human readable form. The set of
annotations will be followed by a vertical bar and a space
before the data from each line of the file starts. Each
annotation is aligned in a column. The option argument[s]
turn on one or more annotations as a prefix to each line.
The possible annotations are:
b Prefix each line with the basename of the file.
d Prefix each line with the date of last modification.
n Prefix each line with its line number.
p Prefix each line with pathname of the file relative to
the root of the repository.
r Prefix each line with the revision of last modification.
u Prefix each line the name of the user who last modified
it.
-a<bdnpru> Similar to "-A" but without the alignment.
-e Checkout the file for editing (same as bk edit).
-g Suppress the retrieval of any text; sometimes useful with
"-e".
-h Invert sense of file's hash flag.
-i<list> Include revs in <list>.
-k Don't expand RCS or SCCS keywords. "-k" is implied by "-e".
-p Write file to standard output (useful in scripts).
-P Write to stdout, forcing a check out even if the file is
corrupted (i.e., has a bad checksum).
-q Run quietly, suppressing diagnostics.
-r<rev> Get this revision (or key or changeset revision--see bk help
terms under "rev argument"). If combined with "-e" (edit),
BitKeeper checks out the tip revision combined with a set of
deltas to be included and excluded to produce the requested
revision.
-S Check out the file if and only if it is not already checked
out.
-T Set the gfile's modification time to the delta's creation
time.
-x<list> Exclude revs in <list>.
NOTE
You may not need to check out every file in order to compile your pro-
gram since most versions of the Make program will check files out as
they are needed. In order for this to work, the get command needs to
correct in the Makefile. If that is true, a simple "make" will check
out and build your product.
EXAMPLE
If you are using Gnu Make the following will check out any non-checked
out files:
JUNK := $(shell bk -Ur. -1 -^G checkout)
SEE ALSO
bk config-etc
bk edit
bk keywords
CATEGORY
Common
File
BitKeeper Inc 1E1 bk get(7.3ce)
File