4 LF) that are used in the repository and in the local working |
4 LF) that are used in the repository and in the local working |
5 directory. That way you can get CRLF line endings on Windows and LF on |
5 directory. That way you can get CRLF line endings on Windows and LF on |
6 Unix/Mac, thereby letting everybody use their OS native line endings. |
6 Unix/Mac, thereby letting everybody use their OS native line endings. |
7 |
7 |
8 The extension reads its configuration from a versioned ``.hgeol`` |
8 The extension reads its configuration from a versioned ``.hgeol`` |
9 configuration file found in the root of the working copy. The |
9 configuration file found in the root of the working directory. The |
10 ``.hgeol`` file use the same syntax as all other Mercurial |
10 ``.hgeol`` file use the same syntax as all other Mercurial |
11 configuration files. It uses two sections, ``[patterns]`` and |
11 configuration files. It uses two sections, ``[patterns]`` and |
12 ``[repository]``. |
12 ``[repository]``. |
13 |
13 |
14 The ``[patterns]`` section specifies how line endings should be |
14 The ``[patterns]`` section specifies how line endings should be |
15 converted between the working copy and the repository. The format is |
15 converted between the working directory and the repository. The format is |
16 specified by a file pattern. The first match is used, so put more |
16 specified by a file pattern. The first match is used, so put more |
17 specific patterns first. The available line endings are ``LF``, |
17 specific patterns first. The available line endings are ``LF``, |
18 ``CRLF``, and ``BIN``. |
18 ``CRLF``, and ``BIN``. |
19 |
19 |
20 Files with the declared format of ``CRLF`` or ``LF`` are always |
20 Files with the declared format of ``CRLF`` or ``LF`` are always |
49 native = LF |
49 native = LF |
50 |
50 |
51 .. note:: |
51 .. note:: |
52 |
52 |
53 The rules will first apply when files are touched in the working |
53 The rules will first apply when files are touched in the working |
54 copy, e.g. by updating to null and back to tip to touch all files. |
54 directory, e.g. by updating to null and back to tip to touch all files. |
55 |
55 |
56 The extension uses an optional ``[eol]`` section read from both the |
56 The extension uses an optional ``[eol]`` section read from both the |
57 normal Mercurial configuration files and the ``.hgeol`` file, with the |
57 normal Mercurial configuration files and the ``.hgeol`` file, with the |
58 latter overriding the former. You can use that section to control the |
58 latter overriding the former. You can use that section to control the |
59 overall behavior. There are three settings: |
59 overall behavior. There are three settings: |