bk gate(7.3ce) BitKeeper User's Manual bk gate(7.3ce)
NAME
bk gate - set or show the gate status of a nested collection
SYNOPSIS
bk gate [-q] .
bk gate [-q] -r
DESCRIPTION
The bk gate command either reports whether the nested collection is a
gate or it changes that nested collection to be a gate.
A gate repository is part of BitKeeper's product line functionality. A
gate is an instance of a nested collection in which changesets are con-
sidered "safe", they will not be removed or collapsed. Similarly the
set of components that are populated will not be unpopulated.
The gate concept exists to allow bk pull to run in --unsafe mode by
default when pulling from a gate. This allows developers to work with
sparse repositories (where not all components are populated) while
guaranteeing that work will never be lost.
With an argument of ".", it marks the nested collection as a gate.
With no argument, the command prints the gate status. With -q, the
exit status indicates gate status; 0 means it is, 1 means it is not.
RESTRICTIONS
Inside of a gate, commands that would remove information are disal-
lowed. bk undo, bk collapse, bk unpopulate are examples of such com-
mands. It is common that many other clones depend on the gate to be a
"safe" container of changes so removing information is not allowed by
default.
If it happens that a changeset gets pushed to a gate that really must
be removed, then remove the gate status, undo (or unpull) the change-
set, and put the gate status back.
OPTIONS
-r Unmark the nested collection as a gate.
-q Run silently.
SEE ALSO
bk portal
bk pull
CATEGORY
Nested
BitKeeper Inc 1E1 bk gate(7.3ce)
Nested