bk-ignore - (unknown subject)

---

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 output 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 appending “ −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

---