/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: Aaron Bentley
  • Date: 2009-04-03 20:05:25 UTC
  • mto: This revision was merged to the branch mainline in revision 4266.
  • Revision ID: aaron@aaronbentley.com-20090403200525-5vcdyhnjrlsqd6dr
Support hidden options.

Show diffs side-by-side

added added

removed removed

Lines of Context:
6
6
``bzr help content-filters`` for general information about using these.
7
7
 
8
8
Note: Content filtering is only supported in recently added formats,
9
 
e.g. 1.14. Be sure that both the repository *and* the branch are
10
 
in a recent format. (Just setting the format on the repository
11
 
is not enough.) If content filtering does not appear to be working, use
12
 
'bzr info -v' to confirm that the branch is using "Working tree format 5"
13
 
or later.
 
9
e.g. 1.14.
14
10
 
15
 
EOL conversion needs to be enabled for selected file patterns using
 
11
EOL conversion needs to be enabled for selected branches and files using
16
12
rules. See ``bzr help rules`` for general information on defining rules.
17
 
Currently, rules are only supported in $BZR_HOME/.bazaar/rules (or
18
 
%BZR_HOME%/bazaar/2.0/rules on Windows). Branch specific rules will be
19
 
supported in a future verison of Bazaar.
20
13
 
21
14
To configure which files to filter, set ``eol`` to one of the values below.
22
15
(If a value is not set, ``exact`` is the default.)
23
16
 
24
 
 ========== ===================================== ======================
25
 
 Value      Checkout end-of-lines as              Commit end-of-lines as
26
 
 ========== ===================================== ======================
27
 
 ``native`` ``crlf`` on Windows, ``lf`` otherwise ``lf``
28
 
 ---------- ------------------------------------- ----------------------
29
 
 ``lf``     ``lf``                                ``lf``
30
 
 ---------- ------------------------------------- ----------------------
31
 
 ``crlf``   ``crlf``                              ``lf``
32
 
 ---------- ------------------------------------- ----------------------
33
 
 ``exact``  No conversion                         Exactly as in file
34
 
 ========== ===================================== ======================
 
17
 ============== ============================== ======================
 
18
 Value          Checkout end-of-lines as       Commit end-of-lines as
 
19
 ============== ============================== ======================
 
20
 native         crlf on Windows, lf otherwise  lf
 
21
 -------------- ------------------------------ ----------------------
 
22
 lf             lf                             lf
 
23
 -------------- ------------------------------ ----------------------
 
24
 crlf           crlf                           lf
 
25
 -------------- ------------------------------ ----------------------
 
26
 exact          No conversion                  exactly as in file
 
27
 ============== ============================== ======================
35
28
 
36
29
Note: For safety reasons, no conversion is applied to any file where a null
37
30
byte is detected in the file.
89
82
supported yet.)
90
83
 
91
84
If you have an existing repository with text files already stored using
92
 
Windows newline conventions (``crlf``), then you may want to keep using that
 
85
Windows newline conventions (crlf), then you may want to keep using that
93
86
convention in the repository. Forcing certain files to this convention
94
87
may also help users who do not have rules configured. To do this, set
95
88
``eol`` to one of the values below.
96
89
 
97
 
 ============================ ======================== ======================
98
 
 Value                        Checkout end-of-lines as Commit end-of-lines as
99
 
 ============================ ======================== ======================
100
 
 ``native-with-crlf-in-repo`` ``crlf`` on Windows,     ``crlf``
101
 
                              ``lf`` otherwise
102
 
 ---------------------------- ------------------------ ----------------------
103
 
 ``lf-with-crlf-in-repo``     ``lf``                   ``crlf``
104
 
 ---------------------------- ------------------------ ----------------------
105
 
 ``crlf-with-crlf-in-repo``   ``crlf``                 ``crlf``
106
 
 ============================ ======================== ======================
 
90
 ========================= ============================== ======================
 
91
 Value                     Checkout end-of-lines as       Commit end-of-lines as
 
92
 ========================= ============================== ======================
 
93
 native-with-crlf-in-repo  crlf on Windows, lf otherwise  crlf
 
94
 ------------------------- ------------------------------ ----------------------
 
95
 lf-with-crlf-in-repo      lf                             crlf
 
96
 ------------------------- ------------------------------ ----------------------
 
97
 crlf-with-crlf-in-repo    crlf                           crlf
 
98
 ========================= ============================== ======================
107
99
 
108
100
For users working on an existing project that uses Windows newline
109
101
conventions in their Bazaar repository, this rule is suggested as a
112
104
  [name *]
113
105
  eol = native-with-crlf-in-repo
114
106
 
115
 
For new projects, it is recommended that end-of-lines be stored as ``lf``
 
107
For new projects, it is recommended that end-of-lines be stored as lf
116
108
and that users stick to the basic settings, i.e. ``native``, ``lf``,
117
109
``crlf`` and ``exact``.
118
110