14
14
To configure which files to filter, set ``eol`` to one of the values below.
15
15
(If a value is not set, ``exact`` is the default.)
17
============== ============================== ======================
18
Value Checkout end-of-lines as Commit end-of-lines as
19
============== ============================== ======================
20
native crlf on Windows, lf otherwise lf
21
-------------- ------------------------------ ----------------------
23
-------------- ------------------------------ ----------------------
25
-------------- ------------------------------ ----------------------
26
exact No conversion exactly as in file
27
============== ============================== ======================
17
========== ===================================== ======================
18
Value Checkout end-of-lines as Commit end-of-lines as
19
========== ===================================== ======================
20
``native`` ``crlf`` on Windows, ``lf`` otherwise ``lf``
21
---------- ------------------------------------- ----------------------
23
---------- ------------------------------------- ----------------------
24
``crlf`` ``crlf`` ``lf``
25
---------- ------------------------------------- ----------------------
26
``exact`` No conversion Exactly as in file
27
========== ===================================== ======================
29
29
Note: For safety reasons, no conversion is applied to any file where a null
30
30
byte is detected in the file.
84
84
If you have an existing repository with text files already stored using
85
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
86
86
convention in the repository. Forcing certain files to this convention
87
87
may also help users who do not have rules configured. To do this, set
88
88
``eol`` to one of the values below.
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
========================= ============================== ======================
90
============================ ======================== ======================
91
Value Checkout end-of-lines as Commit end-of-lines as
92
============================ ======================== ======================
93
``native-with-crlf-in-repo`` ``crlf`` on Windows, ``crlf``
95
---------------------------- ------------------------ ----------------------
96
``lf-with-crlf-in-repo`` ``lf`` ``crlf``
97
---------------------------- ------------------------ ----------------------
98
``crlf-with-crlf-in-repo`` ``crlf`` ``crlf``
99
============================ ======================== ======================
100
101
For users working on an existing project that uses Windows newline
101
102
conventions in their Bazaar repository, this rule is suggested as a
105
106
eol = native-with-crlf-in-repo
107
For new projects, it is recommended that end-of-lines be stored as lf
108
For new projects, it is recommended that end-of-lines be stored as ``lf``
108
109
and that users stick to the basic settings, i.e. ``native``, ``lf``,
109
110
``crlf`` and ``exact``.