~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

Merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
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.)
16
16
 
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
 
 ============== ============================== ======================
 
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
 ========== ===================================== ======================
28
28
 
29
29
Note: For safety reasons, no conversion is applied to any file where a null
30
30
byte is detected in the file.
82
82
supported yet.)
83
83
 
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.
89
89
 
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``
 
94
                              ``lf`` otherwise
 
95
 ---------------------------- ------------------------ ----------------------
 
96
 ``lf-with-crlf-in-repo``     ``lf``                   ``crlf``
 
97
 ---------------------------- ------------------------ ----------------------
 
98
 ``crlf-with-crlf-in-repo``   ``crlf``                 ``crlf``
 
99
 ============================ ======================== ======================
99
100
 
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
104
105
  [name *]
105
106
  eol = native-with-crlf-in-repo
106
107
 
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``.
110
111