ignore
======

:Purpose: Ignore specified files or patterns.
:Usage:   bzr ignore [NAME_PATTERN...]

:Options:
  --usage               Show usage message and options.
  --old-default-rules   Write out the ignore rules bzr < 0.9 always used.
  -v, --verbose         Display more information.
  -q, --quiet           Only display errors and warnings.
  -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.
  
  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.
  
  Note: ignore patterns containing shell wildcards must be quoted from
  the shell on Unix.

: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 .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, even under local/::
    
        bzr ignore "*"
        bzr ignore "!./local"
        bzr ignore "!!*~"

:See also: :doc:`ignored <ignored-help>`, :doc:`patterns <patterns-help>`, :doc:`status <status-help>`


