← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/help_topics/en/rules.txt

  • Committer: Vincent Ladeuil
  • Date: 2009-12-14 15:51:36 UTC
  • mto: (4894.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 4895.
  • Revision ID: v.ladeuil+lp@free.fr-20091214155136-rf4nkqvxda9oiw4u
Cleanup tests and tweak the text displayed.

* bzrlib/tests/blackbox/test_update.py:
Fix imports and replace the assertContainsRe with assertEqualDiff
to make the test clearer, more robust and easier to debug.

* bzrlib/tests/commands/test_update.py: 
Fix imports.

* bzrlib/tests/blackbox/test_filtered_view_ops.py: 
Fix imports and strange accesses to base class methods.
(TestViewTreeOperations.test_view_on_update): Avoid os.chdir()
call, simplify string matching assertions.

* bzrlib/builtins.py:
(cmd_update.run): Fix spurious space, get rid of the final '/' for
the base path, don't add a final period (it's a legal char in a
path and would be annoying for people that like to copy/paste).

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/help_topics/en/rules.txt
 
1
Rules
 
2
=====
 
3
 
 
4
Introduction
 
5
------------
 
6
 
 
7
Rules are defined in ini file format where the sections are file glob
 
8
patterns and the contents of each section are the preferences for files
 
9
matching that pattern(s). For example::
 
10
 
 
11
    [name *.bat]
 
12
    eol = dos
 
13
 
 
14
    [name *.html *.xml]
 
15
    keywords = xml_escape
 
16
 
 
17
Preferences like these are useful for commands and plugins wishing to
 
18
provide custom behaviour for selected files.  For more information on 
 
19
end of line conversion see ``bzr help eol``.  Keyword support is provided
 
20
by the bzr-keywords plugin (http://launchpad.net/bzr-keywords).
 
21
 
 
22
Files
 
23
-----
 
24
 
 
25
Default rules for all branches are defined in the optional file
 
26
``BZR_HOME/rules``. 
 
27
 
 
28
Rule Patterns
 
29
-------------
 
30
 
 
31
Patterns are ordered and searching stops as soon as one matches.
 
32
As a consequence, more explicit patterns should be placed towards
 
33
the top of the file. Rule patterns use exactly the same conventions
 
34
as ignore patterns. See ``bzr help patterns`` for details.
 
35
 
 
36
Note: Patterns containing square brackets or spaces should be
 
37
surrounded in quotes to ensure they are correctly parsed.