← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/controlling_registration.txt

  • Committer: Ian Clatworthy
  • Date: 2007-11-30 04:28:32 UTC
  • mto: (3054.1.1 ianc-integration)
  • mto: This revision was merged to the branch mainline in revision 3055.
  • Revision ID: ian.clatworthy@internode.on.net-20071130042832-6prruj0kzg3fodm8
chapter 2 tweaks

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/controlling_registration.txt
16
16
interesting and which ones are not. You can tune those rules as
17
17
explained in `Ignoring files`_ below.
18
18
 
19
 
Unlike many other VCS tools, Bazaar tracks directories as first class
 
19
Unless many other VCS tools, Bazaar tracks directories as first class
20
20
items. As a consequence, empty directories are correctly supported -
21
21
you don't need to create a dummy file inside a directory just to
22
22
ensure it gets tracked and included in project exports.
73
73
    config.h                 ./config.h
74
74
    configure.in~            *~
75
75
 
76
 
Note that ignore patterns are only matched against non-versioned files,
77
 
and control whether they are treated as "unknown" or "ignored".  If a file
78
 
is explicitly added, it remains versioned regardless of whether it matches
79
 
an ignore pattern.
 
76
It is OK to have either an ignore pattern match a versioned file, or to
 
77
add an ignored file.  Ignore patterns have no effect on versioned files;
 
78
they only determine whether unversioned files are reported as unknown or
 
79
ignored.
80
80
 
81
81
The ``.bzrignore`` file should normally be versioned, so that new copies
82
82
of the branch see the same patterns::
84
84
    % bzr add .bzrignore
85
85
    % bzr commit -m "Add ignore patterns"
86
86
 
87
 
The command ``bzr ignore PATTERN`` can be used to easily add PATTERN to
88
 
the ``.bzrignore file`` (creating it if necessary and registering it to
89
 
be tracked by Bazaar).  Removing and modifying patterns are done by
90
 
directly editing the ``.bzrignore`` file.
91
 
 
92
87
Global ignores
93
88
--------------
94
89
 
100
95
 
101
96
.. [#] On Windows, the users configuration files can be found in the
102
97
   application data directory. So instead of ``~/.bazaar/branch.conf``
103
 
   the configuration file can be found as:
 
98
   the configuration file can be found as: 
104
99
   ``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0\branch.conf``.
105
100
   The same is true for ``locations.conf``, ``ignore``, and the
106
101
   ``plugins`` directory.