Mercurial > vim
annotate runtime/doc/diff.txt @ 15492:126cdab63a83 v8.1.0754
patch 8.1.0754: preferred column is lost when setting 'cursorcolumn'
commit https://github.com/vim/vim/commit/177ab9e0262b1b3a6120bea655864ead487210e5
Author: Bram Moolenaar <Bram@vim.org>
Date: Tue Jan 15 21:12:57 2019 +0100
patch 8.1.0754: preferred column is lost when setting 'cursorcolumn'
Problem: Preferred column is lost when setting 'cursorcolumn'.
Solution: Change option flag to P_RWINONLY. (Takayuki Kurosawa,
closes #3806)
| author | Bram Moolenaar <Bram@vim.org> |
|---|---|
| date | Tue, 15 Jan 2019 21:15:05 +0100 |
| parents | 195e8b1fcbbf |
| children | dc766e1b0c95 |
| rev | line source |
|---|---|
| 13963 | 1 *diff.txt* For Vim version 8.1. Last change: 2017 Oct 03 |
| 7 | 2 |
| 3 | |
| 4 VIM REFERENCE MANUAL by Bram Moolenaar | |
| 5 | |
| 6 | |
| 7 *diff* *vimdiff* *gvimdiff* *diff-mode* | |
|
9955
f52b263fb3f0
commit https://github.com/vim/vim/commit/015efc32c1add6269099364835ddf85ff257b3c6
Christian Brabandt <cb@256bit.org>
parents:
7228
diff
changeset
|
8 This file describes the |+diff| feature: Showing differences between two to |
|
f52b263fb3f0
commit https://github.com/vim/vim/commit/015efc32c1add6269099364835ddf85ff257b3c6
Christian Brabandt <cb@256bit.org>
parents:
7228
diff
changeset
|
9 eight versions of the same file. |
| 7 | 10 |
| 11 The basics are explained in section |08.7| of the user manual. | |
| 12 | |
| 12559 | 13 1. Starting diff mode |start-vimdiff| |
| 7 | 14 2. Viewing diffs |view-diffs| |
| 15 3. Jumping to diffs |jumpto-diffs| | |
| 16 4. Copying diffs |copy-diffs| | |
| 17 5. Diff options |diff-options| | |
| 18 | |
| 19 {not in Vi} | |
| 20 | |
| 21 ============================================================================== | |
| 12559 | 22 1. Starting diff mode *start-vimdiff* |
| 7 | 23 |
| 24 The easiest way to start editing in diff mode is with the "vimdiff" command. | |
| 25 This starts Vim as usual, and additionally sets up for viewing the differences | |
| 26 between the arguments. > | |
| 27 | |
| 28 vimdiff file1 file2 [file3 [file4]] | |
| 29 | |
| 30 This is equivalent to: > | |
| 31 | |
| 32 vim -d file1 file2 [file3 [file4]] | |
| 33 | |
| 34 You may also use "gvimdiff" or "vim -d -g". The GUI is started then. | |
| 35 You may also use "viewdiff" or "gviewdiff". Vim starts in readonly mode then. | |
| 36 "r" may be prepended for restricted mode (see |-Z|). | |
| 37 | |
| 38 The second and following arguments may also be a directory name. Vim will | |
| 39 then append the file name of the first argument to the directory name to find | |
| 40 the file. | |
| 41 | |
|
14696
195e8b1fcbbf
patch 8.1.0360: using an external diff program is slow and inflexible
Christian Brabandt <cb@256bit.org>
parents:
14519
diff
changeset
|
42 By default an internal diff library will be used. When 'diffopt' or |
|
195e8b1fcbbf
patch 8.1.0360: using an external diff program is slow and inflexible
Christian Brabandt <cb@256bit.org>
parents:
14519
diff
changeset
|
43 'diffexpr' has been set an external "diff" command will be used. This only |
|
195e8b1fcbbf
patch 8.1.0360: using an external diff program is slow and inflexible
Christian Brabandt <cb@256bit.org>
parents:
14519
diff
changeset
|
44 works when such a diff program is available. |
| 7 | 45 |
| 674 | 46 Diffs are local to the current tab page |tab-page|. You can't see diffs with |
| 47 a window in another tab page. This does make it possible to have several | |
| 48 diffs at the same time, each in their own tab page. | |
| 49 | |
| 7 | 50 What happens is that Vim opens a window for each of the files. This is like |
| 51 using the |-O| argument. This uses vertical splits. If you prefer horizontal | |
| 52 splits add the |-o| argument: > | |
| 53 | |
| 1698 | 54 vimdiff -o file1 file2 [file3 [file4]] |
| 7 | 55 |
| 766 | 56 If you always prefer horizontal splits include "horizontal" in 'diffopt'. |
| 57 | |
| 7 | 58 In each of the edited files these options are set: |
| 59 | |
| 60 'diff' on | |
| 61 'scrollbind' on | |
|
2445
04dae202d316
Fixes for coverity warnings.
Bram Moolenaar <bram@vim.org>
parents:
2413
diff
changeset
|
62 'cursorbind' on |
| 7 | 63 'scrollopt' includes "hor" |
| 64 'wrap' off | |
| 65 'foldmethod' "diff" | |
| 766 | 66 'foldcolumn' value from 'diffopt', default is 2 |
| 7 | 67 |
| 68 These options are set local to the window. When editing another file they are | |
| 69 reset to the global value. | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
70 The options can still be overruled from a modeline when re-editing the file. |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
71 However, 'foldmethod' and 'wrap' won't be set from a modeline when 'diff' is |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
72 set. |
| 7 | 73 |
| 74 The differences shown are actually the differences in the buffer. Thus if you | |
| 75 make changes after loading a file, these will be included in the displayed | |
| 76 diffs. You might have to do ":diffupdate" now and then, not all changes are | |
| 77 immediately taken into account. | |
| 78 | |
| 79 In your .vimrc file you could do something special when Vim was started in | |
| 80 diff mode. You could use a construct like this: > | |
| 81 | |
| 82 if &diff | |
| 83 setup for diff mode | |
| 84 else | |
| 85 setup for non-diff mode | |
| 86 endif | |
| 87 | |
| 88 While already in Vim you can start diff mode in three ways. | |
| 89 | |
| 90 *E98* | |
| 3830 | 91 :diffs[plit] {filename} *:diffs* *:diffsplit* |
| 7 | 92 Open a new window on the file {filename}. The options are set |
| 93 as for "vimdiff" for the current and the newly opened window. | |
| 94 Also see 'diffexpr'. | |
| 95 | |
| 96 *:difft* *:diffthis* | |
| 3830 | 97 :difft[his] Make the current window part of the diff windows. This sets |
| 16 | 98 the options like for "vimdiff". |
| 7 | 99 |
| 5929 | 100 :diffp[atch] {patchfile} *E816* *:diffp* *:diffpatch* |
| 7 | 101 Use the current buffer, patch it with the diff found in |
| 102 {patchfile} and open a buffer on the result. The options are | |
| 103 set as for "vimdiff". | |
| 104 {patchfile} can be in any format that the "patch" program | |
| 105 understands or 'patchexpr' can handle. | |
| 106 Note that {patchfile} should only contain a diff for one file, | |
| 107 the current file. If {patchfile} contains diffs for other | |
| 108 files as well, the results are unpredictable. Vim changes | |
| 109 directory to /tmp to avoid files in the current directory | |
| 110 accidentally being patched. But it may still result in | |
| 111 various ".rej" files to be created. And when absolute path | |
| 112 names are present these files may get patched anyway. | |
| 113 | |
| 114 To make these commands use a vertical split, prepend |:vertical|. Examples: > | |
| 115 | |
| 116 :vert diffsplit main.c~ | |
| 117 :vert diffpatch /tmp/diff | |
| 766 | 118 |
| 119 If you always prefer a vertical split include "vertical" in 'diffopt'. | |
| 120 | |
| 7 | 121 *E96* |
|
9955
f52b263fb3f0
commit https://github.com/vim/vim/commit/015efc32c1add6269099364835ddf85ff257b3c6
Christian Brabandt <cb@256bit.org>
parents:
7228
diff
changeset
|
122 There can be up to eight buffers with 'diff' set. |
| 7 | 123 |
| 124 Since the option values are remembered with the buffer, you can edit another | |
| 125 file for a moment and come back to the same file and be in diff mode again. | |
| 16 | 126 |
| 127 *:diffo* *:diffoff* | |
|
5362
ab1508486b12
Update runtime files. Add support for J.
Bram Moolenaar <bram@vim.org>
parents:
5294
diff
changeset
|
128 :diffo[ff] Switch off diff mode for the current window. Resets related |
|
ab1508486b12
Update runtime files. Add support for J.
Bram Moolenaar <bram@vim.org>
parents:
5294
diff
changeset
|
129 options also when 'diff' was not set. |
| 16 | 130 |
| 3830 | 131 :diffo[ff]! Switch off diff mode for the current window and in all windows |
|
5362
ab1508486b12
Update runtime files. Add support for J.
Bram Moolenaar <bram@vim.org>
parents:
5294
diff
changeset
|
132 in the current tab page where 'diff' is set. Resetting |
|
ab1508486b12
Update runtime files. Add support for J.
Bram Moolenaar <bram@vim.org>
parents:
5294
diff
changeset
|
133 related options only happens in a window that has 'diff' set, |
|
ab1508486b12
Update runtime files. Add support for J.
Bram Moolenaar <bram@vim.org>
parents:
5294
diff
changeset
|
134 if the current window does not have 'diff' set then no options |
|
ab1508486b12
Update runtime files. Add support for J.
Bram Moolenaar <bram@vim.org>
parents:
5294
diff
changeset
|
135 in it are changed. |
|
10895
c391bfbdb452
Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
136 Hidden buffers are also removed from the list of diff'ed |
|
c391bfbdb452
Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
137 buffers. |
| 7 | 138 |
| 6918 | 139 The `:diffoff` command resets the relevant options to the values they had when |
| 140 using `:diffsplit`, `:diffpatch` , `:diffthis`. or starting Vim in diff mode. | |
| 141 When using `:diffoff` twice the last saved values are restored. | |
|
5161
f7add3891e95
Updated runtime files. Fix NL translations.
Bram Moolenaar <bram@vim.org>
parents:
5146
diff
changeset
|
142 Otherwise they are set to their default value: |
| 16 | 143 |
| 144 'diff' off | |
| 145 'scrollbind' off | |
|
2445
04dae202d316
Fixes for coverity warnings.
Bram Moolenaar <bram@vim.org>
parents:
2413
diff
changeset
|
146 'cursorbind' off |
| 16 | 147 'scrollopt' without "hor" |
| 148 'wrap' on | |
| 149 'foldmethod' "manual" | |
| 150 'foldcolumn' 0 | |
| 7 | 151 |
| 152 ============================================================================== | |
| 153 2. Viewing diffs *view-diffs* | |
| 154 | |
| 155 The effect is that the diff windows show the same text, with the differences | |
| 156 highlighted. When scrolling the text, the 'scrollbind' option will make the | |
| 157 text in other windows to be scrolled as well. With vertical splits the text | |
| 158 should be aligned properly. | |
| 159 | |
| 160 The alignment of text will go wrong when: | |
| 161 - 'wrap' is on, some lines will be wrapped and occupy two or more screen | |
| 162 lines | |
| 163 - folds are open in one window but not another | |
| 164 - 'scrollbind' is off | |
| 165 - changes have been made to the text | |
| 166 - "filler" is not present in 'diffopt', deleted/inserted lines makes the | |
| 167 alignment go wrong | |
| 168 | |
| 169 All the buffers edited in a window where the 'diff' option is set will join in | |
| 170 the diff. This is also possible for hidden buffers. They must have been | |
|
10895
c391bfbdb452
Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
171 edited in a window first for this to be possible. To get rid of the hidden |
|
c391bfbdb452
Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
172 buffers use `:diffoff!`. |
| 7 | 173 |
| 1121 | 174 *:DiffOrig* *diff-original-file* |
| 7 | 175 Since 'diff' is a window-local option, it's possible to view the same buffer |
| 176 in diff mode in one window and "normal" in another window. It is also | |
| 1121 | 177 possible to view the changes you have made to a buffer since the file was |
| 178 loaded. Since Vim doesn't allow having two buffers for the same file, you | |
| 179 need another buffer. This command is useful: > | |
| 2788 | 180 command DiffOrig vert new | set bt=nofile | r ++edit # | 0d_ |
| 181 \ | diffthis | wincmd p | diffthis | |
| 1121 | 182 (this is in |vimrc_example.vim|). Use ":DiffOrig" to see the differences |
| 183 between the current buffer and the file it was loaded from. | |
| 7 | 184 |
| 185 A buffer that is unloaded cannot be used for the diff. But it does work for | |
| 186 hidden buffers. You can use ":hide" to close a window without unloading the | |
| 195 | 187 buffer. If you don't want a buffer to remain used for the diff do ":set |
| 188 nodiff" before hiding it. | |
| 7 | 189 |
|
7228
873eae260c97
commit https://github.com/vim/vim/commit/b4ff518d95aa57c2f8c0568c915035bef849581b
Christian Brabandt <cb@256bit.org>
parents:
6918
diff
changeset
|
190 *:dif* *:diffupdate* |
|
873eae260c97
commit https://github.com/vim/vim/commit/b4ff518d95aa57c2f8c0568c915035bef849581b
Christian Brabandt <cb@256bit.org>
parents:
6918
diff
changeset
|
191 :dif[fupdate][!] Update the diff highlighting and folds. |
| 270 | 192 |
| 7 | 193 Vim attempts to keep the differences updated when you make changes to the |
| 194 text. This mostly takes care of inserted and deleted lines. Changes within a | |
| 195 line and more complicated changes do not cause the differences to be updated. | |
| 196 To force the differences to be updated use: > | |
| 197 | |
| 198 :diffupdate | |
| 199 | |
| 3524 | 200 If the ! is included Vim will check if the file was changed externally and |
| 201 needs to be reloaded. It will prompt for each changed file, like `:checktime` | |
| 202 was used. | |
| 7 | 203 |
| 204 Vim will show filler lines for lines that are missing in one window but are | |
| 205 present in another. These lines were inserted in another file or deleted in | |
| 206 this file. Removing "filler" from the 'diffopt' option will make Vim not | |
| 207 display these filler lines. | |
| 208 | |
| 209 | |
| 210 Folds are used to hide the text that wasn't changed. See |folding| for all | |
| 211 the commands that can be used with folds. | |
| 212 | |
| 213 The context of lines above a difference that are not included in the fold can | |
| 214 be set with the 'diffopt' option. For example, to set the context to three | |
| 215 lines: > | |
| 216 | |
| 217 :set diffopt=filler,context:3 | |
| 218 | |
| 219 | |
| 220 The diffs are highlighted with these groups: | |
| 221 | |
| 222 |hl-DiffAdd| DiffAdd Added (inserted) lines. These lines exist in | |
| 223 this buffer but not in another. | |
| 224 |hl-DiffChange| DiffChange Changed lines. | |
| 225 |hl-DiffText| DiffText Changed text inside a Changed line. Vim | |
| 226 finds the first character that is different, | |
| 227 and the last character that is different | |
| 228 (searching from the end of the line). The | |
| 229 text in between is highlighted. This means | |
| 230 that parts in the middle that are still the | |
| 12499 | 231 same are highlighted anyway. The 'diffopt' |
| 232 flags "iwhite" and "icase" are used here. | |
| 4098 | 233 |hl-DiffDelete| DiffDelete Deleted lines. Also called filler lines, |
| 7 | 234 because they don't really exist in this |
| 235 buffer. | |
| 236 | |
| 237 ============================================================================== | |
| 238 3. Jumping to diffs *jumpto-diffs* | |
| 239 | |
| 240 Two commands can be used to jump to diffs: | |
| 241 *[c* | |
| 242 [c Jump backwards to the previous start of a change. | |
| 243 When a count is used, do it that many times. | |
| 244 *]c* | |
| 245 ]c Jump forwards to the next start of a change. | |
| 246 When a count is used, do it that many times. | |
| 247 | |
| 248 It is an error if there is no change for the cursor to move to. | |
| 249 | |
| 250 ============================================================================== | |
| 251 4. Diff copying *copy-diffs* *E99* *E100* *E101* *E102* *E103* | |
| 532 | 252 *merge* |
| 7 | 253 There are two commands to copy text from one buffer to another. The result is |
| 254 that the buffers will be equal within the specified range. | |
| 255 | |
| 256 *:diffg* *:diffget* | |
| 257 :[range]diffg[et] [bufspec] | |
| 258 Modify the current buffer to undo difference with another | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
259 buffer. If [bufspec] is given, that buffer is used. If |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
260 [bufspec] refers to the current buffer then nothing happens. |
| 7 | 261 Otherwise this only works if there is one other buffer in diff |
| 262 mode. | |
| 263 See below for [range]. | |
| 264 | |
| 1121 | 265 *:diffpu* *:diffput* *E793* |
| 7 | 266 :[range]diffpu[t] [bufspec] |
| 267 Modify another buffer to undo difference with the current | |
| 268 buffer. Just like ":diffget" but the other buffer is modified | |
| 269 instead of the current one. | |
| 532 | 270 When [bufspec] is omitted and there is more than one other |
| 271 buffer in diff mode where 'modifiable' is set this fails. | |
| 7 | 272 See below for [range]. |
| 273 | |
| 274 *do* | |
| 6336 | 275 [count]do Same as ":diffget" without range. The "o" stands for "obtain" |
| 276 ("dg" can't be used, it could be the start of "dgg"!). Note: | |
| 277 this doesn't work in Visual mode. | |
| 278 If you give a [count], it is used as the [bufspec] argument | |
| 279 for ":diffget". | |
| 7 | 280 |
| 281 *dp* | |
| 6336 | 282 [count]dp Same as ":diffput" without range. Note: this doesn't work in |
| 283 Visual mode. | |
| 284 If you give a [count], it is used as the [bufspec] argument | |
| 285 for ":diffput". | |
| 2596 | 286 |
| 7 | 287 |
| 288 When no [range] is given, the diff at the cursor position or just above it is | |
| 289 affected. When [range] is used, Vim tries to only put or get the specified | |
| 290 lines. When there are deleted lines, this may not always be possible. | |
| 291 | |
| 292 There can be deleted lines below the last line of the buffer. When the cursor | |
| 293 is on the last line in the buffer and there is no diff above this line, the | |
| 294 ":diffget" and "do" commands will obtain lines from the other buffer. | |
| 295 | |
| 296 To be able to get those lines from another buffer in a [range] it's allowed to | |
| 297 use the last line number plus one. This command gets all diffs from the other | |
| 298 buffer: > | |
| 299 | |
| 300 :1,$+1diffget | |
| 301 | |
| 302 Note that deleted lines are displayed, but not counted as text lines. You | |
| 303 can't move the cursor into them. To fill the deleted lines with the lines | |
| 304 from another buffer use ":diffget" on the line below them. | |
| 819 | 305 *E787* |
| 306 When the buffer that is about to be modified is read-only and the autocommand | |
| 307 that is triggered by |FileChangedRO| changes buffers the command will fail. | |
| 308 The autocommand must not change buffers. | |
| 7 | 309 |
| 310 The [bufspec] argument above can be a buffer number, a pattern for a buffer | |
| 311 name or a part of a buffer name. Examples: | |
| 312 | |
| 313 :diffget Use the other buffer which is in diff mode | |
| 314 :diffget 3 Use buffer 3 | |
| 315 :diffget v2 Use the buffer which matches "v2" and is in | |
| 316 diff mode (e.g., "file.c.v2") | |
| 317 | |
| 318 ============================================================================== | |
| 319 5. Diff options *diff-options* | |
| 320 | |
| 321 Also see |'diffopt'| and the "diff" item of |'fillchars'|. | |
| 322 | |
| 6583 | 323 *diff-slow* *diff_translations* |
| 324 For very long lines, the diff syntax highlighting might be slow, especially | |
| 325 since it tries to match all different kind of localisations. To disable | |
| 326 localisations and speed up the syntax highlighting, set the global variable | |
| 327 g:diff_translations to zero: > | |
| 328 | |
| 329 let g:diff_translations = 0 | |
| 330 < | |
|
12756
3b26420fc639
Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents:
12559
diff
changeset
|
331 After setting this variable, reload the syntax script: > |
| 6583 | 332 |
| 333 set syntax=diff | |
| 334 < | |
| 335 | |
| 7 | 336 |
| 337 FINDING THE DIFFERENCES *diff-diffexpr* | |
| 338 | |
| 339 The 'diffexpr' option can be set to use something else than the standard | |
| 340 "diff" program to compare two files and find the differences. | |
| 341 | |
| 342 When 'diffexpr' is empty, Vim uses this command to find the differences | |
| 343 between file1 and file2: > | |
| 344 | |
| 345 diff file1 file2 > outfile | |
| 346 | |
| 347 The ">" is replaced with the value of 'shellredir'. | |
| 348 | |
|
14696
195e8b1fcbbf
patch 8.1.0360: using an external diff program is slow and inflexible
Christian Brabandt <cb@256bit.org>
parents:
14519
diff
changeset
|
349 The output of "diff" must be a normal "ed" style diff or a unified diff. Do |
|
195e8b1fcbbf
patch 8.1.0360: using an external diff program is slow and inflexible
Christian Brabandt <cb@256bit.org>
parents:
14519
diff
changeset
|
350 NOT use a context diff. This example explains the format that Vim expects for |
|
195e8b1fcbbf
patch 8.1.0360: using an external diff program is slow and inflexible
Christian Brabandt <cb@256bit.org>
parents:
14519
diff
changeset
|
351 the "ed" style diff: > |
| 7 | 352 |
| 353 1a2 | |
| 354 > bbb | |
| 355 4d4 | |
| 356 < 111 | |
| 357 7c7 | |
| 358 < GGG | |
| 359 --- | |
| 360 > ggg | |
| 361 | |
| 362 The "1a2" item appends the line "bbb". | |
| 363 The "4d4" item deletes the line "111". | |
| 3750 | 364 The "7c7" item replaces the line "GGG" with "ggg". |
| 7 | 365 |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
366 When 'diffexpr' is not empty, Vim evaluates it to obtain a diff file in the |
| 7 | 367 format mentioned. These variables are set to the file names used: |
| 368 | |
| 369 v:fname_in original file | |
| 370 v:fname_new new version of the same file | |
| 371 v:fname_out resulting diff file | |
| 372 | |
| 373 Additionally, 'diffexpr' should take care of "icase" and "iwhite" in the | |
| 374 'diffopt' option. 'diffexpr' cannot change the value of 'lines' and | |
| 375 'columns'. | |
| 376 | |
| 377 Example (this does almost the same as 'diffexpr' being empty): > | |
| 378 | |
| 379 set diffexpr=MyDiff() | |
| 380 function MyDiff() | |
| 381 let opt = "" | |
| 382 if &diffopt =~ "icase" | |
| 383 let opt = opt . "-i " | |
| 384 endif | |
| 385 if &diffopt =~ "iwhite" | |
| 386 let opt = opt . "-b " | |
| 387 endif | |
| 388 silent execute "!diff -a --binary " . opt . v:fname_in . " " . v:fname_new . | |
| 389 \ " > " . v:fname_out | |
| 14519 | 390 redraw! |
| 7 | 391 endfunction |
| 392 | |
| 393 The "-a" argument is used to force comparing the files as text, comparing as | |
| 394 binaries isn't useful. The "--binary" argument makes the files read in binary | |
| 395 mode, so that a CTRL-Z doesn't end the text on DOS. | |
| 396 | |
| 14519 | 397 The `redraw!` command may not be needed, depending on whether executing a |
| 398 shell command shows something on the display or not. | |
| 399 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
400 *E810* *E97* |
| 7 | 401 Vim will do a test if the diff output looks alright. If it doesn't, you will |
| 402 get an error message. Possible causes: | |
| 403 - The "diff" program cannot be executed. | |
| 404 - The "diff" program doesn't produce normal "ed" style diffs (see above). | |
| 405 - The 'shell' and associated options are not set correctly. Try if filtering | |
| 406 works with a command like ":!sort". | |
| 407 - You are using 'diffexpr' and it doesn't work. | |
| 639 | 408 If it's not clear what the problem is set the 'verbose' option to one or more |
| 409 to see more messages. | |
| 7 | 410 |
| 2642 | 411 The self-installing Vim for MS-Windows includes a diff program. If you don't |
| 412 have it you might want to download a diff.exe. For example from | |
| 2662 | 413 http://gnuwin32.sourceforge.net/packages/diffutils.htm. |
| 20 | 414 |
| 7 | 415 |
| 416 USING PATCHES *diff-patchexpr* | |
| 417 | |
| 418 The 'patchexpr' option can be set to use something else than the standard | |
| 419 "patch" program. | |
| 420 | |
| 421 When 'patchexpr' is empty, Vim will call the "patch" program like this: > | |
| 422 | |
| 423 patch -o outfile origfile < patchfile | |
| 424 | |
| 425 This should work fine with most versions of the "patch" program. Note that a | |
| 426 CR in the middle of a line may cause problems, it is seen as a line break. | |
| 427 | |
| 428 If the default doesn't work for you, set the 'patchexpr' to an expression that | |
| 429 will have the same effect. These variables are set to the file names used: | |
| 430 | |
| 431 v:fname_in original file | |
| 432 v:fname_diff patch file | |
| 433 v:fname_out resulting patched file | |
| 434 | |
| 435 Example (this does the same as 'patchexpr' being empty): > | |
| 436 | |
| 766 | 437 set patchexpr=MyPatch() |
| 438 function MyPatch() | |
| 7 | 439 :call system("patch -o " . v:fname_out . " " . v:fname_in . |
| 440 \ " < " . v:fname_diff) | |
| 441 endfunction | |
| 442 | |
| 443 Make sure that using the "patch" program doesn't have unwanted side effects. | |
| 444 For example, watch out for additionally generated files, which should be | |
| 445 deleted. It should just patch the file and nothing else. | |
| 446 Vim will change directory to "/tmp" or another temp directory before | |
| 447 evaluating 'patchexpr'. This hopefully avoids that files in the current | |
| 448 directory are accidentally patched. Vim will also delete files starting with | |
| 449 v:fname_in and ending in ".rej" and ".orig". | |
| 450 | |
| 14421 | 451 vim:tw=78:ts=8:noet:ft=help:norl: |