comparison man/files.texi @ 64828:7959083b57a2

(Comparing Files): Clarify compare-windows.
author Richard M. Stallman <rms@gnu.org>
date Tue, 09 Aug 2005 11:35:42 +0000
parents c502137f8bb7
children 3723093a21fd
comparison
equal deleted inserted replaced
64827:5be8c14584dd 64828:7959083b57a2
2916 recent backup. If you specify the name of a backup file, 2916 recent backup. If you specify the name of a backup file,
2917 @code{diff-backup} compares it with the source file that it is a backup 2917 @code{diff-backup} compares it with the source file that it is a backup
2918 of. 2918 of.
2919 2919
2920 @findex compare-windows 2920 @findex compare-windows
2921 The command @kbd{M-x compare-windows} compares the text in the current 2921 The command @kbd{M-x compare-windows} compares the text in the
2922 window with that in the next window. Comparison starts at point in each 2922 current window with that in the next window. (For more information
2923 window, and each starting position is pushed on the mark ring in its 2923 about windows in Emacs, @ref{Windows}.) Comparison starts at point in
2924 respective buffer. Then point moves forward in each window, a character 2924 each window, after pushing each initial point value on the mark ring
2925 at a time, until a mismatch between the two windows is reached. Then 2925 in its respective buffer. Then it moves point forward in each window,
2926 the command is finished. Another invocation of this command with 2926 one character at a time, until it reaches characters that don't match.
2927 points on mismatching positions tries to skip non-matching text and 2927 Then the command exits.
2928 move points forward, until a match between the two windows is reached. 2928
2929 For more information about windows in Emacs, @ref{Windows}. 2929 If point in the two windows is followed by non-matching text when
2930 the command starts, it tries heuristically to advance up to matching
2931 text in the two windows, and then exits. So if you use @kbd{M-x
2932 compare-windows} repeatedly, each time it either skips one matching
2933 range or finds the start of another.
2930 2934
2931 @vindex compare-ignore-case 2935 @vindex compare-ignore-case
2932 @vindex compare-ignore-whitespace 2936 @vindex compare-ignore-whitespace
2933 With a numeric argument, @code{compare-windows} ignores changes in 2937 With a numeric argument, @code{compare-windows} ignores changes in
2934 whitespace. If the variable @code{compare-ignore-case} is 2938 whitespace. If the variable @code{compare-ignore-case} is