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

NAME
       bk ignore - ignore shell glob patterns

SYNOPSIS
       bk ignore <glob> [<glob> ...]

DESCRIPTION
       bk  ignore  tells  BitKeeper to ignore specified files when looking for
       extra files that are not under revision control.  This affects the out-
       put  of  bk  gfiles -x and all commands that use its output, such as bk
       citool and bk extras.

       Typical things to ignore are object files, core  files,  a.out,  *.exe,
       and the like.

       Patterns  that  do  not  contain  a  slash  (`/') character are matched
       against the basename of the  file;  patterns  containing  a  slash  are
       matched  against  the  pathname of the file relative to the root of the
       repository.  Using './' at the start of a  pattern  means  the  pattern
       applies only to the repository root.

       For  example,  if you always want to ignore files named JUNK regardless
       of which directory they are in, you can say

           bk ignore JUNK

       This matches JUNK and sub/dir/JUNK but not JUNK-PRECIOUS.

       If you want to match a file in just one subdirectory, you can do

           bk ignore sub/directory/this_one

       which matches sub/directory/this_one but not other_dir/this_one.

       If you want to ignore just the JUNK file at the root of the repository,
       you can do

           bk ignore ./JUNK

       which matches JUNK but not sub/dir/JUNK.

       You can also prune certain subdirectories of your repository by append-
       ing " -prune" to the  directory  path;  no  BitKeeper  operations  will
       descend into that directory.

           bk ignore 'sub/dir/build -prune'

       Note:  It's  important  to  use the quotes as shown when using "-prune"
       because each command argument is treated as a  separate  pattern.   You
       may  use  "-prune"  only  with directory paths that are relative to the
       root of the repository.

       Pruning large non-revision controlled directory trees  that  appear  in
       your repository can significantly improve performance in some cases.

       With no arguments, bk ignore shows the current ignore list.

       The  ignore  list  is stored in the file BitKeeper/etc/ignore.  You may
       edit this file if you wish; the format is simply  one  glob  per  line.
       Editing  the  ignore  file  is  the only way to remove entries from the
       list.

       The default ignore list is

           PENDING -prune
           BitKeeper/log -prune
           BitKeeper/tmp -prune
           BitKeeper/writer -prune
           BitKeeper/readers -prune
           BitKeeper/etc/level
           BitKeeper/etc/csets-in
           BitKeeper/etc/csets-out

       The following additions are suggested:

           core
           *.o
           *.swp
           *.a
           *.exe
           *~
           *.rej
           *.orig

ADVANCED USAGE
       You may manually add additional ignore patterns on a  per  user  basis.
       For  example, if you have a tendency to have a file called "notes" that
       you never want to check in, and you also use .xxx as your  junk  files,
       then do this:

           $ echo notes >> "`bk dotbk`/ignore"
           $ echo '*.xxx' >> "`bk dotbk`/ignore"

SEE ALSO
       bk citool
       bk extras
       bk gfiles
       bk status

CATEGORY
       Admin

BitKeeper Inc                         1E1                     bk ignore(7.3ce)