1 ;;; diff-mode.el --- a mode for viewing/editing context diffs -*- lexical-binding: t -*-
3 ;; Copyright (C) 1998-2017 Free Software Foundation, Inc.
5 ;; Author: Stefan Monnier <monnier@iro.umontreal.ca>
6 ;; Keywords: convenience patch diff vc
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software: you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation, either version 3 of the License, or
13 ;; (at your option) any later version.
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
25 ;; Provides support for font-lock, outline, navigation
26 ;; commands, editing and various conversions as well as jumping
27 ;; to the corresponding source file.
29 ;; Inspired by Pavel Machek's patch-mode.el (<pavel@@atrey.karlin.mff.cuni.cz>)
30 ;; Some efforts were spent to have it somewhat compatible with XEmacs's
31 ;; diff-mode as well as with compilation-minor-mode
35 ;; - Reverse doesn't work with normal diffs.
39 ;; - Improve `diff-add-change-log-entries-other-window',
40 ;; it is very simplistic now.
42 ;; - Add a `delete-after-apply' so C-c C-a automatically deletes hunks.
43 ;; Also allow C-c C-a to delete already-applied hunks.
45 ;; - Try `diff <file> <hunk>' to try and fuzzily discover the source location
46 ;; of a hunk. Show then the changes between <file> and <hunk> and make it
47 ;; possible to apply them to <file>, <hunk-src>, or <hunk-dst>.
48 ;; Or maybe just make it into a ".rej to diff3-markers converter".
49 ;; Maybe just use `wiggle' (by Neil Brown) to do it for us.
51 ;; - in diff-apply-hunk, strip context in replace-match to better
52 ;; preserve markers and spacing.
53 ;; - Handle `diff -b' output in context->unified.
56 (eval-when-compile (require 'cl-lib
))
58 (defvar add-log-buffer-file-name-function
)
61 (defgroup diff-mode
()
62 "Major mode for viewing/editing diffs."
67 (defcustom diff-default-read-only nil
68 "If non-nil, `diff-mode' buffers default to being read-only."
72 (defcustom diff-jump-to-old-file nil
73 "Non-nil means `diff-goto-source' jumps to the old file.
74 Else, it jumps to the new file."
78 (defcustom diff-update-on-the-fly t
79 "Non-nil means hunk headers are kept up-to-date on-the-fly.
80 When editing a diff file, the line numbers in the hunk headers
81 need to be kept consistent with the actual diff. This can
82 either be done on the fly (but this sometimes interacts poorly with the
83 undo mechanism) or whenever the file is written (can be slow
84 when editing big diffs)."
88 (defcustom diff-advance-after-apply-hunk t
89 "Non-nil means `diff-apply-hunk' will move to the next hunk after applying."
93 (defcustom diff-mode-hook nil
94 "Run after setting up the `diff-mode' major mode."
96 :options
'(diff-delete-empty-files diff-make-unified
)
99 (defvar diff-vc-backend nil
100 "The VC backend that created the current Diff buffer, if any.")
102 (defvar diff-outline-regexp
103 "\\([*+][*+][*+] [^0-9]\\|@@ ...\\|\\*\\*\\* [0-9].\\|--- [0-9]..\\)")
106 ;;;; keymap, menu, ...
109 (easy-mmode-defmap diff-mode-shared-map
110 '(("n" . diff-hunk-next
)
111 ("N" . diff-file-next
)
112 ("p" . diff-hunk-prev
)
113 ("P" . diff-file-prev
)
114 ("\t" . diff-hunk-next
)
115 ([backtab] . diff-hunk-prev)
116 ("k" . diff-hunk-kill)
117 ("K" . diff-file-kill)
118 ("}" . diff-file-next) ; From compilation-minor-mode.
119 ("{" . diff-file-prev)
120 ("\C-m" . diff-goto-source)
121 ([mouse-2] . diff-goto-source)
123 ("o" . diff-goto-source) ; other-window
124 ("A" . diff-ediff-patch)
125 ("r" . diff-restrict-view)
126 ("R" . diff-reverse-direction)
127 ([remap undo] . diff-undo))
128 "Basic keymap for `diff-mode', bound to various prefix keys."
129 :inherit special-mode-map)
131 (easy-mmode-defmap diff-mode-map
132 `(("\e" . ,(let ((map (make-sparse-keymap)))
133 ;; We want to inherit most bindings from diff-mode-shared-map,
134 ;; but not all since they may hide useful M-<foo> global
135 ;; bindings when editing.
136 (set-keymap-parent map diff-mode-shared-map)
137 (dolist (key '("A" "r" "R" "g" "q" "W" "z"))
138 (define-key map key nil))
140 ;; From compilation-minor-mode.
141 ("\C-c\C-c" . diff-goto-source)
142 ;; By analogy with the global C-x 4 a binding.
143 ("\C-x4A" . diff-add-change-log-entries-other-window)
145 ("\C-c\C-a" . diff-apply-hunk)
146 ("\C-c\C-e" . diff-ediff-patch)
147 ("\C-c\C-n" . diff-restrict-view)
148 ("\C-c\C-s" . diff-split-hunk)
149 ("\C-c\C-t" . diff-test-hunk)
150 ("\C-c\C-r" . diff-reverse-direction)
151 ("\C-c\C-u" . diff-context->unified)
152 ;; `d' because it duplicates the context :-( --Stef
153 ("\C-c\C-d" . diff-unified->context)
154 ("\C-c\C-w" . diff-ignore-whitespace-hunk)
155 ("\C-c\C-b" . diff-refine-hunk) ;No reason for `b' :-(
156 ("\C-c\C-f" . next-error-follow-minor-mode))
157 "Keymap for `diff-mode'. See also `diff-mode-shared-map'.")
159 (easy-menu-define diff-mode-menu diff-mode-map
160 "Menu for `diff-mode'."
162 ["Jump to Source" diff-goto-source
163 :help "Jump to the corresponding source line"]
164 ["Apply hunk" diff-apply-hunk
165 :help "Apply the current hunk to the source file and go to the next"]
166 ["Test applying hunk" diff-test-hunk
167 :help "See whether it's possible to apply the current hunk"]
168 ["Apply diff with Ediff" diff-ediff-patch
169 :help "Call `ediff-patch-file' on the current buffer"]
170 ["Create Change Log entries" diff-add-change-log-entries-other-window
171 :help "Create ChangeLog entries for the changes in the diff buffer"]
173 ["Reverse direction" diff-reverse-direction
174 :help "Reverse the direction of the diffs"]
175 ["Context -> Unified" diff-context->unified
176 :help "Convert context diffs to unified diffs"]
177 ["Unified -> Context" diff-unified->context
178 :help "Convert unified diffs to context diffs"]
179 ;;["Fixup Headers" diff-fixup-modifs (not buffer-read-only)]
180 ["Remove trailing whitespace" diff-delete-trailing-whitespace
181 :help "Remove trailing whitespace problems introduced by the diff"]
182 ["Show trailing whitespace" whitespace-mode
183 :style toggle :selected (bound-and-true-p whitespace-mode)
184 :help "Show trailing whitespace in modified lines"]
186 ["Split hunk" diff-split-hunk
187 :active (diff-splittable-p)
188 :help "Split the current (unified diff) hunk at point into two hunks"]
189 ["Ignore whitespace changes" diff-ignore-whitespace-hunk
190 :help "Re-diff the current hunk, ignoring whitespace differences"]
191 ["Highlight fine changes" diff-refine-hunk
192 :help "Highlight changes of hunk at point at a finer granularity"]
193 ["Kill current hunk" diff-hunk-kill
194 :help "Kill current hunk"]
195 ["Kill current file's hunks" diff-file-kill
196 :help "Kill all current file's hunks"]
198 ["Previous Hunk" diff-hunk-prev
199 :help "Go to the previous count'th hunk"]
200 ["Next Hunk" diff-hunk-next
201 :help "Go to the next count'th hunk"]
202 ["Previous File" diff-file-prev
203 :help "Go to the previous count'th file"]
204 ["Next File" diff-file-next
205 :help "Go to the next count'th file"]
208 (defcustom diff-minor-mode-prefix "\C-c="
209 "Prefix key for `diff-minor-mode' commands."
210 :type '(choice (string "\e") (string "C-c=") string)
213 (easy-mmode-defmap diff-minor-mode-map
214 `((,diff-minor-mode-prefix . ,diff-mode-shared-map))
215 "Keymap for `diff-minor-mode'. See also `diff-mode-shared-map'.")
217 (define-minor-mode diff-auto-refine-mode
218 "Toggle automatic diff hunk highlighting (Diff Auto Refine mode).
219 With a prefix argument ARG, enable Diff Auto Refine mode if ARG
220 is positive, and disable it otherwise. If called from Lisp,
221 enable the mode if ARG is omitted or nil.
223 Diff Auto Refine mode is a buffer-local minor mode used with
224 `diff-mode'. When enabled, Emacs automatically highlights
225 changes in detail as the user visits hunks. When transitioning
226 from disabled to enabled, it tries to refine the current hunk, as
228 :group 'diff-mode :init-value t :lighter nil ;; " Auto-Refine"
229 (when diff-auto-refine-mode
230 (condition-case-unless-debug nil (diff-refine-hunk) (error nil))))
233 ;;;; font-lock support
237 '((((class color) (min-colors 88) (background light))
238 :background "grey80")
239 (((class color) (min-colors 88) (background dark))
240 :background "grey45")
242 :foreground "blue1" :weight bold)
244 "`diff-mode' face inherited by hunk and index header faces."
247 (defface diff-file-header
248 '((((class color) (min-colors 88) (background light))
249 :background "grey70" :weight bold)
250 (((class color) (min-colors 88) (background dark))
251 :background "grey60" :weight bold)
253 :foreground "cyan" :weight bold)
254 (t :weight bold)) ; :height 1.3
255 "`diff-mode' face used to highlight file header lines."
259 '((t :inherit diff-file-header))
260 "`diff-mode' face used to highlight index header lines."
263 (defface diff-hunk-header
264 '((t :inherit diff-header))
265 "`diff-mode' face used to highlight hunk header lines."
268 (defface diff-removed
270 :inherit diff-changed)
271 (((class color) (min-colors 88) (background light))
272 :background "#ffdddd")
273 (((class color) (min-colors 88) (background dark))
274 :background "#553333")
277 "`diff-mode' face used to highlight removed lines."
282 :inherit diff-changed)
283 (((class color) (min-colors 88) (background light))
284 :background "#ddffdd")
285 (((class color) (min-colors 88) (background dark))
286 :background "#335533")
288 :foreground "green"))
289 "`diff-mode' face used to highlight added lines."
292 (defface diff-changed
294 "`diff-mode' face used to highlight changed lines."
298 (defface diff-indicator-removed
299 '((t :inherit diff-removed))
300 "`diff-mode' face used to highlight indicator of removed lines (-, <)."
303 (defvar diff-indicator-removed-face 'diff-indicator-removed)
305 (defface diff-indicator-added
306 '((t :inherit diff-added))
307 "`diff-mode' face used to highlight indicator of added lines (+, >)."
310 (defvar diff-indicator-added-face 'diff-indicator-added)
312 (defface diff-indicator-changed
313 '((t :inherit diff-changed))
314 "`diff-mode' face used to highlight indicator of changed lines."
317 (defvar diff-indicator-changed-face 'diff-indicator-changed)
319 (defface diff-function
320 '((t :inherit diff-header))
321 "`diff-mode' face used to highlight function names produced by \"diff -p\"."
324 (defface diff-context
325 '((((class color grayscale) (min-colors 88) (background light))
326 :foreground "#333333")
327 (((class color grayscale) (min-colors 88) (background dark))
328 :foreground "#dddddd"))
329 "`diff-mode' face used to highlight context and other side-information."
333 (defface diff-nonexistent
334 '((t :inherit diff-file-header))
335 "`diff-mode' face used to highlight nonexistent files in recursive diffs."
338 (defconst diff-yank-handler '(diff-yank-function))
339 (defun diff-yank-function (text)
340 ;; FIXME: the yank-handler is now called separately on each piece of text
341 ;; with a yank-handler property, so the next-single-property-change call
342 ;; below will always return nil :-( --stef
343 (let ((mixed (next-single-property-change 0 'yank-handler text))
345 ;; First insert the text.
347 ;; If the text does not include any diff markers and if we're not
348 ;; yanking back into a diff-mode buffer, get rid of the prefixes.
349 (unless (or mixed (derived-mode-p 'diff-mode))
350 (undo-boundary) ; Just in case the user wanted the prefixes.
351 (let ((re (save-excursion
352 (if (re-search-backward "^[><!][ \t]" start t)
353 (if (eq (char-after) ?!)
354 "^[!+- ][ \t]" "^[<>][ \t]")
357 (while (re-search-backward re start t)
358 (replace-match "" t t)))))))
360 (defconst diff-hunk-header-re-unified
361 "^@@ -\\([0-9]+\\)\\(?:,\\([0-9]+\\)\\)? \\+\\([0-9]+\\)\\(?:,\\([0-9]+\\)\\)? @@")
362 (defconst diff-context-mid-hunk-header-re
363 "--- \\([0-9]+\\)\\(?:,\\([0-9]+\\)\\)? ----$")
365 (defvar diff-use-changed-face (and (face-differs-from-default-p 'diff-changed)
366 (not (face-equal 'diff-changed 'diff-added))
367 (not (face-equal 'diff-changed 'diff-removed)))
368 "If non-nil, use the face `diff-changed' for changed lines in context diffs.
369 Otherwise, use the face `diff-removed' for removed lines,
370 and the face `diff-added' for added lines.")
372 (defvar diff-font-lock-keywords
373 `((,(concat "\\(" diff-hunk-header-re-unified "\\)\\(.*\\)$")
374 (1 'diff-hunk-header) (6 'diff-function))
375 ("^\\(\\*\\{15\\}\\)\\(.*\\)$" ;context
376 (1 'diff-hunk-header) (2 'diff-function))
377 ("^\\*\\*\\* .+ \\*\\*\\*\\*". 'diff-hunk-header) ;context
378 (,diff-context-mid-hunk-header-re . 'diff-hunk-header) ;context
379 ("^[0-9,]+[acd][0-9,]+$" . 'diff-hunk-header) ;normal
380 ("^---$" . 'diff-hunk-header) ;normal
381 ;; For file headers, accept files with spaces, but be careful to rule
382 ;; out false-positives when matching hunk headers.
383 ("^\\(---\\|\\+\\+\\+\\|\\*\\*\\*\\) \\([^\t\n]+?\\)\\(?:\t.*\\| \\(\\*\\*\\*\\*\\|----\\)\\)?\n"
385 (2 (if (not (match-end 3)) 'diff-file-header) prepend))
386 ("^\\([-<]\\)\\(.*\n\\)"
387 (1 diff-indicator-removed-face) (2 'diff-removed))
388 ("^\\([+>]\\)\\(.*\n\\)"
389 (1 diff-indicator-added-face) (2 'diff-added))
390 ("^\\(!\\)\\(.*\n\\)"
391 (1 (if diff-use-changed-face
392 diff-indicator-changed-face
393 ;; Otherwise, search for `diff-context-mid-hunk-header-re' and
394 ;; if the line of context diff is above, use `diff-removed';
395 ;; if below, use `diff-added'.
397 (let ((limit (save-excursion (diff-beginning-of-hunk))))
398 (if (save-excursion (re-search-backward diff-context-mid-hunk-header-re limit t))
399 diff-indicator-added-face
400 diff-indicator-removed-face)))))
401 (2 (if diff-use-changed-face
403 ;; Otherwise, use the same method as above.
405 (let ((limit (save-excursion (diff-beginning-of-hunk))))
406 (if (save-excursion (re-search-backward diff-context-mid-hunk-header-re limit t))
409 ("^\\(?:Index\\|revno\\): \\(.+\\).*\n"
410 (0 'diff-header) (1 'diff-index prepend))
411 ("^Only in .*\n" . 'diff-nonexistent)
413 (1 font-lock-comment-delimiter-face)
414 (2 font-lock-comment-face))
415 ("^[^-=+*!<>#].*\n" (0 'diff-context))))
417 (defconst diff-font-lock-defaults
418 '(diff-font-lock-keywords t nil nil nil (font-lock-multiline . nil)))
420 (defvar diff-imenu-generic-expression
421 ;; Prefer second name as first is most likely to be a backup or
422 ;; version-control name. The [\t\n] at the end of the unidiff pattern
423 ;; catches Debian source diff files (which lack the trailing date).
424 '((nil "\\+\\+\\+\\ \\([^\t\n]+\\)[\t\n]" 1) ; unidiffs
425 (nil "^--- \\([^\t\n]+\\)\t.*\n\\*" 1))) ; context diffs
431 (defvar diff-valid-unified-empty-line t
432 "If non-nil, empty lines are valid in unified diffs.
433 Some versions of diff replace all-blank context lines in unified format with
434 empty lines. This makes the format less robust, but is tolerated.
435 See http://lists.gnu.org/archive/html/emacs-devel/2007-11/msg01990.html")
437 (defconst diff-hunk-header-re
438 (concat "^\\(?:" diff-hunk-header-re-unified ".*\\|\\*\\{15\\}.*\n\\*\\*\\* .+ \\*\\*\\*\\*\\|[0-9]+\\(,[0-9]+\\)?[acd][0-9]+\\(,[0-9]+\\)?\\)$"))
439 (defconst diff-file-header-re (concat "^\\(--- .+\n\\+\\+\\+ \\|\\*\\*\\* .+\n--- \\|[^-+!<>0-9@* \n]\\).+\n" (substring diff-hunk-header-re 1)))
441 (defconst diff-separator-re "^--+ ?$")
443 (defvar diff-narrowed-to nil)
445 (defun diff-hunk-style (&optional style)
446 (when (looking-at diff-hunk-header-re)
447 (setq style (cdr (assq (char-after) '((?@ . unified) (?* . context)))))
448 (goto-char (match-end 0)))
451 (defun diff-end-of-hunk (&optional style donttrustheader)
452 "Advance to the end of the current hunk, and return its position."
454 (when (looking-at diff-hunk-header-re)
455 ;; Especially important for unified (because headers are ambiguous).
456 (setq style (diff-hunk-style style))
457 (goto-char (match-end 0))
458 (when (and (not donttrustheader) (match-end 2))
459 (let* ((nold (string-to-number (or (match-string 2) "1")))
460 (nnew (string-to-number (or (match-string 4) "1")))
463 (re-search-forward (if diff-valid-unified-empty-line
466 (line-beginning-position
467 ;; Skip potential "\ No newline at end of file".
468 (if (looking-at ".*\n\\\\") 3 2))))
470 ;; The hunk may end with a bunch of "+" lines, so the `end' is
471 ;; then further than computed above.
473 (re-search-forward (if diff-valid-unified-empty-line
476 (line-beginning-position
477 ;; Skip potential "\ No newline at end of file".
478 (if (looking-at ".*\n\\\\") 3 2)))))
479 (setq end (max endold endnew)))))
480 ;; We may have a first evaluation of `end' thanks to the hunk header.
482 (setq end (and (re-search-forward
485 (concat (if diff-valid-unified-empty-line
486 "^[^-+# \\\n]\\|" "^[^-+# \\]\\|")
487 ;; A `unified' header is ambiguous.
488 diff-file-header-re))
489 (`context "^[^-+#! \\]")
490 (`normal "^[^<>#\\]")
493 (match-beginning 0)))
494 (when diff-valid-unified-empty-line
495 ;; While empty lines may be valid inside hunks, they are also likely
496 ;; to be unrelated to the hunk.
497 (goto-char (or end (point-max)))
498 (while (eq ?\n (char-before (1- (point))))
500 (setq end (point)))))
501 ;; The return value is used by easy-mmode-define-navigation.
502 (goto-char (or end (point-max)))))
504 ;; "index ", "old mode", "new mode", "new file mode" and
505 ;; "deleted file mode" are output by git-diff.
506 (defconst diff-file-junk-re
507 (concat "Index: \\|Prereq: \\|=\\{20,\\}\\|" ; SVN
508 "diff \\|index \\|\\(?:deleted file\\|new\\(?: file\\)?\\|old\\) mode\\|=== modified file"))
510 ;; If point is in a diff header, then return beginning
511 ;; of hunk position otherwise return nil.
512 (defun diff--at-diff-header-p ()
513 "Return non-nil if point is inside a diff header."
514 (let ((regexp-hunk diff-hunk-header-re)
515 (regexp-file diff-file-header-re)
516 (regexp-junk diff-file-junk-re)
521 (when (looking-at regexp-hunk) ; Hunk header.
522 (throw 'headerp (point)))
524 (when (re-search-forward regexp-file (point-at-eol 4) t) ; File header.
526 (throw 'headerp (point)))
529 (when (looking-at regexp-junk) ; Git diff junk.
530 (while (and (looking-at regexp-junk)
533 (re-search-forward regexp-file nil t)
535 (throw 'headerp (point)))) nil)))
537 (defun diff-beginning-of-hunk (&optional try-harder)
538 "Move back to the previous hunk beginning, and return its position.
539 If point is in a file header rather than a hunk, advance to the
540 next hunk if TRY-HARDER is non-nil; otherwise signal an error."
542 (if (looking-at diff-hunk-header-re) ; At hunk header.
544 (let ((pos (diff--at-diff-header-p))
545 (regexp diff-hunk-header-re))
546 (cond (pos ; At junk diff header.
549 (error "Can't find the beginning of the hunk")))
550 ((re-search-backward regexp nil t)) ; In the middle of a hunk.
551 ((re-search-forward regexp nil t) ; At first hunk header.
554 (t (error "Can't find the beginning of the hunk"))))))
556 (defun diff-unified-hunk-p ()
559 (diff-beginning-of-hunk)
560 (looking-at "^@@"))))
562 (defun diff-beginning-of-file ()
564 (unless (looking-at diff-file-header-re)
565 (let ((start (point))
567 ;; diff-file-header-re may need to match up to 4 lines, so in case
568 ;; we're inside the header, we need to move up to 3 lines forward.
570 (if (and (setq res (re-search-backward diff-file-header-re nil t))
571 ;; Maybe the 3 lines forward were too much and we matched
572 ;; a file header after our starting point :-(
573 (or (<= (point) start)
574 (setq res (re-search-backward diff-file-header-re nil t))))
577 (error "Can't find the beginning of the file")))))
580 (defun diff-end-of-file ()
581 (re-search-forward "^[-+#!<>0-9@* \\]" nil t)
582 (re-search-forward (concat "^[^-+#!<>0-9@* \\]\\|" diff-file-header-re)
584 (if (match-beginning 1)
585 (goto-char (match-beginning 1))
586 (beginning-of-line)))
588 (defvar diff--auto-refine-data nil)
590 ;; Define diff-{hunk,file}-{prev,next}
591 (easy-mmode-define-navigation
592 diff-hunk diff-hunk-header-re "hunk" diff-end-of-hunk diff-restrict-view
593 (when diff-auto-refine-mode
594 (unless (prog1 diff--auto-refine-data
595 (setq diff--auto-refine-data
596 (cons (current-buffer) (point-marker))))
599 (when diff--auto-refine-data
600 (let ((buffer (car diff--auto-refine-data))
601 (point (cdr diff--auto-refine-data)))
602 (setq diff--auto-refine-data nil)
604 (when (buffer-live-p buffer)
605 (with-current-buffer buffer
608 (diff-refine-hunk))))))))))))
610 (easy-mmode-define-navigation
611 diff-file diff-file-header-re "file" diff-end-of-file)
613 (defun diff-bounds-of-hunk ()
614 "Return the bounds of the diff hunk at point.
615 The return value is a list (BEG END), which are the hunk's start
616 and end positions. Signal an error if no hunk is found. If
617 point is in a file header, return the bounds of the next hunk."
620 (beg (diff-beginning-of-hunk t))
621 (end (diff-end-of-hunk)))
624 ;; If this hunk ends above POS, consider the next hunk.
625 ((re-search-forward diff-hunk-header-re nil t)
626 (list (match-beginning 0) (diff-end-of-hunk)))
627 (t (error "No hunk found"))))))
629 (defun diff-bounds-of-file ()
630 "Return the bounds of the file segment at point.
631 The return value is a list (BEG END), which are the segment's
632 start and end positions."
635 (beg (progn (diff-beginning-of-file-and-junk)
638 ;; bzr puts a newline after the last hunk.
639 (while (looking-at "^\n")
642 (error "Not inside a file diff"))
643 (list beg (point)))))
645 (defun diff-restrict-view (&optional arg)
646 "Restrict the view to the current hunk.
647 If the prefix ARG is given, restrict the view to the current file instead."
649 (apply 'narrow-to-region
650 (if arg (diff-bounds-of-file) (diff-bounds-of-hunk)))
651 (set (make-local-variable 'diff-narrowed-to) (if arg 'file 'hunk)))
653 (defun diff--some-hunks-p ()
655 (goto-char (point-min))
656 (re-search-forward diff-hunk-header-re nil t)))
658 (defun diff-hunk-kill ()
659 "Kill the hunk at point."
661 (if (not (diff--some-hunks-p))
663 (diff-beginning-of-hunk t)
664 (let* ((hunk-bounds (diff-bounds-of-hunk))
665 (file-bounds (ignore-errors (diff-bounds-of-file)))
666 ;; If the current hunk is the only one for its file, kill the
668 (bounds (if (and file-bounds
669 (progn (goto-char (car file-bounds))
670 (= (progn (diff-hunk-next) (point))
672 (progn (goto-char (cadr hunk-bounds))
673 ;; bzr puts a newline after the last hunk.
674 (while (looking-at "^\n")
676 (= (point) (cadr file-bounds))))
679 (inhibit-read-only t))
680 (apply 'kill-region bounds)
681 (goto-char (car bounds))
682 (ignore-errors (diff-beginning-of-hunk t)))))
684 (defun diff-beginning-of-file-and-junk ()
685 "Go to the beginning of file-related diff-info.
686 This is like `diff-beginning-of-file' except it tries to skip back over leading
687 data such as \"Index: ...\" and such."
688 (let* ((orig (point))
689 ;; Skip forward over what might be "leading junk" so as to get
690 ;; closer to the actual diff.
691 (_ (progn (beginning-of-line)
692 (while (looking-at diff-file-junk-re)
695 (prevfile (condition-case err
696 (save-excursion (diff-beginning-of-file) (point))
698 (err (if (consp prevfile) prevfile))
699 (nextfile (ignore-errors
701 (goto-char start) (diff-file-next) (point))))
702 ;; prevhunk is one of the limits.
703 (prevhunk (save-excursion
705 (if (numberp prevfile) (goto-char prevfile))
706 (diff-hunk-prev) (point))))
707 (previndex (save-excursion
708 (forward-line 1) ;In case we're looking at "Index:".
709 (re-search-backward "^Index: " prevhunk t))))
710 ;; If we're in the junk, we should use nextfile instead of prevfile.
711 (if (and (numberp nextfile)
712 (or (not (numberp prevfile))
713 (and previndex (> previndex prevfile))))
714 (setq prevfile nextfile))
715 (if (and previndex (numberp prevfile) (< previndex prevfile))
716 (setq prevfile previndex))
717 (if (and (numberp prevfile) (<= prevfile start))
720 ;; Now skip backward over the leading junk we may have before the
722 (while (save-excursion
723 (and (zerop (forward-line -1))
724 (looking-at diff-file-junk-re)))
726 ;; File starts *after* the starting point: we really weren't in
727 ;; a file diff but elsewhere.
729 (signal (car err) (cdr err)))))
731 (defun diff-file-kill ()
732 "Kill current file's hunks."
734 (if (not (diff--some-hunks-p))
736 (diff-beginning-of-hunk t)
737 (let ((inhibit-read-only t))
738 (apply 'kill-region (diff-bounds-of-file)))
739 (ignore-errors (diff-beginning-of-hunk t))))
741 (defun diff-kill-junk ()
742 "Kill spurious empty diffs."
745 (let ((inhibit-read-only t))
746 (goto-char (point-min))
747 (while (re-search-forward (concat "^\\(Index: .*\n\\)"
748 "\\([^-+!* <>].*\n\\)*?"
749 "\\(\\(Index:\\) \\|"
750 diff-file-header-re "\\)")
752 (delete-region (if (match-end 4) (match-beginning 0) (match-end 1))
754 (beginning-of-line)))))
756 (defun diff-count-matches (re start end)
760 (while (re-search-forward re end t) (cl-incf n))
763 (defun diff-splittable-p ()
766 (and (looking-at "^[-+ ]")
767 (progn (forward-line -1) (looking-at "^[-+ ]"))
768 (diff-unified-hunk-p))))
770 (defun diff-split-hunk ()
771 "Split the current (unified diff) hunk at point into two hunks."
775 (start (diff-beginning-of-hunk)))
776 (unless (looking-at diff-hunk-header-re-unified)
777 (error "diff-split-hunk only works on unified context diffs"))
779 (let* ((start1 (string-to-number (match-string 1)))
780 (start2 (string-to-number (match-string 3)))
781 (newstart1 (+ start1 (diff-count-matches "^[- \t]" (point) pos)))
782 (newstart2 (+ start2 (diff-count-matches "^[+ \t]" (point) pos)))
783 (inhibit-read-only t))
785 ;; Hopefully the after-change-function will not screw us over.
786 (insert "@@ -" (number-to-string newstart1) ",1 +"
787 (number-to-string newstart2) ",1 @@\n")
788 ;; Fix the original hunk-header.
789 (diff-fixup-modifs start pos))))
793 ;;;; jump to other buffers
796 (defvar diff-remembered-files-alist nil)
797 (defvar diff-remembered-defdir nil)
799 (defun diff-filename-drop-dir (file)
800 (when (string-match "/" file) (substring file (match-end 0))))
802 (defun diff-merge-strings (ancestor from to)
803 "Merge the diff between ANCESTOR and FROM into TO.
804 Returns the merged string if successful or nil otherwise.
805 The strings are assumed not to contain any \"\\n\" (i.e. end of line).
806 If ANCESTOR = FROM, returns TO.
807 If ANCESTOR = TO, returns FROM.
808 The heuristic is simplistic and only really works for cases
809 like \(diff-merge-strings \"b/foo\" \"b/bar\" \"/a/c/foo\")."
811 ;; AMB ANB CMD -> CND
812 ;; but that's ambiguous if `foo' or `bar' is empty:
813 ;; a/foo a/foo1 b/foo.c -> b/foo1.c but not 1b/foo.c or b/foo.c1
814 (let ((str (concat ancestor "\n" from "\n" to)))
815 (when (and (string-match (concat
816 "\\`\\(.*?\\)\\(.*\\)\\(.*\\)\n"
818 "\\(.*\\(\\2\\).*\\)\\'") str)
819 (equal to (match-string 5 str)))
820 (concat (substring str (match-beginning 5) (match-beginning 6))
822 (substring str (match-end 6) (match-end 5))))))
824 (defun diff-tell-file-name (old name)
825 "Tell Emacs where the find the source file of the current hunk.
826 If the OLD prefix arg is passed, tell the file NAME of the old file."
828 (let* ((old current-prefix-arg)
829 (fs (diff-hunk-file-names current-prefix-arg)))
830 (unless fs (error "No file name to look for"))
831 (list old (read-file-name (format "File for %s: " (car fs))
832 nil (diff-find-file-name old 'noprompt) t))))
833 (let ((fs (diff-hunk-file-names old)))
834 (unless fs (error "No file name to look for"))
835 (push (cons fs name) diff-remembered-files-alist)))
837 (defun diff-hunk-file-names (&optional old)
838 "Give the list of file names textually mentioned for the current hunk."
840 (unless (looking-at diff-file-header-re)
841 (or (ignore-errors (diff-beginning-of-file))
842 (re-search-forward diff-file-header-re nil t)))
843 (let ((limit (save-excursion
845 (progn (diff-hunk-prev) (point))
846 (error (point-min)))))
848 ;; handle filenames with spaces;
849 ;; cf. diff-font-lock-keywords / diff-file-header
850 (if (looking-at "[-*][-*][-*] \\([^\t\n]+\\).*\n[-+][-+][-+] \\([^\t\n]+\\)")
851 (list (if old (match-string 1) (match-string 2))
852 (if old (match-string 2) (match-string 1)))
853 (forward-line 1) nil)))
858 (re-search-backward "^Index: \\(.+\\)" limit t)))
859 (list (match-string 1)))
861 ;; this assumes that there are no spaces in filenames
862 (when (re-search-backward
863 "^diff \\(-\\S-+ +\\)*\\(\\S-+\\)\\( +\\(\\S-+\\)\\)?"
865 (list (if old (match-string 2) (match-string 4))
866 (if old (match-string 4) (match-string 2)))))))))
868 (defun diff-find-file-name (&optional old noprompt prefix)
869 "Return the file corresponding to the current patch.
870 Non-nil OLD means that we want the old file.
871 Non-nil NOPROMPT means to prefer returning nil than to prompt the user.
872 PREFIX is only used internally: don't use it."
873 (unless (equal diff-remembered-defdir default-directory)
874 ;; Flush diff-remembered-files-alist if the default-directory is changed.
875 (set (make-local-variable 'diff-remembered-defdir) default-directory)
876 (set (make-local-variable 'diff-remembered-files-alist) nil))
880 (unless (looking-at diff-file-header-re)
881 (or (ignore-errors (diff-beginning-of-file))
882 (re-search-forward diff-file-header-re nil t)))
883 (let ((fs (diff-hunk-file-names old)))
884 (if prefix (setq fs (mapcar (lambda (f) (concat prefix f)) fs)))
886 ;; use any previously used preference
887 (cdr (assoc fs diff-remembered-files-alist))
888 ;; try to be clever and use previous choices as an inspiration
889 (cl-dolist (rf diff-remembered-files-alist)
890 (let ((newfile (diff-merge-strings (caar rf) (car fs) (cdr rf))))
891 (if (and newfile (file-exists-p newfile)) (cl-return newfile))))
892 ;; look for each file in turn. If none found, try again but
893 ;; ignoring the first level of directory, ...
894 (cl-do* ((files fs (delq nil (mapcar 'diff-filename-drop-dir files)))
897 (setq file (cl-do* ((files files (cdr files))
898 (file (car files) (car files)))
899 ;; Use file-regular-p to avoid
900 ;; /dev/null, directories, etc.
901 ((or (null file) (file-regular-p file))
904 ;; <foo>.rej patches implicitly apply to <foo>
905 (and (string-match "\\.rej\\'" (or buffer-file-name ""))
906 (let ((file (substring buffer-file-name 0 (match-beginning 0))))
907 (when (file-exists-p file) file)))
908 ;; If we haven't found the file, maybe it's because we haven't paid
909 ;; attention to the PCL-CVS hint.
911 (boundp 'cvs-pcl-cvs-dirchange-re)
913 (re-search-backward cvs-pcl-cvs-dirchange-re nil t))
914 (diff-find-file-name old noprompt (match-string 1)))
915 ;; if all else fails, ask the user
917 (let ((file (expand-file-name (or (car fs) ""))))
919 (read-file-name (format "Use file %s: " file)
920 (file-name-directory file) file t
921 (file-name-nondirectory file)))
922 (set (make-local-variable 'diff-remembered-files-alist)
923 (cons (cons fs file) diff-remembered-files-alist))
927 (defun diff-ediff-patch ()
928 "Call `ediff-patch-file' on the current buffer."
931 (ediff-patch-file nil (current-buffer))
932 (wrong-number-of-arguments (ediff-patch-file))))
935 ;;;; Conversion functions
938 ;;(defvar diff-inhibit-after-change nil
939 ;; "Non-nil means inhibit `diff-mode's after-change functions.")
941 (defun diff-unified->context (start end)
942 "Convert unified diffs to context diffs.
943 START and END are either taken from the region (if a prefix arg is given) or
944 else cover the whole buffer."
945 (interactive (if (or current-prefix-arg (use-region-p))
946 (list (region-beginning) (region-end))
947 (list (point-min) (point-max))))
948 (unless (markerp end) (setq end (copy-marker end t)))
949 (let (;;(diff-inhibit-after-change t)
950 (inhibit-read-only t))
953 (while (and (re-search-forward
954 (concat "^\\(\\(---\\) .+\n\\(\\+\\+\\+\\) .+\\|"
955 diff-hunk-header-re-unified ".*\\)$")
958 (combine-after-change-calls
959 (if (match-beginning 2)
960 ;; we matched a file header
962 ;; use reverse order to make sure the indices are kept valid
963 (replace-match "---" t t nil 3)
964 (replace-match "***" t t nil 2))
965 ;; we matched a hunk header
966 (let ((line1 (match-string 4))
967 (lines1 (or (match-string 5) "1"))
968 (line2 (match-string 6))
969 (lines2 (or (match-string 7) "1"))
970 ;; Variables to use the special undo function.
971 (old-undo buffer-undo-list)
972 (old-end (marker-position end))
973 (start (match-beginning 0))
976 (concat "***************\n*** " line1 ","
977 (number-to-string (+ (string-to-number line1)
978 (string-to-number lines1)
982 (narrow-to-region (line-beginning-position 2)
983 ;; Call diff-end-of-hunk from just before
984 ;; the hunk header so it can use the hunk
986 (progn (diff-end-of-hunk 'unified) (point)))
987 (let ((hunk (buffer-string)))
988 (goto-char (point-min))
989 (if (not (save-excursion (re-search-forward "^-" nil t)))
990 (delete-region (point) (point-max))
991 (goto-char (point-max))
992 (let ((modif nil) last-pt)
993 (while (progn (setq last-pt (point))
994 (= (forward-line -1) 0))
996 (?\s (insert " ") (setq modif nil) (backward-char 1))
997 (?+ (delete-region (point) last-pt) (setq modif t))
999 (progn (forward-char 1)
1004 (?\\ (when (save-excursion (forward-line -1)
1005 (= (char-after) ?+))
1006 (delete-region (point) last-pt)
1008 ;; diff-valid-unified-empty-line.
1009 (?\n (insert " ") (setq modif nil)
1011 (_ (setq modif nil))))))
1012 (goto-char (point-max))
1014 (insert "--- " line2 ","
1015 (number-to-string (+ (string-to-number line2)
1016 (string-to-number lines2)
1019 ;;(goto-char (point-min))
1021 (if (not (save-excursion (re-search-forward "^+" nil t)))
1022 (delete-region (point) (point-max))
1023 (let ((modif nil) (delete nil))
1024 (if (save-excursion (re-search-forward "^\\+.*\n-"
1026 ;; Normally, lines in a substitution come with
1027 ;; first the removals and then the additions, and
1028 ;; the context->unified function follows this
1029 ;; convention, of course. Yet, other alternatives
1030 ;; are valid as well, but they preclude the use of
1031 ;; context->unified as an undo command.
1032 (setq reversible nil))
1035 (?\s (insert " ") (setq modif nil) (backward-char 1))
1036 (?- (setq delete t) (setq modif t))
1038 (progn (forward-char 1)
1043 (?\\ (when (save-excursion (forward-line 1)
1045 (setq delete t) (setq modif t)))
1046 ;; diff-valid-unified-empty-line.
1047 (?\n (insert " ") (setq modif nil) (backward-char 2)
1048 (setq reversible nil))
1049 (_ (setq modif nil)))
1050 (let ((last-pt (point)))
1053 (delete-region last-pt (point))
1054 (setq delete nil)))))))
1055 (unless (or (not reversible) (eq buffer-undo-list t))
1056 ;; Drop the many undo entries and replace them with
1057 ;; a single entry that uses diff-context->unified to do
1059 (setq buffer-undo-list
1060 (cons (list 'apply (- old-end end) start (point-max)
1061 'diff-context->unified start (point-max))
1064 (defun diff-context->unified (start end &optional to-context)
1065 "Convert context diffs to unified diffs.
1066 START and END are either taken from the region
1067 \(when it is highlighted) or else cover the whole buffer.
1068 With a prefix argument, convert unified format to context format."
1069 (interactive (if (use-region-p)
1070 (list (region-beginning) (region-end) current-prefix-arg)
1071 (list (point-min) (point-max) current-prefix-arg)))
1073 (diff-unified->context start end)
1074 (unless (markerp end) (setq end (copy-marker end t)))
1075 (let ( ;;(diff-inhibit-after-change t)
1076 (inhibit-read-only t))
1079 (while (and (re-search-forward "^\\(\\(\\*\\*\\*\\) .+\n\\(---\\) .+\\|\\*\\{15\\}.*\n\\*\\*\\* \\([0-9]+\\),\\(-?[0-9]+\\) \\*\\*\\*\\*\\)\\(?: \\(.*\\)\\|$\\)" nil t)
1081 (combine-after-change-calls
1082 (if (match-beginning 2)
1083 ;; we matched a file header
1085 ;; use reverse order to make sure the indices are kept valid
1086 (replace-match "+++" t t nil 3)
1087 (replace-match "---" t t nil 2))
1088 ;; we matched a hunk header
1089 (let ((line1s (match-string 4))
1090 (line1e (match-string 5))
1091 (pt1 (match-beginning 0))
1092 ;; Variables to use the special undo function.
1093 (old-undo buffer-undo-list)
1094 (old-end (marker-position end))
1095 ;; We currently throw away the comment that can follow
1096 ;; the hunk header. FIXME: Preserve it instead!
1097 (reversible (not (match-end 6))))
1099 (unless (re-search-forward
1100 diff-context-mid-hunk-header-re nil t)
1101 (error "Can't find matching `--- n1,n2 ----' line"))
1102 (let ((line2s (match-string 1))
1103 (line2e (match-string 2))
1105 (delete-region (progn (beginning-of-line) (point))
1106 (progn (forward-line 1) (point)))
1110 (while (< (point) pt2)
1112 (?! (delete-char 2) (insert "-") (forward-line 1))
1113 (?- (forward-char 1) (delete-char 1) (forward-line 1))
1114 (?\s ;merge with the other half of the chunk
1117 (goto-char pt2) (forward-line 1) (point))))
1118 (pcase (char-after pt2)
1122 (buffer-substring (+ pt2 2) endline2)
1123 (delete-region pt2 endline2))))
1125 (unless (= (- endline2 pt2)
1126 (- (line-beginning-position 2) (point)))
1127 ;; If the two lines we're merging don't have the
1128 ;; same length (can happen with "diff -b"), then
1129 ;; diff-unified->context will not properly undo
1131 (setq reversible nil))
1132 (delete-region pt2 endline2)
1135 (?\\ (forward-line 1))
1136 (_ (setq reversible nil)
1137 (delete-char 1) (forward-line 1)))))
1138 (_ (setq reversible nil) (forward-line 1))))
1139 (while (looking-at "[+! ] ")
1140 (if (/= (char-after) ?!) (forward-char 1)
1141 (delete-char 1) (insert "+"))
1142 (delete-char 1) (forward-line 1))
1145 (insert "@@ -" line1s ","
1146 (number-to-string (- (string-to-number line1e)
1147 (string-to-number line1s)
1150 (number-to-string (- (string-to-number line2e)
1151 (string-to-number line2s)
1153 (set-marker pt2 nil)
1154 ;; The whole procedure succeeded, let's replace the myriad
1155 ;; of undo elements with just a single special one.
1156 (unless (or (not reversible) (eq buffer-undo-list t))
1157 (setq buffer-undo-list
1158 (cons (list 'apply (- old-end end) pt1 (point)
1159 'diff-unified->context pt1 (point))
1163 (defun diff-reverse-direction (start end)
1164 "Reverse the direction of the diffs.
1165 START and END are either taken from the region (if a prefix arg is given) or
1166 else cover the whole buffer."
1167 (interactive (if (or current-prefix-arg (use-region-p))
1168 (list (region-beginning) (region-end))
1169 (list (point-min) (point-max))))
1170 (unless (markerp end) (setq end (copy-marker end t)))
1171 (let (;;(diff-inhibit-after-change t)
1172 (inhibit-read-only t))
1175 (while (and (re-search-forward "^\\(\\([-*][-*][-*] \\)\\(.+\\)\n\\([-+][-+][-+] \\)\\(.+\\)\\|\\*\\{15\\}.*\n\\*\\*\\* \\(.+\\) \\*\\*\\*\\*\\|@@ -\\([0-9,]+\\) \\+\\([0-9,]+\\) @@.*\\)$" nil t)
1177 (combine-after-change-calls
1180 ((match-beginning 2) (replace-match "\\2\\5\n\\4\\3" nil))
1181 ;; a context-diff hunk header
1182 ((match-beginning 6)
1183 (let ((pt-lines1 (match-beginning 6))
1184 (lines1 (match-string 6)))
1185 (replace-match "" nil nil nil 6)
1187 (let ((half1s (point)))
1188 (while (looking-at "[-! \\][ \t]\\|#")
1189 (when (= (char-after) ?-) (delete-char 1) (insert "+"))
1191 (let ((half1 (delete-and-extract-region half1s (point))))
1192 (unless (looking-at diff-context-mid-hunk-header-re)
1194 (error "Can't find matching `--- n1,n2 ----' line"))
1195 (let* ((str1end (or (match-end 2) (match-end 1)))
1196 (str1 (buffer-substring (match-beginning 1) str1end)))
1199 (delete-region (match-beginning 1) str1end)
1201 (let ((half2s (point)))
1202 (while (looking-at "[!+ \\][ \t]\\|#")
1203 (when (= (char-after) ?+) (delete-char 1) (insert "-"))
1205 (let ((half2 (delete-and-extract-region half2s (point))))
1206 (insert (or half1 ""))
1208 (insert (or half2 ""))))
1209 (goto-char pt-lines1)
1211 ;; a unified-diff hunk header
1212 ((match-beginning 7)
1213 (replace-match "@@ -\\8 +\\7 @@" nil)
1215 (let ((c (char-after)) first last)
1216 (while (pcase (setq c (char-after))
1217 (?- (setq first (or first (point)))
1218 (delete-char 1) (insert "+") t)
1219 (?+ (setq last (or last (point)))
1220 (delete-char 1) (insert "-") t)
1222 (_ (when (and first last (< first last))
1223 (insert (delete-and-extract-region first last)))
1224 (setq first nil last nil)
1225 (memq c (if diff-valid-unified-empty-line
1226 '(?\s ?\n) '(?\s)))))
1227 (forward-line 1))))))))))
1229 (defun diff-fixup-modifs (start end)
1230 "Fixup the hunk headers (in case the buffer was modified).
1231 START and END are either taken from the region (if a prefix arg is given) or
1232 else cover the whole buffer."
1233 (interactive (if (or current-prefix-arg (use-region-p))
1234 (list (region-beginning) (region-end))
1235 (list (point-min) (point-max))))
1236 (let ((inhibit-read-only t))
1238 (goto-char end) (diff-end-of-hunk nil 'donttrustheader)
1239 (let ((plus 0) (minus 0) (space 0) (bang 0))
1240 (while (and (= (forward-line -1) 0) (<= start (point)))
1241 (if (not (looking-at
1242 (concat diff-hunk-header-re-unified
1243 "\\|[-*][-*][-*] [0-9,]+ [-*][-*][-*][-*]$"
1244 "\\|--- .+\n\\+\\+\\+ ")))
1246 (?\s (cl-incf space))
1248 (?- (cl-incf minus))
1251 (?\n (if diff-valid-unified-empty-line
1253 (setq space 0 plus 0 minus 0 bang 0)))
1254 (_ (setq space 0 plus 0 minus 0 bang 0)))
1256 ((looking-at diff-hunk-header-re-unified)
1257 (let* ((old1 (match-string 2))
1258 (old2 (match-string 4))
1259 (new1 (number-to-string (+ space minus)))
1260 (new2 (number-to-string (+ space plus))))
1262 (unless (string= new2 old2) (replace-match new2 t t nil 4))
1263 (goto-char (match-end 3))
1266 (unless (string= new1 old1) (replace-match new1 t t nil 2))
1267 (goto-char (match-end 1))
1268 (insert "," new1))))
1269 ((looking-at diff-context-mid-hunk-header-re)
1270 (when (> (+ space bang plus) 0)
1271 (let* ((old1 (match-string 1))
1272 (old2 (match-string 2))
1273 (new (number-to-string
1274 (+ space bang plus -1 (string-to-number old1)))))
1275 (unless (string= new old2) (replace-match new t t nil 2)))))
1276 ((looking-at "\\*\\*\\* \\([0-9]+\\),\\(-?[0-9]*\\) \\*\\*\\*\\*$")
1277 (when (> (+ space bang minus) 0)
1278 (let* ((old (match-string 1))
1280 (concat "%0" (number-to-string (length old)) "d")
1281 (+ space bang minus -1 (string-to-number old)))))
1282 (unless (string= new old) (replace-match new t t nil 2))))))
1283 (setq space 0 plus 0 minus 0 bang 0)))))))
1289 (defun diff-write-contents-hooks ()
1290 "Fixup hunk headers if necessary."
1291 (if (buffer-modified-p) (diff-fixup-modifs (point-min) (point-max)))
1294 ;; It turns out that making changes in the buffer from within an
1295 ;; *-change-function is asking for trouble, whereas making them
1296 ;; from a post-command-hook doesn't pose much problems
1297 (defvar diff-unhandled-changes nil)
1298 (defun diff-after-change-function (beg end _len)
1299 "Remember to fixup the hunk header.
1300 See `after-change-functions' for the meaning of BEG, END and LEN."
1301 ;; Ignoring changes when inhibit-read-only is set is strictly speaking
1302 ;; incorrect, but it turns out that inhibit-read-only is normally not set
1303 ;; inside editing commands, while it tends to be set when the buffer gets
1304 ;; updated by an async process or by a conversion function, both of which
1305 ;; would rather not be uselessly slowed down by this hook.
1306 (when (and (not undo-in-progress) (not inhibit-read-only))
1307 (if diff-unhandled-changes
1308 (setq diff-unhandled-changes
1309 (cons (min beg (car diff-unhandled-changes))
1310 (max end (cdr diff-unhandled-changes))))
1311 (setq diff-unhandled-changes (cons beg end)))))
1313 (defun diff-post-command-hook ()
1314 "Fixup hunk headers if necessary."
1315 (when (consp diff-unhandled-changes)
1318 (goto-char (car diff-unhandled-changes))
1319 ;; Maybe we've cut the end of the hunk before point.
1320 (if (and (bolp) (not (bobp))) (backward-char 1))
1321 ;; We used to fixup modifs on all the changes, but it turns out that
1322 ;; it's safer not to do it on big changes, e.g. when yanking a big
1323 ;; diff, or when the user edits the header, since we might then
1324 ;; screw up perfectly correct values. --Stef
1325 (diff-beginning-of-hunk t)
1326 (let* ((style (if (looking-at "\\*\\*\\*") 'context))
1327 (start (line-beginning-position (if (eq style 'context) 3 2)))
1328 (mid (if (eq style 'context)
1330 (re-search-forward diff-context-mid-hunk-header-re
1332 (when (and ;; Don't try to fixup changes in the hunk header.
1333 (>= (car diff-unhandled-changes) start)
1334 ;; Don't try to fixup changes in the mid-hunk header either.
1336 (< (cdr diff-unhandled-changes) (match-beginning 0))
1337 (> (car diff-unhandled-changes) (match-end 0)))
1339 (diff-end-of-hunk nil 'donttrustheader)
1340 ;; Don't try to fixup changes past the end of the hunk.
1341 (>= (point) (cdr diff-unhandled-changes))))
1342 (diff-fixup-modifs (point) (cdr diff-unhandled-changes)))))
1343 (setq diff-unhandled-changes nil))))
1345 (defun diff-next-error (arg reset)
1346 ;; Select a window that displays the current buffer so that point
1347 ;; movements are reflected in that window. Otherwise, the user might
1348 ;; never see the hunk corresponding to the source she's jumping to.
1349 (pop-to-buffer (current-buffer))
1350 (if reset (goto-char (point-min)))
1351 (diff-hunk-next arg)
1354 (defvar whitespace-style)
1355 (defvar whitespace-trailing-regexp)
1358 (define-derived-mode diff-mode fundamental-mode "Diff"
1359 "Major mode for viewing/editing context diffs.
1360 Supports unified and context diffs as well as (to a lesser extent)
1363 When the buffer is read-only, the ESC prefix is not necessary.
1364 If you edit the buffer manually, diff-mode will try to update the hunk
1365 headers for you on-the-fly.
1367 You can also switch between context diff and unified diff with \\[diff-context->unified],
1368 or vice versa with \\[diff-unified->context] and you can also reverse the direction of
1369 a diff with \\[diff-reverse-direction].
1373 (set (make-local-variable 'font-lock-defaults) diff-font-lock-defaults)
1374 (add-hook 'font-lock-mode-hook
1375 (lambda () (remove-overlays nil nil 'diff-mode 'fine))
1377 (set (make-local-variable 'outline-regexp) diff-outline-regexp)
1378 (set (make-local-variable 'imenu-generic-expression)
1379 diff-imenu-generic-expression)
1380 ;; These are not perfect. They would be better done separately for
1381 ;; context diffs and unidiffs.
1382 ;; (set (make-local-variable 'paragraph-start)
1383 ;; (concat "@@ " ; unidiff hunk
1384 ;; "\\|\\*\\*\\* " ; context diff hunk or file start
1385 ;; "\\|--- [^\t]+\t")) ; context or unidiff file
1386 ;; ; start (first or second line)
1387 ;; (set (make-local-variable 'paragraph-separate) paragraph-start)
1388 ;; (set (make-local-variable 'page-delimiter) "--- [^\t]+\t")
1390 (set (make-local-variable 'next-error-function) 'diff-next-error)
1392 (set (make-local-variable 'beginning-of-defun-function)
1393 'diff-beginning-of-file-and-junk)
1394 (set (make-local-variable 'end-of-defun-function)
1397 (diff-setup-whitespace)
1399 (if diff-default-read-only
1400 (setq buffer-read-only t))
1401 ;; setup change hooks
1402 (if (not diff-update-on-the-fly)
1403 (add-hook 'write-contents-functions 'diff-write-contents-hooks nil t)
1404 (make-local-variable 'diff-unhandled-changes)
1405 (add-hook 'after-change-functions 'diff-after-change-function nil t)
1406 (add-hook 'post-command-hook 'diff-post-command-hook nil t))
1407 ;; Neat trick from Dave Love to add more bindings in read-only mode:
1408 (let ((ro-bind (cons 'buffer-read-only diff-mode-shared-map)))
1409 (add-to-list 'minor-mode-overriding-map-alist ro-bind)
1410 ;; Turn off this little trick in case the buffer is put in view-mode.
1411 (add-hook 'view-mode-hook
1413 (setq minor-mode-overriding-map-alist
1414 (delq ro-bind minor-mode-overriding-map-alist)))
1417 (set (make-local-variable 'add-log-current-defun-function)
1418 'diff-current-defun)
1419 (set (make-local-variable 'add-log-buffer-file-name-function)
1420 (lambda () (diff-find-file-name nil 'noprompt)))
1421 (unless (buffer-file-name)
1422 (hack-dir-local-variables-non-file-buffer)))
1425 (define-minor-mode diff-minor-mode
1426 "Toggle Diff minor mode.
1427 With a prefix argument ARG, enable Diff minor mode if ARG is
1428 positive, and disable it otherwise. If called from Lisp, enable
1429 the mode if ARG is omitted or nil.
1431 \\{diff-minor-mode-map}"
1432 :group 'diff-mode :lighter " Diff"
1433 ;; FIXME: setup font-lock
1434 ;; setup change hooks
1435 (if (not diff-update-on-the-fly)
1436 (add-hook 'write-contents-functions 'diff-write-contents-hooks nil t)
1437 (make-local-variable 'diff-unhandled-changes)
1438 (add-hook 'after-change-functions 'diff-after-change-function nil t)
1439 (add-hook 'post-command-hook 'diff-post-command-hook nil t)))
1441 ;;; Handy hook functions ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1443 (defun diff-setup-whitespace ()
1444 "Set up Whitespace mode variables for the current Diff mode buffer.
1445 This sets `whitespace-style' and `whitespace-trailing-regexp' so
1446 that Whitespace mode shows trailing whitespace problems on the
1447 modified lines of the diff."
1448 (set (make-local-variable 'whitespace-style) '(face trailing))
1449 (let ((style (save-excursion
1450 (goto-char (point-min))
1451 ;; FIXME: For buffers filled from async processes, this search
1452 ;; will simply fail because the buffer is still empty :-(
1453 (when (re-search-forward diff-hunk-header-re nil t)
1454 (goto-char (match-beginning 0))
1455 (diff-hunk-style)))))
1456 (set (make-local-variable 'whitespace-trailing-regexp)
1457 (if (eq style 'context)
1458 "^[-+!] .*?\\([\t ]+\\)$"
1459 "^[-+!<>].*?\\([\t ]+\\)$"))))
1461 (defun diff-delete-if-empty ()
1462 ;; An empty diff file means there's no more diffs to integrate, so we
1463 ;; can just remove the file altogether. Very handy for .rej files if we
1464 ;; remove hunks as we apply them.
1465 (when (and buffer-file-name
1466 (eq 0 (nth 7 (file-attributes buffer-file-name))))
1467 (delete-file buffer-file-name)))
1469 (defun diff-delete-empty-files ()
1470 "Arrange for empty diff files to be removed."
1471 (add-hook 'after-save-hook 'diff-delete-if-empty nil t))
1473 (defun diff-make-unified ()
1474 "Turn context diffs into unified diffs if applicable."
1476 (goto-char (point-min))
1477 (and (looking-at diff-hunk-header-re) (eq (char-after) ?*)))
1478 (let ((mod (buffer-modified-p)))
1480 (diff-context->unified (point-min) (point-max))
1481 (restore-buffer-modified-p mod)))))
1484 ;;; Misc operations that have proved useful at some point.
1487 (defun diff-next-complex-hunk ()
1488 "Jump to the next \"complex\" hunk.
1489 \"Complex\" is approximated by \"the hunk changes the number of lines\".
1490 Only works for unified diffs."
1493 (and (re-search-forward diff-hunk-header-re-unified nil t)
1494 (equal (match-string 2) (match-string 4)))))
1496 (defun diff-sanity-check-context-hunk-half (lines)
1497 (let ((count lines))
1500 ((and (memq (char-after) '(?\s ?! ?+ ?-))
1501 (memq (char-after (1+ (point))) '(?\s ?\t)))
1503 ((or (zerop count) (= count lines)) nil)
1504 ((memq (char-after) '(?! ?+ ?-))
1505 (if (not (and (eq (char-after (1+ (point))) ?\n)
1506 (y-or-n-p "Try to auto-fix whitespace loss damage? ")))
1507 (error "End of hunk ambiguously marked")
1508 (forward-char 1) (insert " ") (forward-line -1) t))
1510 (error "End of hunk ambiguously marked"))
1511 ((not (y-or-n-p "Try to auto-fix whitespace loss and word-wrap damage? "))
1513 ((eolp) (insert " ") (forward-line -1) t)
1514 (t (insert " ") (delete-region (- (point) 2) (- (point) 1)) t))
1517 (defun diff-sanity-check-hunk ()
1518 (let (;; Every modification is protected by a y-or-n-p, so it's probably
1519 ;; OK to override a read-only setting.
1520 (inhibit-read-only t))
1523 ((not (looking-at diff-hunk-header-re))
1524 (error "Not recognizable hunk header"))
1527 ((eq (char-after) ?*)
1528 (if (not (looking-at "\\*\\{15\\}\\(?: .*\\)?\n\\*\\*\\* \\([0-9]+\\)\\(?:,\\([0-9]+\\)\\)? \\*\\*\\*\\*"))
1529 (error "Unrecognized context diff first hunk header format")
1531 (diff-sanity-check-context-hunk-half
1533 (1+ (- (string-to-number (match-string 2))
1534 (string-to-number (match-string 1))))
1536 (if (not (looking-at diff-context-mid-hunk-header-re))
1537 (error "Unrecognized context diff second hunk header format")
1539 (diff-sanity-check-context-hunk-half
1541 (1+ (- (string-to-number (match-string 2))
1542 (string-to-number (match-string 1))))
1546 ((eq (char-after) ?@)
1547 (if (not (looking-at diff-hunk-header-re-unified))
1548 (error "Unrecognized unified diff hunk header format")
1549 (let ((before (string-to-number (or (match-string 2) "1")))
1550 (after (string-to-number (or (match-string 4) "1"))))
1554 (?\s (cl-decf before) (cl-decf after) t)
1557 ((and (looking-at diff-separator-re)
1558 (zerop before) (zerop after))
1560 ((and (looking-at diff-file-header-re)
1561 (zerop before) (zerop after))
1562 ;; No need to query: this is a case where two patches
1563 ;; are concatenated and only counting the lines will
1564 ;; give the right result. Let's just add an empty
1565 ;; line so that our code which doesn't count lines
1566 ;; will not get confused.
1567 (save-excursion (insert "\n")) nil)
1569 (cl-decf before) t)))
1570 (?+ (cl-decf after) t)
1573 ((and diff-valid-unified-empty-line
1574 ;; Not just (eolp) so we don't infloop at eob.
1575 (eq (char-after) ?\n)
1576 (> before 0) (> after 0))
1577 (cl-decf before) (cl-decf after) t)
1578 ((and (zerop before) (zerop after)) nil)
1579 ((or (< before 0) (< after 0))
1580 (error (if (or (zerop before) (zerop after))
1581 "End of hunk ambiguously marked"
1582 "Hunk seriously messed up")))
1583 ((not (y-or-n-p (concat "Try to auto-fix " (if (eolp) "whitespace loss" "word-wrap damage") "? ")))
1585 ((eolp) (insert " ") (forward-line -1) t)
1587 (delete-region (- (point) 2) (- (point) 1)) t))))
1595 (defun diff-hunk-text (hunk destp char-offset)
1596 "Return the literal source text from HUNK as (TEXT . OFFSET).
1597 If DESTP is nil, TEXT is the source, otherwise the destination text.
1598 CHAR-OFFSET is a char-offset in HUNK, and OFFSET is the corresponding
1599 char-offset in TEXT."
1602 (goto-char (point-min))
1607 ;; Set the following variables:
1608 ;; SRC-POS buffer pos of the source part of the hunk or nil if none
1609 ;; DST-POS buffer pos of the destination part of the hunk or nil
1610 ;; DIVIDER-POS buffer pos of any divider line separating the src & dst
1611 ;; NUM-PFX-CHARS number of line-prefix characters used by this format"
1612 (cond ((looking-at "^@@")
1614 (setq num-pfx-chars 1)
1616 (setq src-pos (point) dst-pos (point)))
1617 ((looking-at "^\\*\\*")
1620 (setq src-pos (point))
1621 (re-search-forward diff-context-mid-hunk-header-re nil t)
1623 (setq divider-pos (point))
1625 (setq dst-pos (point)))
1626 ((looking-at "^[0-9]+a[0-9,]+$")
1627 ;; normal diff, insert
1629 (setq dst-pos (point)))
1630 ((looking-at "^[0-9,]+d[0-9]+$")
1631 ;; normal diff, delete
1633 (setq src-pos (point)))
1634 ((looking-at "^[0-9,]+c[0-9,]+$")
1635 ;; normal diff, change
1637 (setq src-pos (point))
1638 (re-search-forward "^---$" nil t)
1640 (setq divider-pos (point))
1642 (setq dst-pos (point)))
1644 (error "Unknown diff hunk type")))
1646 (if (if destp (null dst-pos) (null src-pos))
1647 ;; Implied empty text
1648 (if char-offset '("" . 0) "")
1650 ;; For context diffs, either side can be empty, (if there's only
1651 ;; added or only removed text). We should then use the other side.
1652 (cond ((equal src-pos divider-pos) (setq src-pos dst-pos))
1653 ((equal dst-pos (point-max)) (setq dst-pos src-pos)))
1655 (when char-offset (goto-char (+ (point-min) char-offset)))
1657 ;; Get rid of anything except the desired text.
1659 ;; Delete unused text region
1660 (let ((keep (if destp dst-pos src-pos)))
1661 (when (and divider-pos (> divider-pos keep))
1662 (delete-region divider-pos (point-max)))
1663 (delete-region (point-min) keep))
1664 ;; Remove line-prefix characters, and unneeded lines (unified diffs).
1665 (let ((kill-char (if destp ?- ?+)))
1666 (goto-char (point-min))
1668 (if (eq (char-after) kill-char)
1669 (delete-region (point) (progn (forward-line 1) (point)))
1670 (delete-char num-pfx-chars)
1671 (forward-line 1)))))
1673 (let ((text (buffer-substring-no-properties (point-min) (point-max))))
1674 (if char-offset (cons text (- (point) (point-min))) text))))))
1677 (defun diff-find-text (text)
1678 "Return the buffer position (BEG . END) of the nearest occurrence of TEXT.
1679 If TEXT isn't found, nil is returned."
1680 (let* ((orig (point))
1681 (forw (and (search-forward text nil t)
1682 (cons (match-beginning 0) (match-end 0))))
1683 (back (and (goto-char (+ orig (length text)))
1684 (search-backward text nil t)
1685 (cons (match-beginning 0) (match-end 0)))))
1686 ;; Choose the closest match.
1688 (if (> (- (car forw) orig) (- orig (car back))) back forw)
1691 (defun diff-find-approx-text (text)
1692 "Return the buffer position (BEG . END) of the nearest occurrence of TEXT.
1693 Whitespace differences are ignored."
1694 (let* ((orig (point))
1695 (re (concat "^[ \t\n\f]*"
1696 (mapconcat 'regexp-quote (split-string text) "[ \t\n\f]+")
1698 (forw (and (re-search-forward re nil t)
1699 (cons (match-beginning 0) (match-end 0))))
1700 (back (and (goto-char (+ orig (length text)))
1701 (re-search-backward re nil t)
1702 (cons (match-beginning 0) (match-end 0)))))
1703 ;; Choose the closest match.
1705 (if (> (- (car forw) orig) (- orig (car back))) back forw)
1708 (defsubst diff-xor (a b) (if a (if (not b) a) b))
1710 (defun diff-find-source-location (&optional other-file reverse noprompt)
1711 "Find out (BUF LINE-OFFSET POS SRC DST SWITCHED).
1712 BUF is the buffer corresponding to the source file.
1713 LINE-OFFSET is the offset between the expected and actual positions
1714 of the text of the hunk or nil if the text was not found.
1715 POS is a pair (BEG . END) indicating the position of the text in the buffer.
1716 SRC and DST are the two variants of text as returned by `diff-hunk-text'.
1717 SRC is the variant that was found in the buffer.
1718 SWITCHED is non-nil if the patch is already applied.
1719 NOPROMPT, if non-nil, means not to prompt the user."
1721 (let* ((other (diff-xor other-file diff-jump-to-old-file))
1722 (char-offset (- (point) (diff-beginning-of-hunk t)))
1723 ;; Check that the hunk is well-formed. Otherwise diff-mode and
1724 ;; the user may disagree on what constitutes the hunk
1725 ;; (e.g. because an empty line truncates the hunk mid-course),
1726 ;; leading to potentially nasty surprises for the user.
1728 ;; Suppress check when NOPROMPT is non-nil (Bug#3033).
1729 (_ (unless noprompt (diff-sanity-check-hunk)))
1730 (hunk (buffer-substring
1731 (point) (save-excursion (diff-end-of-hunk) (point))))
1732 (old (diff-hunk-text hunk reverse char-offset))
1733 (new (diff-hunk-text hunk (not reverse) char-offset))
1734 ;; Find the location specification.
1735 (line (if (not (looking-at "\\(?:\\*\\{15\\}.*\n\\)?[-@* ]*\\([0-9,]+\\)\\([ acd+]+\\([0-9,]+\\)\\)?"))
1736 (error "Can't find the hunk header")
1737 (if other (match-string 1)
1738 (if (match-end 3) (match-string 3)
1739 (unless (re-search-forward
1740 diff-context-mid-hunk-header-re nil t)
1741 (error "Can't find the hunk separator"))
1742 (match-string 1)))))
1743 (file (or (diff-find-file-name other noprompt)
1744 (error "Can't find the file")))
1745 (buf (find-file-noselect file)))
1746 ;; Update the user preference if he so wished.
1747 (when (> (prefix-numeric-value other-file) 8)
1748 (setq diff-jump-to-old-file other))
1749 (with-current-buffer buf
1750 (goto-char (point-min)) (forward-line (1- (string-to-number line)))
1751 (let* ((orig-pos (point))
1753 ;; FIXME: Check for case where both OLD and NEW are found.
1754 (pos (or (diff-find-text (car old))
1755 (progn (setq switched t) (diff-find-text (car new)))
1756 (progn (setq switched nil)
1758 (diff-find-approx-text (car old))
1759 (invalid-regexp nil))) ;Regex too big.
1760 (progn (setq switched t)
1762 (diff-find-approx-text (car new))
1763 (invalid-regexp nil))) ;Regex too big.
1764 (progn (setq switched nil) nil))))
1768 (list (count-lines orig-pos (car pos)) pos)
1769 (list nil (cons orig-pos (+ orig-pos (length (car old))))))
1770 (if switched (list new old t) (list old new))))))))
1773 (defun diff-hunk-status-msg (line-offset reversed dry-run)
1774 (let ((msg (if dry-run
1775 (if reversed "already applied" "not yet applied")
1776 (if reversed "undone" "applied"))))
1777 (message (cond ((null line-offset) "Hunk text not found")
1778 ((= line-offset 0) "Hunk %s")
1779 ((= line-offset 1) "Hunk %s at offset %d line")
1780 (t "Hunk %s at offset %d lines"))
1783 (defvar diff-apply-hunk-to-backup-file nil)
1785 (defun diff-apply-hunk (&optional reverse)
1786 "Apply the current hunk to the source file and go to the next.
1787 By default, the new source file is patched, but if the variable
1788 `diff-jump-to-old-file' is non-nil, then the old source file is
1789 patched instead (some commands, such as `diff-goto-source' can change
1790 the value of this variable when given an appropriate prefix argument).
1792 With a prefix argument, REVERSE the hunk."
1794 (diff-beginning-of-hunk t)
1795 (pcase-let ((`(,buf ,line-offset ,pos ,old ,new ,switched)
1796 ;; Sometimes we'd like to have the following behavior: if
1797 ;; REVERSE go to the new file, otherwise go to the old.
1798 ;; But that means that by default we use the old file, which is
1799 ;; the opposite of the default for diff-goto-source, and is thus
1800 ;; confusing. Also when you don't know about it it's
1801 ;; pretty surprising.
1802 ;; TODO: make it possible to ask explicitly for this behavior.
1804 ;; This is duplicated in diff-test-hunk.
1805 (diff-find-source-location nil reverse)))
1808 (error "Can't find the text to patch"))
1809 ((with-current-buffer buf
1810 (and buffer-file-name
1811 (backup-file-name-p buffer-file-name)
1812 (not diff-apply-hunk-to-backup-file)
1813 (not (set (make-local-variable 'diff-apply-hunk-to-backup-file)
1814 (yes-or-no-p (format "Really apply this hunk to %s? "
1815 (file-name-nondirectory
1816 buffer-file-name)))))))
1818 (substitute-command-keys
1819 (format "Use %s\\[diff-apply-hunk] to apply it to the other file"
1820 (if (not reverse) "\\[universal-argument] ")))))
1822 ;; A reversed patch was detected, perhaps apply it in reverse.
1823 (not (save-window-excursion
1825 (goto-char (+ (car pos) (cdr old)))
1828 "Hunk hasn't been applied yet; apply it now? "
1829 "Hunk has already been applied; undo it? ")))))
1830 (message "(Nothing done)"))
1833 (with-current-buffer buf
1834 (goto-char (car pos))
1835 (delete-region (car pos) (cdr pos))
1837 ;; Display BUF in a window
1838 (set-window-point (display-buffer buf) (+ (car pos) (cdr new)))
1839 (diff-hunk-status-msg line-offset (diff-xor switched reverse) nil)
1840 (when diff-advance-after-apply-hunk
1841 (diff-hunk-next))))))
1844 (defun diff-test-hunk (&optional reverse)
1845 "See whether it's possible to apply the current hunk.
1846 With a prefix argument, try to REVERSE the hunk."
1848 (pcase-let ((`(,buf ,line-offset ,pos ,src ,_dst ,switched)
1849 (diff-find-source-location nil reverse)))
1850 (set-window-point (display-buffer buf) (+ (car pos) (cdr src)))
1851 (diff-hunk-status-msg line-offset (diff-xor reverse switched) t)))
1854 (defun diff-kill-applied-hunks ()
1855 "Kill all hunks that have already been applied starting at point."
1858 (pcase-let ((`(,_buf ,line-offset ,_pos ,_src ,_dst ,switched)
1859 (diff-find-source-location nil nil)))
1860 (if (and line-offset switched)
1862 (diff-hunk-next)))))
1864 (defalias 'diff-mouse-goto-source 'diff-goto-source)
1866 (defun diff-goto-source (&optional other-file event)
1867 "Jump to the corresponding source line.
1868 `diff-jump-to-old-file' (or its opposite if the OTHER-FILE prefix arg
1869 is given) determines whether to jump to the old or the new file.
1870 If the prefix arg is bigger than 8 (for example with \\[universal-argument] \\[universal-argument])
1871 then `diff-jump-to-old-file' is also set, for the next invocations."
1872 (interactive (list current-prefix-arg last-input-event))
1873 ;; When pointing at a removal line, we probably want to jump to
1874 ;; the old location, and else to the new (i.e. as if reverting).
1875 ;; This is a convenient detail when using smerge-diff.
1876 (if event (posn-set-point (event-end event)))
1877 (let ((rev (not (save-excursion (beginning-of-line) (looking-at "[-<]")))))
1878 (pcase-let ((`(,buf ,line-offset ,pos ,src ,_dst ,switched)
1879 (diff-find-source-location other-file rev)))
1881 (goto-char (+ (car pos) (cdr src)))
1882 (diff-hunk-status-msg line-offset (diff-xor rev switched) t))))
1885 (defun diff-current-defun ()
1886 "Find the name of function at point.
1887 For use in `add-log-current-defun-function'."
1888 ;; Kill change-log-default-name so it gets recomputed each time, since
1889 ;; each hunk may belong to another file which may belong to another
1890 ;; directory and hence have a different ChangeLog file.
1891 (kill-local-variable 'change-log-default-name)
1893 (when (looking-at diff-hunk-header-re)
1895 (re-search-forward "^[^ ]" nil t))
1896 (pcase-let ((`(,buf ,_line-offset ,pos ,src ,dst ,switched)
1897 (ignore-errors ;Signals errors in place of prompting.
1898 ;; Use `noprompt' since this is used in which-func-mode
1900 (diff-find-source-location nil nil 'noprompt))))
1903 (or (when (memq (char-after) '(?< ?-))
1904 ;; Cursor is pointing at removed text. This could be a removed
1905 ;; function, in which case, going to the source buffer will
1906 ;; not help since the function is now removed. Instead,
1907 ;; try to figure out the function name just from the
1909 (let ((old (if switched dst src)))
1912 (funcall (buffer-local-value 'major-mode buf))
1913 (goto-char (+ (point-min) (cdr old)))
1914 (add-log-current-defun))))
1915 (with-current-buffer buf
1916 (goto-char (+ (car pos) (cdr src)))
1917 (add-log-current-defun)))))))
1919 (defun diff-ignore-whitespace-hunk ()
1920 "Re-diff the current hunk, ignoring whitespace differences."
1922 (let* ((char-offset (- (point) (diff-beginning-of-hunk t)))
1923 (opts (pcase (char-after) (?@ "-bu") (?* "-bc") (_ "-b")))
1924 (line-nb (and (or (looking-at "[^0-9]+\\([0-9]+\\)")
1925 (error "Can't find line number"))
1926 (string-to-number (match-string 1))))
1927 (inhibit-read-only t)
1928 (hunk (delete-and-extract-region
1929 (point) (save-excursion (diff-end-of-hunk) (point))))
1930 (lead (make-string (1- line-nb) ?\n)) ;Line nums start at 1.
1931 (file1 (make-temp-file "diff1"))
1932 (file2 (make-temp-file "diff2"))
1933 (coding-system-for-read buffer-file-coding-system)
1937 (setq old (diff-hunk-text hunk nil char-offset))
1938 (setq new (diff-hunk-text hunk t char-offset))
1939 (write-region (concat lead (car old)) nil file1 nil 'nomessage)
1940 (write-region (concat lead (car new)) nil file2 nil 'nomessage)
1943 (call-process diff-command nil t nil
1946 (0 nil) ;Nothing to reformat.
1947 (1 (goto-char (point-min))
1948 ;; Remove the file-header.
1949 (when (re-search-forward diff-hunk-header-re nil t)
1950 (delete-region (point-min) (match-beginning 0))))
1951 (_ (goto-char (point-max))
1952 (unless (bolp) (insert "\n"))
1954 (setq hunk (buffer-string))
1955 (unless (memq status '(0 1))
1956 (error "Diff returned: %s" status)))))
1957 ;; Whatever happens, put back some equivalent text: either the new
1958 ;; one or the original one in case some error happened.
1961 (delete-file file2))))
1963 ;;; Fine change highlighting.
1965 (defface diff-refine-changed
1966 '((((class color) (min-colors 88) (background light))
1967 :background "#ffff55")
1968 (((class color) (min-colors 88) (background dark))
1969 :background "#aaaa22")
1970 (t :inverse-video t))
1971 "Face used for char-based changes shown by `diff-refine-hunk'."
1974 (defface diff-refine-removed
1976 :inherit diff-refine-changed)
1977 (((class color) (min-colors 88) (background light))
1978 :background "#ffbbbb")
1979 (((class color) (min-colors 88) (background dark))
1980 :background "#aa2222"))
1981 "Face used for removed characters shown by `diff-refine-hunk'."
1985 (defface diff-refine-added
1987 :inherit diff-refine-changed)
1988 (((class color) (min-colors 88) (background light))
1989 :background "#aaffaa")
1990 (((class color) (min-colors 88) (background dark))
1991 :background "#22aa22"))
1992 "Face used for added characters shown by `diff-refine-hunk'."
1996 (defun diff-refine-preproc ()
1997 (while (re-search-forward "^[+>]" nil t)
1998 ;; Remove spurious changes due to the fact that one side of the hunk is
1999 ;; marked with leading + or > and the other with leading - or <.
2000 ;; We used to replace all the prefix chars with " " but this only worked
2001 ;; when we did char-based refinement (or when using
2002 ;; smerge-refine-weight-hack) since otherwise, the `forward' motion done
2003 ;; in chopup do not necessarily do the same as the ones in highlight
2004 ;; since the "_" is not treated the same as " ".
2005 (replace-match (cdr (assq (char-before) '((?+ . "-") (?> . "<"))))))
2008 (declare-function smerge-refine-subst "smerge-mode"
2009 (beg1 end1 beg2 end2 props-c &optional preproc props-r props-a))
2011 (defun diff--forward-while-leading-char (char bound)
2012 "Move point until reaching a line not starting with CHAR.
2013 Return new point, if it was moved."
2015 (while (and (< (point) bound) (eql (following-char) char))
2020 (defun diff-refine-hunk ()
2021 "Highlight changes of hunk at point at a finer granularity."
2023 (require 'smerge-mode)
2024 (when (diff--some-hunks-p)
2026 (diff-beginning-of-hunk t)
2027 (let* ((start (point))
2028 (style (diff-hunk-style)) ;Skips the hunk header as well.
2030 (props-c '((diff-mode . fine) (face diff-refine-changed)))
2031 (props-r '((diff-mode . fine) (face diff-refine-removed)))
2032 (props-a '((diff-mode . fine) (face diff-refine-added)))
2033 ;; Be careful to go back to `start' so diff-end-of-hunk gets
2034 ;; to read the hunk header's line info.
2035 (end (progn (goto-char start) (diff-end-of-hunk) (point))))
2037 (remove-overlays beg end 'diff-mode 'fine)
2042 (while (re-search-forward "^-" end t)
2043 (let ((beg-del (progn (beginning-of-line) (point)))
2045 (when (and (diff--forward-while-leading-char ?- end)
2046 ;; Allow for "\ No newline at end of file".
2047 (progn (diff--forward-while-leading-char ?\\ end)
2048 (setq beg-add (point)))
2049 (diff--forward-while-leading-char ?+ end)
2050 (progn (diff--forward-while-leading-char ?\\ end)
2051 (setq end-add (point))))
2052 (smerge-refine-subst beg-del beg-add beg-add end-add
2053 nil 'diff-refine-preproc props-r props-a)))))
2055 (let* ((middle (save-excursion (re-search-forward "^---")))
2057 (while (re-search-forward "^\\(?:!.*\n\\)+" middle t)
2058 (smerge-refine-subst (match-beginning 0) (match-end 0)
2061 (re-search-forward "^\\(?:!.*\n\\)+" end)
2062 (setq other (match-end 0))
2063 (match-beginning 0))
2065 (if diff-use-changed-face props-c)
2066 'diff-refine-preproc
2067 (unless diff-use-changed-face props-r)
2068 (unless diff-use-changed-face props-a)))))
2070 (let ((beg1 (1+ (point))))
2071 (when (re-search-forward "^---.*\n" end t)
2072 ;; It's a combined add&remove, so there's something to do.
2073 (smerge-refine-subst beg1 (match-beginning 0)
2075 nil 'diff-refine-preproc props-r props-a)))))))))
2077 (defun diff-undo (&optional arg)
2078 "Perform `undo', ignoring the buffer's read-only status."
2080 (let ((inhibit-read-only t))
2083 (defun diff-add-change-log-entries-other-window ()
2084 "Iterate through the current diff and create ChangeLog entries.
2085 I.e. like `add-change-log-entry-other-window' but applied to all hunks."
2087 ;; XXX: Currently add-change-log-entry-other-window is only called
2088 ;; once per hunk. Some hunks have multiple changes, it would be
2089 ;; good to call it for each change.
2091 (goto-char (point-min))
2093 ;; Call add-change-log-entry-other-window for each hunk in
2097 ;; Move to where the changes are,
2098 ;; `add-change-log-entry-other-window' works better in
2102 ;; If the hunk is a context hunk with an empty first
2103 ;; half, recognize the "--- NNN,MMM ----" line
2104 "\\(-- [0-9]+\\(,[0-9]+\\)? ----\n"
2105 ;; and skip to the next non-context line.
2106 "\\( .*\n\\)*[+]\\)?")
2109 ;; FIXME: this pops up windows of all the buffers.
2110 (add-change-log-entry nil nil t nil t)))
2111 ;; When there's no more hunks, diff-hunk-next signals an error.
2114 (defun diff-delete-trailing-whitespace (&optional other-file)
2115 "Remove trailing whitespace from lines modified in this diff.
2116 This edits both the current Diff mode buffer and the patched
2117 source file(s). If `diff-jump-to-old-file' is non-nil, edit the
2118 original (unpatched) source file instead. With a prefix argument
2119 OTHER-FILE, flip the choice of which source file to edit.
2121 If a file referenced in the diff has no buffer and needs to be
2122 fixed, visit it in a buffer."
2125 (goto-char (point-min))
2126 (let* ((other (diff-xor other-file diff-jump-to-old-file))
2127 (modified-buffers nil)
2128 (style (save-excursion
2129 (when (re-search-forward diff-hunk-header-re nil t)
2130 (goto-char (match-beginning 0))
2131 (diff-hunk-style))))
2132 (regexp (concat "^[" (if other "-<" "+>") "!]"
2133 (if (eq style 'context) " " "")
2134 ".*?\\([ \t]+\\)$"))
2135 (inhibit-read-only t)
2136 (end-marker (make-marker))
2138 ;; Move to the first hunk.
2139 (re-search-forward diff-hunk-header-re nil 1)
2140 (while (progn (save-excursion
2141 (re-search-forward diff-hunk-header-re nil 1)
2142 (setq hunk-end (point)))
2143 (< (point) hunk-end))
2144 ;; For context diffs, search only in the appropriate half of
2145 ;; the hunk. For other diffs, search within the entire hunk.
2146 (if (not (eq style 'context))
2147 (set-marker end-marker hunk-end)
2150 (re-search-forward diff-context-mid-hunk-header-re hunk-end)
2153 (set-marker end-marker mid-hunk)
2154 (goto-char mid-hunk)
2155 (set-marker end-marker hunk-end))))
2156 (while (re-search-forward regexp end-marker t)
2157 (let ((match-data (match-data)))
2158 (pcase-let ((`(,buf ,line-offset ,pos ,src ,_dst ,_switched)
2159 (diff-find-source-location other-file)))
2161 ;; Remove the whitespace in the Diff mode buffer.
2162 (set-match-data match-data)
2163 (replace-match "" t t nil 1)
2164 ;; Remove the whitespace in the source buffer.
2165 (with-current-buffer buf
2167 (goto-char (+ (car pos) (cdr src)))
2169 (when (re-search-forward "\\([ \t]+\\)$" (line-end-position) t)
2170 (unless (memq buf modified-buffers)
2171 (push buf modified-buffers))
2172 (replace-match ""))))))))
2173 (goto-char hunk-end))
2174 (if modified-buffers
2175 (message "Deleted trailing whitespace from %s."
2176 (mapconcat (lambda (buf) (format-message
2177 "`%s'" (buffer-name buf)))
2178 modified-buffers ", "))
2179 (message "No trailing whitespace to delete.")))))
2181 ;; provide the package
2182 (provide 'diff-mode)
2184 ;;; Old Change Log from when diff-mode wasn't part of Emacs:
2185 ;; Revision 1.11 1999/10/09 23:38:29 monnier
2186 ;; (diff-mode-load-hook): dropped.
2187 ;; (auto-mode-alist): also catch *.diffs.
2188 ;; (diff-find-file-name, diff-mode): add smarts to find the right file
2189 ;; for *.rej files (that lack any file name indication).
2191 ;; Revision 1.10 1999/09/30 15:32:11 monnier
2192 ;; added support for "\ No newline at end of file".
2194 ;; Revision 1.9 1999/09/15 00:01:13 monnier
2195 ;; - added basic `compile' support.
2196 ;; - have diff-kill-hunk call diff-kill-file if it's the only hunk.
2197 ;; - diff-kill-file now tries to kill the leading garbage as well.
2199 ;; Revision 1.8 1999/09/13 21:10:09 monnier
2200 ;; - don't use CL in the autoloaded code
2201 ;; - accept diffs using -T
2203 ;; Revision 1.7 1999/09/05 20:53:03 monnier
2204 ;; interface to ediff-patch
2206 ;; Revision 1.6 1999/09/01 20:55:13 monnier
2207 ;; (ediff=patch-file): add bindings to call ediff-patch.
2208 ;; (diff-find-file-name): taken out of diff-goto-source.
2209 ;; (diff-unified->context, diff-context->unified, diff-reverse-direction,
2210 ;; diff-fixup-modifs): only use the region if a prefix arg is given.
2212 ;; Revision 1.5 1999/08/31 19:18:52 monnier
2213 ;; (diff-beginning-of-file, diff-prev-file): fixed wrong parenthesis.
2215 ;; Revision 1.4 1999/08/31 13:01:44 monnier
2216 ;; use `combine-after-change-calls' to minimize the slowdown of font-lock.
2219 ;;; diff-mode.el ends here