annotate runtime/doc/diff.txt @ 9955:f52b263fb3f0 v7.4.2251

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