← 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: Robert Collins
  • Date: 2010-04-08 04:34:03 UTC
  • mfrom: (5138 +trunk)
  • mto: This revision was merged to the branch mainline in revision 5139.
  • Revision ID: robertc@robertcollins.net-20100408043403-56z0d07vdqrx7f3t
Update bugfix for 528114 to trunk.

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
 
Unless many other VCS tools, Bazaar tracks directories as first class
 
19
Unlike 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
 
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.
 
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.
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
 
87
92
Global ignores
88
93
--------------
89
94
 
95
100
 
96
101
.. [#] On Windows, the users configuration files can be found in the
97
102
   application data directory. So instead of ``~/.bazaar/branch.conf``
98
 
   the configuration file can be found as: 
 
103
   the configuration file can be found as:
99
104
   ``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0\branch.conf``.
100
105
   The same is true for ``locations.conf``, ``ignore``, and the
101
106
   ``plugins`` directory.