ignore

Purpose:

Ignore specified files or patterns.

Usage:

bzr ignore [NAME_PATTERN...]

Options:

--default-rules
	Display the default ignore rules that bzr uses.
-v, --verbose	Display more information.
-q, --quiet	Only display errors and warnings.
-d ARG, --directory=ARG
	Branch to operate on, instead of working directory.
--usage	Show usage message and options.
-h, --help	Show help message.

Description:

See bzr help patterns for details on the syntax of patterns.

If a .bzrignore file does not exist, the ignore command will create one and add the specified files or patterns to the newly created file. The ignore command will also automatically add the .bzrignore file to be versioned. Creating a .bzrignore file without the use of the ignore command will require an explicit add command.

To remove patterns from the ignore list, edit the .bzrignore file. After adding, editing or deleting that file either indirectly by using this command or directly by using an editor, be sure to commit it.

Bazaar also supports a global ignore file ~/.bazaar/ignore. On Windows the global ignore file can be found in the application data directory as C:Documents and Settings<user>Application DataBazaar2.0ignore. Global ignores are not touched by this command. The global ignore file can be edited directly using an editor.

Patterns prefixed with ‘!’ are exceptions to ignore patterns and take precedence over regular ignores. Such exceptions are used to specify files that should be versioned which would otherwise be ignored.

Patterns prefixed with ‘!!’ act as regular ignore patterns, but have precedence over the ‘!’ exception patterns.

Notes:

• Ignore patterns containing shell wildcards must be quoted from the shell on Unix.
• Ignore patterns starting with “#” act as comments in the ignore file. To ignore patterns that begin with that character, use the “RE:” prefix.

Examples:

Ignore the top level Makefile:

bzr ignore ./Makefile

Ignore .class files in all directories...:

bzr ignore "*.class"

...but do not ignore “special.class”:

bzr ignore "!special.class"

Ignore files whose name begins with the “#” character:

bzr ignore "RE:^#"

Ignore .o files under the lib directory:

bzr ignore "lib/**/*.o"

Ignore .o files under the lib directory:

bzr ignore "RE:lib/.*\.o"

Ignore everything but the “debian” toplevel directory:

bzr ignore "RE:(?!debian/).*"

Ignore everything except the “local” toplevel directory, but always ignore autosave files ending in ~, even under local/:

bzr ignore "*"
bzr ignore "!./local"
bzr ignore "!!*~"

See also:

ignored, patterns, status