bk edit(7.3ce)              BitKeeper User's Manual             bk edit(7.3ce)

NAME
       bk edit - check out a file for editing

SYNOPSIS
       bk edit [-q] [-r<rev>] [<file> ... | -]

DESCRIPTION
       If  a  file  is  not  locked  for writing, i.e., it is not visible in a
       directory listing or it is read-only, then use bk edit to check out the
       file and lock it, making it available for writing.

       bk edit with no options will check out all files in a directory.

OPTIONS
       -q      run quietly
       -r<rev> Edit  the  file,  rolling  it back to the contents specified by
               "rev  argument") BitKeeper will check out the tip revision com-
               bined with a set of include and exclude deltas needed  to  pro-
               duce the requested revision.

NOTES
       While it may seem like this step could be done with a simple

           $ chmod +w foo.c

       that  is  not  correct.  The reason is keyword expansion.  Keywords are
       expanded only in read-only files, they are unexpanded in locked  files.
       For  example,  if  a  file contains %M% %I%, when it is not locked that
       will look like foo.c 1.2.  If the file is modified after the chmod then
       the  keywords will forever more be foo.c 1.2, which is not likely to be
       the desired result.  One could argue  that  BitKeeper  should  try  and
       catch  this case (and it does, bk check will frequently fix it), but it
       is impossible to do so correctly in all cases.

SEE ALSO
       bk terms

CATEGORY
       File
       Common

BitKeeper Inc                         1E1                       bk edit(7.3ce)