;;; diff-mode.el --- a mode for viewing/editing context diffs -*- lexical-binding: t -*- ;; Copyright (C) 1998-2018 Free Software Foundation, Inc. ;; Author: Stefan Monnier ;; Keywords: convenience patch diff vc ;; This file is part of GNU Emacs. ;; GNU Emacs is free software: you can redistribute it and/or modify ;; it under the terms of the GNU General Public License as published by ;; the Free Software Foundation, either version 3 of the License, or ;; (at your option) any later version. ;; GNU Emacs is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; You should have received a copy of the GNU General Public License ;; along with GNU Emacs. If not, see . ;;; Commentary: ;; Provides support for font-lock, outline, navigation ;; commands, editing and various conversions as well as jumping ;; to the corresponding source file. ;; Inspired by Pavel Machek's patch-mode.el () ;; Some efforts were spent to have it somewhat compatible with XEmacs's ;; diff-mode as well as with compilation-minor-mode ;; Bugs: ;; - Reverse doesn't work with normal diffs. ;; Todo: ;; - Improve `diff-add-change-log-entries-other-window', ;; it is very simplistic now. ;; ;; - Add a `delete-after-apply' so C-c C-a automatically deletes hunks. ;; Also allow C-c C-a to delete already-applied hunks. ;; ;; - Try `diff ' to try and fuzzily discover the source location ;; of a hunk. Show then the changes between and and make it ;; possible to apply them to , , or . ;; Or maybe just make it into a ".rej to diff3-markers converter". ;; Maybe just use `wiggle' (by Neil Brown) to do it for us. ;; ;; - in diff-apply-hunk, strip context in replace-match to better ;; preserve markers and spacing. ;; - Handle `diff -b' output in context->unified. ;;; Code: (eval-when-compile (require 'cl-lib)) (autoload 'vc-find-revision "vc") (autoload 'vc-find-revision-no-save "vc") (defvar vc-find-revision-no-save) (defvar add-log-buffer-file-name-function) (defgroup diff-mode () "Major mode for viewing/editing diffs." :version "21.1" :group 'tools :group 'diff) (defcustom diff-default-read-only nil "If non-nil, `diff-mode' buffers default to being read-only." :type 'boolean) (defcustom diff-jump-to-old-file nil "Non-nil means `diff-goto-source' jumps to the old file. Else, it jumps to the new file." :type 'boolean) (defcustom diff-update-on-the-fly t "Non-nil means hunk headers are kept up-to-date on-the-fly. When editing a diff file, the line numbers in the hunk headers need to be kept consistent with the actual diff. This can either be done on the fly (but this sometimes interacts poorly with the undo mechanism) or whenever the file is written (can be slow when editing big diffs)." :type 'boolean) (defcustom diff-advance-after-apply-hunk t "Non-nil means `diff-apply-hunk' will move to the next hunk after applying." :type 'boolean) (defcustom diff-mode-hook nil "Run after setting up the `diff-mode' major mode." :type 'hook :options '(diff-delete-empty-files diff-make-unified)) (defcustom diff-font-lock-refine t "If non-nil, font-lock highlighting includes hunk refinement." :version "27.1" :type 'boolean) (defcustom diff-font-lock-prettify nil "If non-nil, font-lock will try and make the format prettier." :version "27.1" :type 'boolean) (defcustom diff-font-lock-syntax (>= (display-color-cells) 88) "If non-nil, diff hunk font-lock includes source language syntax highlighting. This highlighting is the same as added by `font-lock-mode' when corresponding source files are visited normally. Syntax highlighting is added over diff own highlighted changes. If t, the default, highlight syntax only in Diff buffers created by Diff commands that compare files or by VC commands that compare revisions. These provide all necessary context for reliable highlighting. This value requires support from a VC backend to find the files being compared. For diffs against the working-tree version of a file, the highlighting is based on the current file contents. File-based fontification tries to infer fontification from the compared files. If revision-based or file-based method fails, use hunk-based method to get fontification from hunk alone if the value is `hunk-also'. If `hunk-only', fontification is based on hunk alone, without full source. It tries to highlight hunks without enough context that sometimes might result in wrong fontification. This is the fastest option, but less reliable." :version "27.1" :type '(choice (const :tag "Don't highlight syntax" nil) (const :tag "Hunk-based also" hunk-also) (const :tag "Hunk-based only" hunk-only) (const :tag "Highlight syntax" t))) (defvar diff-vc-backend nil "The VC backend that created the current Diff buffer, if any.") (defvar diff-vc-revisions nil "The VC revisions compared in the current Diff buffer, if any.") (defvar diff-default-directory nil "The default directory where the current Diff buffer was created.") (make-variable-buffer-local 'diff-default-directory) (defvar diff-outline-regexp "\\([*+][*+][*+] [^0-9]\\|@@ ...\\|\\*\\*\\* [0-9].\\|--- [0-9]..\\)") ;;;; ;;;; keymap, menu, ... ;;;; (easy-mmode-defmap diff-mode-shared-map '(("n" . diff-hunk-next) ("N" . diff-file-next) ("p" . diff-hunk-prev) ("P" . diff-file-prev) ("\t" . diff-hunk-next) ([backtab] . diff-hunk-prev) ("k" . diff-hunk-kill) ("K" . diff-file-kill) ("}" . diff-file-next) ; From compilation-minor-mode. ("{" . diff-file-prev) ("\C-m" . diff-goto-source) ([mouse-2] . diff-goto-source) ("W" . widen) ("o" . diff-goto-source) ; other-window ("A" . diff-ediff-patch) ("r" . diff-restrict-view) ("R" . diff-reverse-direction) ([remap undo] . diff-undo)) "Basic keymap for `diff-mode', bound to various prefix keys." :inherit special-mode-map) (easy-mmode-defmap diff-mode-map `(("\e" . ,(let ((map (make-sparse-keymap))) ;; We want to inherit most bindings from diff-mode-shared-map, ;; but not all since they may hide useful M- global ;; bindings when editing. (set-keymap-parent map diff-mode-shared-map) (dolist (key '("A" "r" "R" "g" "q" "W" "z")) (define-key map key nil)) map)) ;; From compilation-minor-mode. ("\C-c\C-c" . diff-goto-source) ;; By analogy with the global C-x 4 a binding. ("\C-x4A" . diff-add-change-log-entries-other-window) ;; Misc operations. ("\C-c\C-a" . diff-apply-hunk) ("\C-c\C-e" . diff-ediff-patch) ("\C-c\C-n" . diff-restrict-view) ("\C-c\C-s" . diff-split-hunk) ("\C-c\C-t" . diff-test-hunk) ("\C-c\C-r" . diff-reverse-direction) ("\C-c\C-u" . diff-context->unified) ;; `d' because it duplicates the context :-( --Stef ("\C-c\C-d" . diff-unified->context) ("\C-c\C-w" . diff-ignore-whitespace-hunk) ("\C-c\C-b" . diff-refine-hunk) ;No reason for `b' :-( ("\C-c\C-f" . next-error-follow-minor-mode)) "Keymap for `diff-mode'. See also `diff-mode-shared-map'.") (easy-menu-define diff-mode-menu diff-mode-map "Menu for `diff-mode'." '("Diff" ["Jump to Source" diff-goto-source :help "Jump to the corresponding source line"] ["Apply hunk" diff-apply-hunk :help "Apply the current hunk to the source file and go to the next"] ["Test applying hunk" diff-test-hunk :help "See whether it's possible to apply the current hunk"] ["Apply diff with Ediff" diff-ediff-patch :help "Call `ediff-patch-file' on the current buffer"] ["Create Change Log entries" diff-add-change-log-entries-other-window :help "Create ChangeLog entries for the changes in the diff buffer"] "-----" ["Reverse direction" diff-reverse-direction :help "Reverse the direction of the diffs"] ["Context -> Unified" diff-context->unified :help "Convert context diffs to unified diffs"] ["Unified -> Context" diff-unified->context :help "Convert unified diffs to context diffs"] ;;["Fixup Headers" diff-fixup-modifs (not buffer-read-only)] ["Remove trailing whitespace" diff-delete-trailing-whitespace :help "Remove trailing whitespace problems introduced by the diff"] ["Show trailing whitespace" whitespace-mode :style toggle :selected (bound-and-true-p whitespace-mode) :help "Show trailing whitespace in modified lines"] "-----" ["Split hunk" diff-split-hunk :active (diff-splittable-p) :help "Split the current (unified diff) hunk at point into two hunks"] ["Ignore whitespace changes" diff-ignore-whitespace-hunk :help "Re-diff the current hunk, ignoring whitespace differences"] ["Highlight fine changes" diff-refine-hunk :help "Highlight changes of hunk at point at a finer granularity"] ["Kill current hunk" diff-hunk-kill :help "Kill current hunk"] ["Kill current file's hunks" diff-file-kill :help "Kill all current file's hunks"] "-----" ["Previous Hunk" diff-hunk-prev :help "Go to the previous count'th hunk"] ["Next Hunk" diff-hunk-next :help "Go to the next count'th hunk"] ["Previous File" diff-file-prev :help "Go to the previous count'th file"] ["Next File" diff-file-next :help "Go to the next count'th file"] )) (defcustom diff-minor-mode-prefix "\C-c=" "Prefix key for `diff-minor-mode' commands." :type '(choice (string "\e") (string "C-c=") string)) (easy-mmode-defmap diff-minor-mode-map `((,diff-minor-mode-prefix . ,diff-mode-shared-map)) "Keymap for `diff-minor-mode'. See also `diff-mode-shared-map'.") (define-minor-mode diff-auto-refine-mode "Toggle automatic diff hunk finer highlighting (Diff Auto Refine mode). Diff Auto Refine mode is a buffer-local minor mode used with `diff-mode'. When enabled, Emacs automatically highlights changes in detail as the user visits hunks. When transitioning from disabled to enabled, it tries to refine the current hunk, as well." :group 'diff-mode :init-value t :lighter nil ;; " Auto-Refine" (when diff-auto-refine-mode (condition-case-unless-debug nil (diff-refine-hunk) (error nil)))) ;;;; ;;;; font-lock support ;;;; (defface diff-header '((((class color) (min-colors 88) (background light)) :background "grey85") (((class color) (min-colors 88) (background dark)) :background "grey45") (((class color)) :foreground "blue1" :weight bold) (t :weight bold)) "`diff-mode' face inherited by hunk and index header faces.") (defface diff-file-header '((((class color) (min-colors 88) (background light)) :background "grey75" :weight bold) (((class color) (min-colors 88) (background dark)) :background "grey60" :weight bold) (((class color)) :foreground "cyan" :weight bold) (t :weight bold)) ; :height 1.3 "`diff-mode' face used to highlight file header lines.") (defface diff-index '((t :inherit diff-file-header)) "`diff-mode' face used to highlight index header lines.") (defface diff-hunk-header '((t :inherit diff-header)) "`diff-mode' face used to highlight hunk header lines.") (defface diff-removed '((default :inherit diff-changed) (((class color) (min-colors 88) (background light)) :background "#ffeeee") (((class color) (min-colors 88) (background dark)) :background "#553333") (((class color)) :foreground "red")) "`diff-mode' face used to highlight removed lines.") (defface diff-added '((default :inherit diff-changed) (((class color) (min-colors 88) (background light)) :background "#eeffee") (((class color) (min-colors 88) (background dark)) :background "#335533") (((class color)) :foreground "green")) "`diff-mode' face used to highlight added lines.") (defface diff-changed '((t nil)) "`diff-mode' face used to highlight changed lines." :version "25.1") (defface diff-indicator-removed '((default :inherit diff-removed) (((class color) (min-colors 88)) :foreground "#aa2222")) "`diff-mode' face used to highlight indicator of removed lines (-, <)." :version "22.1") (defvar diff-indicator-removed-face 'diff-indicator-removed) (defface diff-indicator-added '((default :inherit diff-added) (((class color) (min-colors 88)) :foreground "#22aa22")) "`diff-mode' face used to highlight indicator of added lines (+, >)." :version "22.1") (defvar diff-indicator-added-face 'diff-indicator-added) (defface diff-indicator-changed '((default :inherit diff-changed) (((class color) (min-colors 88)) :foreground "#aaaa22")) "`diff-mode' face used to highlight indicator of changed lines." :version "22.1") (defvar diff-indicator-changed-face 'diff-indicator-changed) (defface diff-function '((t :inherit diff-header)) "`diff-mode' face used to highlight function names produced by \"diff -p\".") (defface diff-context '((t nil)) "`diff-mode' face used to highlight context and other side-information." :version "25.1") (defface diff-nonexistent '((t :inherit diff-file-header)) "`diff-mode' face used to highlight nonexistent files in recursive diffs.") (defconst diff-yank-handler '(diff-yank-function)) (defun diff-yank-function (text) ;; FIXME: the yank-handler is now called separately on each piece of text ;; with a yank-handler property, so the next-single-property-change call ;; below will always return nil :-( --stef (let ((mixed (next-single-property-change 0 'yank-handler text)) (start (point))) ;; First insert the text. (insert text) ;; If the text does not include any diff markers and if we're not ;; yanking back into a diff-mode buffer, get rid of the prefixes. (unless (or mixed (derived-mode-p 'diff-mode)) (undo-boundary) ; Just in case the user wanted the prefixes. (let ((re (save-excursion (if (re-search-backward "^[>][ \t]") "^[ <>!+-]")))) (save-excursion (while (re-search-backward re start t) (replace-match "" t t))))))) (defconst diff-hunk-header-re-unified "^@@ -\\([0-9]+\\)\\(?:,\\([0-9]+\\)\\)? \\+\\([0-9]+\\)\\(?:,\\([0-9]+\\)\\)? @@") (defconst diff-context-mid-hunk-header-re "--- \\([0-9]+\\)\\(?:,\\([0-9]+\\)\\)? ----$") (defvar diff-use-changed-face (and (face-differs-from-default-p 'diff-changed) (not (face-equal 'diff-changed 'diff-added)) (not (face-equal 'diff-changed 'diff-removed))) "If non-nil, use the face `diff-changed' for changed lines in context diffs. Otherwise, use the face `diff-removed' for removed lines, and the face `diff-added' for added lines.") (defvar diff-font-lock-keywords `((,(concat "\\(" diff-hunk-header-re-unified "\\)\\(.*\\)$") (1 'diff-hunk-header) (6 'diff-function)) ("^\\(\\*\\{15\\}\\)\\(.*\\)$" ;context (1 'diff-hunk-header) (2 'diff-function)) ("^\\*\\*\\* .+ \\*\\*\\*\\*". 'diff-hunk-header) ;context (,diff-context-mid-hunk-header-re . 'diff-hunk-header) ;context ("^[0-9,]+[acd][0-9,]+$" . 'diff-hunk-header) ;normal ("^---$" . 'diff-hunk-header) ;normal ;; For file headers, accept files with spaces, but be careful to rule ;; out false-positives when matching hunk headers. ("^\\(---\\|\\+\\+\\+\\|\\*\\*\\*\\) \\([^\t\n]+?\\)\\(?:\t.*\\| \\(\\*\\*\\*\\*\\|----\\)\\)?\n" (0 'diff-header) (2 (if (not (match-end 3)) 'diff-file-header) prepend)) ("^\\([-<]\\)\\(.*\n\\)" (1 diff-indicator-removed-face) (2 'diff-removed)) ("^\\([+>]\\)\\(.*\n\\)" (1 diff-indicator-added-face) (2 'diff-added)) ("^\\(!\\)\\(.*\n\\)" (1 (if diff-use-changed-face diff-indicator-changed-face ;; Otherwise, search for `diff-context-mid-hunk-header-re' and ;; if the line of context diff is above, use `diff-removed'; ;; if below, use `diff-added'. (save-match-data (let ((limit (save-excursion (diff-beginning-of-hunk)))) (if (save-excursion (re-search-backward diff-context-mid-hunk-header-re limit t)) diff-indicator-added-face diff-indicator-removed-face))))) (2 (if diff-use-changed-face 'diff-changed ;; Otherwise, use the same method as above. (save-match-data (let ((limit (save-excursion (diff-beginning-of-hunk)))) (if (save-excursion (re-search-backward diff-context-mid-hunk-header-re limit t)) 'diff-added 'diff-removed)))))) ("^\\(?:Index\\|revno\\): \\(.+\\).*\n" (0 'diff-header) (1 'diff-index prepend)) ("^\\(?:index .*\\.\\.\\|diff \\).*\n" . 'diff-header) ("^Only in .*\n" . 'diff-nonexistent) ("^Binary files .* differ\n" . 'diff-file-header) ("^\\(#\\)\\(.*\\)" (1 font-lock-comment-delimiter-face) (2 font-lock-comment-face)) ("^[^-=+*!<>#].*\n" (0 'diff-context)) (,#'diff--font-lock-syntax) (,#'diff--font-lock-prettify) (,#'diff--font-lock-refined))) (defconst diff-font-lock-defaults '(diff-font-lock-keywords t nil nil nil (font-lock-multiline . nil))) (defvar diff-imenu-generic-expression ;; Prefer second name as first is most likely to be a backup or ;; version-control name. The [\t\n] at the end of the unidiff pattern ;; catches Debian source diff files (which lack the trailing date). '((nil "\\+\\+\\+\\ \\([^\t\n]+\\)[\t\n]" 1) ; unidiffs (nil "^--- \\([^\t\n]+\\)\t.*\n\\*" 1))) ; context diffs ;;;; ;;;; Movement ;;;; (defvar diff-valid-unified-empty-line t "If non-nil, empty lines are valid in unified diffs. Some versions of diff replace all-blank context lines in unified format with empty lines. This makes the format less robust, but is tolerated. See https://lists.gnu.org/r/emacs-devel/2007-11/msg01990.html") (defconst diff-hunk-header-re (concat "^\\(?:" diff-hunk-header-re-unified ".*\\|\\*\\{15\\}.*\n\\*\\*\\* .+ \\*\\*\\*\\*\\|[0-9]+\\(,[0-9]+\\)?[acd][0-9]+\\(,[0-9]+\\)?\\)$")) (defconst diff-file-header-re (concat "^\\(--- .+\n\\+\\+\\+ \\|\\*\\*\\* .+\n--- \\|[^-+!<>0-9@* \n]\\).+\n" (substring diff-hunk-header-re 1))) (defconst diff-separator-re "^--+ ?$") (defvar diff-narrowed-to nil) (defun diff-hunk-style (&optional style) (when (looking-at diff-hunk-header-re) (setq style (cdr (assq (char-after) '((?@ . unified) (?* . context))))) (goto-char (match-end 0))) style) (defun diff-end-of-hunk (&optional style donttrustheader) "Advance to the end of the current hunk, and return its position." (let (end) (when (looking-at diff-hunk-header-re) ;; Especially important for unified (because headers are ambiguous). (setq style (diff-hunk-style style)) (goto-char (match-end 0)) (when (and (not donttrustheader) (match-end 2)) (let* ((nold (string-to-number (or (match-string 2) "1"))) (nnew (string-to-number (or (match-string 4) "1"))) (endold (save-excursion (re-search-forward (if diff-valid-unified-empty-line "^[- \n]" "^[- ]") nil t nold) (line-beginning-position ;; Skip potential "\ No newline at end of file". (if (looking-at ".*\n\\\\") 3 2)))) (endnew ;; The hunk may end with a bunch of "+" lines, so the `end' is ;; then further than computed above. (save-excursion (re-search-forward (if diff-valid-unified-empty-line "^[+ \n]" "^[+ ]") nil t nnew) (line-beginning-position ;; Skip potential "\ No newline at end of file". (if (looking-at ".*\n\\\\") 3 2))))) (setq end (max endold endnew))))) ;; We may have a first evaluation of `end' thanks to the hunk header. (unless end (setq end (and (re-search-forward (pcase style ('unified (concat (if diff-valid-unified-empty-line "^[^-+# \\\n]\\|" "^[^-+# \\]\\|") ;; A `unified' header is ambiguous. diff-file-header-re)) ('context "^[^-+#! \\]") ('normal "^[^<>#\\]") (_ "^[^-+#!<> \\]")) nil t) (match-beginning 0))) (when diff-valid-unified-empty-line ;; While empty lines may be valid inside hunks, they are also likely ;; to be unrelated to the hunk. (goto-char (or end (point-max))) (while (eq ?\n (char-before (1- (point)))) (forward-char -1) (setq end (point))))) ;; The return value is used by easy-mmode-define-navigation. (goto-char (or end (point-max))))) ;; "index ", "old mode", "new mode", "new file mode" and ;; "deleted file mode" are output by git-diff. (defconst diff-file-junk-re (concat "Index: \\|Prereq: \\|=\\{20,\\}\\|" ; SVN "diff \\|index \\|\\(?:deleted file\\|new\\(?: file\\)?\\|old\\) mode\\|=== modified file")) ;; If point is in a diff header, then return beginning ;; of hunk position otherwise return nil. (defun diff--at-diff-header-p () "Return non-nil if point is inside a diff header." (let ((regexp-hunk diff-hunk-header-re) (regexp-file diff-file-header-re) (regexp-junk diff-file-junk-re) (orig (point))) (catch 'headerp (save-excursion (forward-line 0) (when (looking-at regexp-hunk) ; Hunk header. (throw 'headerp (point))) (forward-line -1) (when (re-search-forward regexp-file (point-at-eol 4) t) ; File header. (forward-line 0) (throw 'headerp (point))) (goto-char orig) (forward-line 0) (when (looking-at regexp-junk) ; Git diff junk. (while (and (looking-at regexp-junk) (not (bobp))) (forward-line -1)) (re-search-forward regexp-file nil t) (forward-line 0) (throw 'headerp (point)))) nil))) (defun diff-beginning-of-hunk (&optional try-harder) "Move back to the previous hunk beginning, and return its position. If point is in a file header rather than a hunk, advance to the next hunk if TRY-HARDER is non-nil; otherwise signal an error." (beginning-of-line) (if (looking-at diff-hunk-header-re) ; At hunk header. (point) (let ((pos (diff--at-diff-header-p)) (regexp diff-hunk-header-re)) (cond (pos ; At junk diff header. (if try-harder (goto-char pos) (error "Can't find the beginning of the hunk"))) ((re-search-backward regexp nil t)) ; In the middle of a hunk. ((re-search-forward regexp nil t) ; At first hunk header. (forward-line 0) (point)) (t (error "Can't find the beginning of the hunk")))))) (defun diff-unified-hunk-p () (save-excursion (ignore-errors (diff-beginning-of-hunk) (looking-at "^@@")))) (defun diff-beginning-of-file () (beginning-of-line) (unless (looking-at diff-file-header-re) (let ((start (point)) res) ;; diff-file-header-re may need to match up to 4 lines, so in case ;; we're inside the header, we need to move up to 3 lines forward. (forward-line 3) (if (and (setq res (re-search-backward diff-file-header-re nil t)) ;; Maybe the 3 lines forward were too much and we matched ;; a file header after our starting point :-( (or (<= (point) start) (setq res (re-search-backward diff-file-header-re nil t)))) res (goto-char start) (error "Can't find the beginning of the file"))))) (defun diff-end-of-file () (re-search-forward "^[-+#!<>0-9@* \\]" nil t) (re-search-forward (concat "^[^-+#!<>0-9@* \\]\\|" diff-file-header-re) nil 'move) (if (match-beginning 1) (goto-char (match-beginning 1)) (beginning-of-line))) (defvar diff--auto-refine-data nil) ;; Define diff-{hunk,file}-{prev,next} (easy-mmode-define-navigation diff-hunk diff-hunk-header-re "hunk" diff-end-of-hunk diff-restrict-view (when diff-auto-refine-mode (unless (prog1 diff--auto-refine-data (setq diff--auto-refine-data (cons (current-buffer) (point-marker)))) (run-at-time 0.0 nil (lambda () (when diff--auto-refine-data (let ((buffer (car diff--auto-refine-data)) (point (cdr diff--auto-refine-data))) (setq diff--auto-refine-data nil) (with-local-quit (when (buffer-live-p buffer) (with-current-buffer buffer (save-excursion (goto-char point) (diff-refine-hunk)))))))))))) (easy-mmode-define-navigation diff-file diff-file-header-re "file" diff-end-of-file) (defun diff-bounds-of-hunk () "Return the bounds of the diff hunk at point. The return value is a list (BEG END), which are the hunk's start and end positions. Signal an error if no hunk is found. If point is in a file header, return the bounds of the next hunk." (save-excursion (let ((pos (point)) (beg (diff-beginning-of-hunk t)) (end (diff-end-of-hunk))) (cond ((>= end pos) (list beg end)) ;; If this hunk ends above POS, consider the next hunk. ((re-search-forward diff-hunk-header-re nil t) (list (match-beginning 0) (diff-end-of-hunk))) (t (error "No hunk found")))))) (defun diff-bounds-of-file () "Return the bounds of the file segment at point. The return value is a list (BEG END), which are the segment's start and end positions." (save-excursion (let ((pos (point)) (beg (progn (diff-beginning-of-file-and-junk) (point)))) (diff-end-of-file) ;; bzr puts a newline after the last hunk. (while (looking-at "^\n") (forward-char 1)) (if (> pos (point)) (error "Not inside a file diff")) (list beg (point))))) (defun diff-restrict-view (&optional arg) "Restrict the view to the current hunk. If the prefix ARG is given, restrict the view to the current file instead." (interactive "P") (apply 'narrow-to-region (if arg (diff-bounds-of-file) (diff-bounds-of-hunk))) (set (make-local-variable 'diff-narrowed-to) (if arg 'file 'hunk))) (defun diff--some-hunks-p () (save-excursion (goto-char (point-min)) (re-search-forward diff-hunk-header-re nil t))) (defun diff-hunk-kill () "Kill the hunk at point." (interactive) (if (not (diff--some-hunks-p)) (error "No hunks") (diff-beginning-of-hunk t) (let* ((hunk-bounds (diff-bounds-of-hunk)) (file-bounds (ignore-errors (diff-bounds-of-file))) ;; If the current hunk is the only one for its file, kill the ;; file header too. (bounds (if (and file-bounds (progn (goto-char (car file-bounds)) (= (progn (diff-hunk-next) (point)) (car hunk-bounds))) (progn (goto-char (cadr hunk-bounds)) ;; bzr puts a newline after the last hunk. (while (looking-at "^\n") (forward-char 1)) (= (point) (cadr file-bounds)))) file-bounds hunk-bounds)) (inhibit-read-only t)) (apply 'kill-region bounds) (goto-char (car bounds)) (ignore-errors (diff-beginning-of-hunk t))))) (defun diff-beginning-of-file-and-junk () "Go to the beginning of file-related diff-info. This is like `diff-beginning-of-file' except it tries to skip back over leading data such as \"Index: ...\" and such." (let* ((orig (point)) ;; Skip forward over what might be "leading junk" so as to get ;; closer to the actual diff. (_ (progn (beginning-of-line) (while (looking-at diff-file-junk-re) (forward-line 1)))) (start (point)) (prevfile (condition-case err (save-excursion (diff-beginning-of-file) (point)) (error err))) (err (if (consp prevfile) prevfile)) (nextfile (ignore-errors (save-excursion (goto-char start) (diff-file-next) (point)))) ;; prevhunk is one of the limits. (prevhunk (save-excursion (ignore-errors (if (numberp prevfile) (goto-char prevfile)) (diff-hunk-prev) (point)))) (previndex (save-excursion (forward-line 1) ;In case we're looking at "Index:". (re-search-backward "^Index: " prevhunk t)))) ;; If we're in the junk, we should use nextfile instead of prevfile. (if (and (numberp nextfile) (or (not (numberp prevfile)) (and previndex (> previndex prevfile)))) (setq prevfile nextfile)) (if (and previndex (numberp prevfile) (< previndex prevfile)) (setq prevfile previndex)) (if (and (numberp prevfile) (<= prevfile start)) (progn (goto-char prevfile) ;; Now skip backward over the leading junk we may have before the ;; diff itself. (while (save-excursion (and (zerop (forward-line -1)) (looking-at diff-file-junk-re))) (forward-line -1))) ;; File starts *after* the starting point: we really weren't in ;; a file diff but elsewhere. (goto-char orig) (signal (car err) (cdr err))))) (defun diff-file-kill () "Kill current file's hunks." (interactive) (if (not (diff--some-hunks-p)) (error "No hunks") (diff-beginning-of-hunk t) (let ((inhibit-read-only t)) (apply 'kill-region (diff-bounds-of-file))) (ignore-errors (diff-beginning-of-hunk t)))) (defun diff-kill-junk () "Kill spurious empty diffs." (interactive) (save-excursion (let ((inhibit-read-only t)) (goto-char (point-min)) (while (re-search-forward (concat "^\\(Index: .*\n\\)" "\\([^-+!* <>].*\n\\)*?" "\\(\\(Index:\\) \\|" diff-file-header-re "\\)") nil t) (delete-region (if (match-end 4) (match-beginning 0) (match-end 1)) (match-beginning 3)) (beginning-of-line))))) (defun diff-count-matches (re start end) (save-excursion (let ((n 0)) (goto-char start) (while (re-search-forward re end t) (cl-incf n)) n))) (defun diff-splittable-p () (save-excursion (beginning-of-line) (and (looking-at "^[-+ ]") (progn (forward-line -1) (looking-at "^[-+ ]")) (diff-unified-hunk-p)))) (defun diff-split-hunk () "Split the current (unified diff) hunk at point into two hunks." (interactive) (beginning-of-line) (let ((pos (point)) (start (diff-beginning-of-hunk))) (unless (looking-at diff-hunk-header-re-unified) (error "diff-split-hunk only works on unified context diffs")) (forward-line 1) (let* ((start1 (string-to-number (match-string 1))) (start2 (string-to-number (match-string 3))) (newstart1 (+ start1 (diff-count-matches "^[- \t]" (point) pos))) (newstart2 (+ start2 (diff-count-matches "^[+ \t]" (point) pos))) (inhibit-read-only t)) (goto-char pos) ;; Hopefully the after-change-function will not screw us over. (insert "@@ -" (number-to-string newstart1) ",1 +" (number-to-string newstart2) ",1 @@\n") ;; Fix the original hunk-header. (diff-fixup-modifs start pos)))) ;;;; ;;;; jump to other buffers ;;;; (defvar diff-remembered-files-alist nil) (defvar diff-remembered-defdir nil) (defun diff-filename-drop-dir (file) (when (string-match "/" file) (substring file (match-end 0)))) (defun diff-merge-strings (ancestor from to) "Merge the diff between ANCESTOR and FROM into TO. Returns the merged string if successful or nil otherwise. The strings are assumed not to contain any \"\\n\" (i.e. end of line). If ANCESTOR = FROM, returns TO. If ANCESTOR = TO, returns FROM. The heuristic is simplistic and only really works for cases like \(diff-merge-strings \"b/foo\" \"b/bar\" \"/a/c/foo\")." ;; Ideally, we want: ;; AMB ANB CMD -> CND ;; but that's ambiguous if `foo' or `bar' is empty: ;; a/foo a/foo1 b/foo.c -> b/foo1.c but not 1b/foo.c or b/foo.c1 (let ((str (concat ancestor "\n" from "\n" to))) (when (and (string-match (concat "\\`\\(.*?\\)\\(.*\\)\\(.*\\)\n" "\\1\\(.*\\)\\3\n" "\\(.*\\(\\2\\).*\\)\\'") str) (equal to (match-string 5 str))) (concat (substring str (match-beginning 5) (match-beginning 6)) (match-string 4 str) (substring str (match-end 6) (match-end 5)))))) (defun diff-tell-file-name (old name) "Tell Emacs where the find the source file of the current hunk. If the OLD prefix arg is passed, tell the file NAME of the old file." (interactive (let* ((old current-prefix-arg) (fs (diff-hunk-file-names current-prefix-arg))) (unless fs (error "No file name to look for")) (list old (read-file-name (format "File for %s: " (car fs)) nil (diff-find-file-name old 'noprompt) t)))) (let ((fs (diff-hunk-file-names old))) (unless fs (error "No file name to look for")) (push (cons fs name) diff-remembered-files-alist))) (defun diff-hunk-file-names (&optional old) "Give the list of file names textually mentioned for the current hunk." (save-excursion (unless (looking-at diff-file-header-re) (or (ignore-errors (diff-beginning-of-file)) (re-search-forward diff-file-header-re nil t))) (let ((limit (save-excursion (condition-case () (progn (diff-hunk-prev) (point)) (error (point-min))))) (header-files ;; handle filenames with spaces; ;; cf. diff-font-lock-keywords / diff-file-header (if (looking-at "[-*][-*][-*] \\([^\t\n]+\\).*\n[-+][-+][-+] \\([^\t\n]+\\)") (list (if old (match-string 1) (match-string 2)) (if old (match-string 2) (match-string 1))) (forward-line 1) nil))) (delq nil (append (when (and (not old) (save-excursion (re-search-backward "^Index: \\(.+\\)" limit t))) (list (match-string 1))) header-files ;; this assumes that there are no spaces in filenames (when (re-search-backward "^diff \\(-\\S-+ +\\)*\\(\\S-+\\)\\( +\\(\\S-+\\)\\)?" nil t) (list (if old (match-string 2) (match-string 4)) (if old (match-string 4) (match-string 2))))))))) (defun diff-find-file-name (&optional old noprompt prefix) "Return the file corresponding to the current patch. Non-nil OLD means that we want the old file. Non-nil NOPROMPT means to prefer returning nil than to prompt the user. PREFIX is only used internally: don't use it." (unless (equal diff-remembered-defdir default-directory) ;; Flush diff-remembered-files-alist if the default-directory is changed. (set (make-local-variable 'diff-remembered-defdir) default-directory) (set (make-local-variable 'diff-remembered-files-alist) nil)) (save-excursion (save-restriction (widen) (unless (looking-at diff-file-header-re) (or (ignore-errors (diff-beginning-of-file)) (re-search-forward diff-file-header-re nil t))) (let ((fs (diff-hunk-file-names old))) (if prefix (setq fs (mapcar (lambda (f) (concat prefix f)) fs))) (or ;; use any previously used preference (cdr (assoc fs diff-remembered-files-alist)) ;; try to be clever and use previous choices as an inspiration (cl-dolist (rf diff-remembered-files-alist) (let ((newfile (diff-merge-strings (caar rf) (car fs) (cdr rf)))) (if (and newfile (file-exists-p newfile)) (cl-return newfile)))) ;; look for each file in turn. If none found, try again but ;; ignoring the first level of directory, ... (cl-do* ((files fs (delq nil (mapcar #'diff-filename-drop-dir files))) (file nil nil)) ((or (null files) (setq file (cl-do* ((files files (cdr files)) (file (car files) (car files))) ;; Use file-regular-p to avoid ;; /dev/null, directories, etc. ((or (null file) (file-regular-p file)) file)))) file)) ;; .rej patches implicitly apply to (and (string-match "\\.rej\\'" (or buffer-file-name "")) (let ((file (substring buffer-file-name 0 (match-beginning 0)))) (when (file-exists-p file) file))) ;; If we haven't found the file, maybe it's because we haven't paid ;; attention to the PCL-CVS hint. (and (not prefix) (boundp 'cvs-pcl-cvs-dirchange-re) (save-excursion (re-search-backward cvs-pcl-cvs-dirchange-re nil t)) (diff-find-file-name old noprompt (match-string 1))) ;; if all else fails, ask the user (unless noprompt (let ((file (expand-file-name (or (car fs) "")))) (setq file (read-file-name (format "Use file %s: " file) (file-name-directory file) file t (file-name-nondirectory file))) (set (make-local-variable 'diff-remembered-files-alist) (cons (cons fs file) diff-remembered-files-alist)) file))))))) (defun diff-ediff-patch () "Call `ediff-patch-file' on the current buffer." (interactive) (condition-case nil (ediff-patch-file nil (current-buffer)) (wrong-number-of-arguments (ediff-patch-file)))) ;;;; ;;;; Conversion functions ;;;; ;;(defvar diff-inhibit-after-change nil ;; "Non-nil means inhibit `diff-mode's after-change functions.") (defun diff-unified->context (start end) "Convert unified diffs to context diffs. START and END are either taken from the region (if a prefix arg is given) or else cover the whole buffer." (interactive (if (or current-prefix-arg (use-region-p)) (list (region-beginning) (region-end)) (list (point-min) (point-max)))) (unless (markerp end) (setq end (copy-marker end t))) (let (;;(diff-inhibit-after-change t) (inhibit-read-only t)) (save-excursion (goto-char start) (while (and (re-search-forward (concat "^\\(\\(---\\) .+\n\\(\\+\\+\\+\\) .+\\|" diff-hunk-header-re-unified ".*\\)$") nil t) (< (point) end)) (combine-after-change-calls (if (match-beginning 2) ;; we matched a file header (progn ;; use reverse order to make sure the indices are kept valid (replace-match "---" t t nil 3) (replace-match "***" t t nil 2)) ;; we matched a hunk header (let ((line1 (match-string 4)) (lines1 (or (match-string 5) "1")) (line2 (match-string 6)) (lines2 (or (match-string 7) "1")) ;; Variables to use the special undo function. (old-undo buffer-undo-list) (old-end (marker-position end)) (start (match-beginning 0)) (reversible t)) (replace-match (concat "***************\n*** " line1 "," (number-to-string (+ (string-to-number line1) (string-to-number lines1) -1)) " ****")) (save-restriction (narrow-to-region (line-beginning-position 2) ;; Call diff-end-of-hunk from just before ;; the hunk header so it can use the hunk ;; header info. (progn (diff-end-of-hunk 'unified) (point))) (let ((hunk (buffer-string))) (goto-char (point-min)) (if (not (save-excursion (re-search-forward "^-" nil t))) (delete-region (point) (point-max)) (goto-char (point-max)) (let ((modif nil) last-pt) (while (progn (setq last-pt (point)) (= (forward-line -1) 0)) (pcase (char-after) (?\s (insert " ") (setq modif nil) (backward-char 1)) (?+ (delete-region (point) last-pt) (setq modif t)) (?- (if (not modif) (progn (forward-char 1) (insert " ")) (delete-char 1) (insert "! ")) (backward-char 2)) (?\\ (when (save-excursion (forward-line -1) (= (char-after) ?+)) (delete-region (point) last-pt) (setq modif t))) ;; diff-valid-unified-empty-line. (?\n (insert " ") (setq modif nil) (backward-char 2)) (_ (setq modif nil)))))) (goto-char (point-max)) (save-excursion (insert "--- " line2 "," (number-to-string (+ (string-to-number line2) (string-to-number lines2) -1)) " ----\n" hunk)) ;;(goto-char (point-min)) (forward-line 1) (if (not (save-excursion (re-search-forward "^+" nil t))) (delete-region (point) (point-max)) (let ((modif nil) (delete nil)) (if (save-excursion (re-search-forward "^\\+.*\n-" nil t)) ;; Normally, lines in a substitution come with ;; first the removals and then the additions, and ;; the context->unified function follows this ;; convention, of course. Yet, other alternatives ;; are valid as well, but they preclude the use of ;; context->unified as an undo command. (setq reversible nil)) (while (not (eobp)) (pcase (char-after) (?\s (insert " ") (setq modif nil) (backward-char 1)) (?- (setq delete t) (setq modif t)) (?+ (if (not modif) (progn (forward-char 1) (insert " ")) (delete-char 1) (insert "! ")) (backward-char 2)) (?\\ (when (save-excursion (forward-line 1) (not (eobp))) (setq delete t) (setq modif t))) ;; diff-valid-unified-empty-line. (?\n (insert " ") (setq modif nil) (backward-char 2) (setq reversible nil)) (_ (setq modif nil))) (let ((last-pt (point))) (forward-line 1) (when delete (delete-region last-pt (point)) (setq delete nil))))))) (unless (or (not reversible) (eq buffer-undo-list t)) ;; Drop the many undo entries and replace them with ;; a single entry that uses diff-context->unified to do ;; the work. (setq buffer-undo-list (cons (list 'apply (- old-end end) start (point-max) 'diff-context->unified start (point-max)) old-undo))))))))))) (defun diff-context->unified (start end &optional to-context) "Convert context diffs to unified diffs. START and END are either taken from the region \(when it is highlighted) or else cover the whole buffer. With a prefix argument, convert unified format to context format." (interactive (if (use-region-p) (list (region-beginning) (region-end) current-prefix-arg) (list (point-min) (point-max) current-prefix-arg))) (if to-context (diff-unified->context start end) (unless (markerp end) (setq end (copy-marker end t))) (let ( ;;(diff-inhibit-after-change t) (inhibit-read-only t)) (save-excursion (goto-char start) (while (and (re-search-forward "^\\(\\(\\*\\*\\*\\) .+\n\\(---\\) .+\\|\\*\\{15\\}.*\n\\*\\*\\* \\([0-9]+\\),\\(-?[0-9]+\\) \\*\\*\\*\\*\\)\\(?: \\(.*\\)\\|$\\)" nil t) (< (point) end)) (combine-after-change-calls (if (match-beginning 2) ;; we matched a file header (progn ;; use reverse order to make sure the indices are kept valid (replace-match "+++" t t nil 3) (replace-match "---" t t nil 2)) ;; we matched a hunk header (let ((line1s (match-string 4)) (line1e (match-string 5)) (pt1 (match-beginning 0)) ;; Variables to use the special undo function. (old-undo buffer-undo-list) (old-end (marker-position end)) ;; We currently throw away the comment that can follow ;; the hunk header. FIXME: Preserve it instead! (reversible (not (match-end 6)))) (replace-match "") (unless (re-search-forward diff-context-mid-hunk-header-re nil t) (error "Can't find matching `--- n1,n2 ----' line")) (let ((line2s (match-string 1)) (line2e (match-string 2)) (pt2 (progn (delete-region (progn (beginning-of-line) (point)) (progn (forward-line 1) (point))) (point-marker)))) (goto-char pt1) (forward-line 1) (while (< (point) pt2) (pcase (char-after) (?! (delete-char 2) (insert "-") (forward-line 1)) (?- (forward-char 1) (delete-char 1) (forward-line 1)) (?\s ;merge with the other half of the chunk (let* ((endline2 (save-excursion (goto-char pt2) (forward-line 1) (point)))) (pcase (char-after pt2) ((or ?! ?+) (insert "+" (prog1 (buffer-substring (+ pt2 2) endline2) (delete-region pt2 endline2)))) (?\s (unless (= (- endline2 pt2) (- (line-beginning-position 2) (point))) ;; If the two lines we're merging don't have the ;; same length (can happen with "diff -b"), then ;; diff-unified->context will not properly undo ;; this operation. (setq reversible nil)) (delete-region pt2 endline2) (delete-char 1) (forward-line 1)) (?\\ (forward-line 1)) (_ (setq reversible nil) (delete-char 1) (forward-line 1))))) (_ (setq reversible nil) (forward-line 1)))) (while (looking-at "[+! ] ") (if (/= (char-after) ?!) (forward-char 1) (delete-char 1) (insert "+")) (delete-char 1) (forward-line 1)) (save-excursion (goto-char pt1) (insert "@@ -" line1s "," (number-to-string (- (string-to-number line1e) (string-to-number line1s) -1)) " +" line2s "," (number-to-string (- (string-to-number line2e) (string-to-number line2s) -1)) " @@")) (set-marker pt2 nil) ;; The whole procedure succeeded, let's replace the myriad ;; of undo elements with just a single special one. (unless (or (not reversible) (eq buffer-undo-list t)) (setq buffer-undo-list (cons (list 'apply (- old-end end) pt1 (point) 'diff-unified->context pt1 (point)) old-undo))) ))))))))) (defun diff-reverse-direction (start end) "Reverse the direction of the diffs. START and END are either taken from the region (if a prefix arg is given) or else cover the whole buffer." (interactive (if (or current-prefix-arg (use-region-p)) (list (region-beginning) (region-end)) (list (point-min) (point-max)))) (unless (markerp end) (setq end (copy-marker end t))) (let (;;(diff-inhibit-after-change t) (inhibit-read-only t)) (save-excursion (goto-char start) (while (and (re-search-forward "^\\(\\([-*][-*][-*] \\)\\(.+\\)\n\\([-+][-+][-+] \\)\\(.+\\)\\|\\*\\{15\\}.*\n\\*\\*\\* \\(.+\\) \\*\\*\\*\\*\\|@@ -\\([0-9,]+\\) \\+\\([0-9,]+\\) @@.*\\)$" nil t) (< (point) end)) (combine-after-change-calls (cond ;; a file header ((match-beginning 2) (replace-match "\\2\\5\n\\4\\3" nil)) ;; a context-diff hunk header ((match-beginning 6) (let ((pt-lines1 (match-beginning 6)) (lines1 (match-string 6))) (replace-match "" nil nil nil 6) (forward-line 1) (let ((half1s (point))) (while (looking-at "[-! \\][ \t]\\|#") (when (= (char-after) ?-) (delete-char 1) (insert "+")) (forward-line 1)) (let ((half1 (delete-and-extract-region half1s (point)))) (unless (looking-at diff-context-mid-hunk-header-re) (insert half1) (error "Can't find matching `--- n1,n2 ----' line")) (let* ((str1end (or (match-end 2) (match-end 1))) (str1 (buffer-substring (match-beginning 1) str1end))) (goto-char str1end) (insert lines1) (delete-region (match-beginning 1) str1end) (forward-line 1) (let ((half2s (point))) (while (looking-at "[!+ \\][ \t]\\|#") (when (= (char-after) ?+) (delete-char 1) (insert "-")) (forward-line 1)) (let ((half2 (delete-and-extract-region half2s (point)))) (insert (or half1 "")) (goto-char half1s) (insert (or half2 "")))) (goto-char pt-lines1) (insert str1)))))) ;; a unified-diff hunk header ((match-beginning 7) (replace-match "@@ -\\8 +\\7 @@" nil) (forward-line 1) (let ((c (char-after)) first last) (while (pcase (setq c (char-after)) (?- (setq first (or first (point))) (delete-char 1) (insert "+") t) (?+ (setq last (or last (point))) (delete-char 1) (insert "-") t) ((or ?\\ ?#) t) (_ (when (and first last (< first last)) (insert (delete-and-extract-region first last))) (setq first nil last nil) (memq c (if diff-valid-unified-empty-line '(?\s ?\n) '(?\s))))) (forward-line 1)))))))))) (defun diff-fixup-modifs (start end) "Fixup the hunk headers (in case the buffer was modified). START and END are either taken from the region (if a prefix arg is given) or else cover the whole buffer." (interactive (if (or current-prefix-arg (use-region-p)) (list (region-beginning) (region-end)) (list (point-min) (point-max)))) (let ((inhibit-read-only t)) (save-excursion (goto-char end) (diff-end-of-hunk nil 'donttrustheader) (let ((plus 0) (minus 0) (space 0) (bang 0)) (while (and (= (forward-line -1) 0) (<= start (point))) (if (not (looking-at (concat diff-hunk-header-re-unified "\\|[-*][-*][-*] [0-9,]+ [-*][-*][-*][-*]$" "\\|--- .+\n\\+\\+\\+ "))) (pcase (char-after) (?\s (cl-incf space)) (?+ (cl-incf plus)) (?- (cl-incf minus)) (?! (cl-incf bang)) ((or ?\\ ?#) nil) (?\n (if diff-valid-unified-empty-line (cl-incf space) (setq space 0 plus 0 minus 0 bang 0))) (_ (setq space 0 plus 0 minus 0 bang 0))) (cond ((looking-at diff-hunk-header-re-unified) (let* ((old1 (match-string 2)) (old2 (match-string 4)) (new1 (number-to-string (+ space minus))) (new2 (number-to-string (+ space plus)))) (if old2 (unless (string= new2 old2) (replace-match new2 t t nil 4)) (goto-char (match-end 3)) (insert "," new2)) (if old1 (unless (string= new1 old1) (replace-match new1 t t nil 2)) (goto-char (match-end 1)) (insert "," new1)))) ((looking-at diff-context-mid-hunk-header-re) (when (> (+ space bang plus) 0) (let* ((old1 (match-string 1)) (old2 (match-string 2)) (new (number-to-string (+ space bang plus -1 (string-to-number old1))))) (unless (string= new old2) (replace-match new t t nil 2))))) ((looking-at "\\*\\*\\* \\([0-9]+\\),\\(-?[0-9]*\\) \\*\\*\\*\\*$") (when (> (+ space bang minus) 0) (let* ((old (match-string 1)) (new (format (concat "%0" (number-to-string (length old)) "d") (+ space bang minus -1 (string-to-number old))))) (unless (string= new old) (replace-match new t t nil 2)))))) (setq space 0 plus 0 minus 0 bang 0))))))) ;;;; ;;;; Hooks ;;;; (defun diff-write-contents-hooks () "Fixup hunk headers if necessary." (if (buffer-modified-p) (diff-fixup-modifs (point-min) (point-max))) nil) ;; It turns out that making changes in the buffer from within an ;; *-change-function is asking for trouble, whereas making them ;; from a post-command-hook doesn't pose much problems (defvar diff-unhandled-changes nil) (defun diff-after-change-function (beg end _len) "Remember to fixup the hunk header. See `after-change-functions' for the meaning of BEG, END and LEN." ;; Ignoring changes when inhibit-read-only is set is strictly speaking ;; incorrect, but it turns out that inhibit-read-only is normally not set ;; inside editing commands, while it tends to be set when the buffer gets ;; updated by an async process or by a conversion function, both of which ;; would rather not be uselessly slowed down by this hook. (when (and (not undo-in-progress) (not inhibit-read-only)) (if diff-unhandled-changes (setq diff-unhandled-changes (cons (min beg (car diff-unhandled-changes)) (max end (cdr diff-unhandled-changes)))) (setq diff-unhandled-changes (cons beg end))))) (defun diff-post-command-hook () "Fixup hunk headers if necessary." (when (consp diff-unhandled-changes) (ignore-errors (save-excursion (goto-char (car diff-unhandled-changes)) ;; Maybe we've cut the end of the hunk before point. (if (and (bolp) (not (bobp))) (backward-char 1)) ;; We used to fixup modifs on all the changes, but it turns out that ;; it's safer not to do it on big changes, e.g. when yanking a big ;; diff, or when the user edits the header, since we might then ;; screw up perfectly correct values. --Stef (diff-beginning-of-hunk t) (let* ((style (if (looking-at "\\*\\*\\*") 'context)) (start (line-beginning-position (if (eq style 'context) 3 2))) (mid (if (eq style 'context) (save-excursion (re-search-forward diff-context-mid-hunk-header-re nil t))))) (when (and ;; Don't try to fixup changes in the hunk header. (>= (car diff-unhandled-changes) start) ;; Don't try to fixup changes in the mid-hunk header either. (or (not mid) (< (cdr diff-unhandled-changes) (match-beginning 0)) (> (car diff-unhandled-changes) (match-end 0))) (save-excursion (diff-end-of-hunk nil 'donttrustheader) ;; Don't try to fixup changes past the end of the hunk. (>= (point) (cdr diff-unhandled-changes)))) (diff-fixup-modifs (point) (cdr diff-unhandled-changes))))) (setq diff-unhandled-changes nil)))) (defun diff-next-error (arg reset) ;; Select a window that displays the current buffer so that point ;; movements are reflected in that window. Otherwise, the user might ;; never see the hunk corresponding to the source she's jumping to. (pop-to-buffer (current-buffer)) (if reset (goto-char (point-min))) (diff-hunk-next arg) (diff-goto-source)) (defun diff--font-lock-cleanup () (remove-overlays nil nil 'diff-mode 'fine) (remove-overlays nil nil 'diff-mode 'syntax) (when font-lock-mode (make-local-variable 'font-lock-extra-managed-props) ;; Added when diff--font-lock-prettify is non-nil! (cl-pushnew 'display font-lock-extra-managed-props))) (defvar whitespace-style) (defvar whitespace-trailing-regexp) ;;;###autoload (define-derived-mode diff-mode fundamental-mode "Diff" "Major mode for viewing/editing context diffs. Supports unified and context diffs as well as (to a lesser extent) normal diffs. When the buffer is read-only, the ESC prefix is not necessary. If you edit the buffer manually, diff-mode will try to update the hunk headers for you on-the-fly. You can also switch between context diff and unified diff with \\[diff-context->unified], or vice versa with \\[diff-unified->context] and you can also reverse the direction of a diff with \\[diff-reverse-direction]. \\{diff-mode-map}" (set (make-local-variable 'font-lock-defaults) diff-font-lock-defaults) (add-hook 'font-lock-mode-hook #'diff--font-lock-cleanup nil 'local) (set (make-local-variable 'outline-regexp) diff-outline-regexp) (set (make-local-variable 'imenu-generic-expression) diff-imenu-generic-expression) ;; These are not perfect. They would be better done separately for ;; context diffs and unidiffs. ;; (set (make-local-variable 'paragraph-start) ;; (concat "@@ " ; unidiff hunk ;; "\\|\\*\\*\\* " ; context diff hunk or file start ;; "\\|--- [^\t]+\t")) ; context or unidiff file ;; ; start (first or second line) ;; (set (make-local-variable 'paragraph-separate) paragraph-start) ;; (set (make-local-variable 'page-delimiter) "--- [^\t]+\t") ;; compile support (set (make-local-variable 'next-error-function) #'diff-next-error) (set (make-local-variable 'beginning-of-defun-function) #'diff-beginning-of-file-and-junk) (set (make-local-variable 'end-of-defun-function) #'diff-end-of-file) (diff-setup-whitespace) (if diff-default-read-only (setq buffer-read-only t)) ;; setup change hooks (if (not diff-update-on-the-fly) (add-hook 'write-contents-functions #'diff-write-contents-hooks nil t) (make-local-variable 'diff-unhandled-changes) (add-hook 'after-change-functions #'diff-after-change-function nil t) (add-hook 'post-command-hook #'diff-post-command-hook nil t)) ;; Neat trick from Dave Love to add more bindings in read-only mode: (let ((ro-bind (cons 'buffer-read-only diff-mode-shared-map))) (add-to-list 'minor-mode-overriding-map-alist ro-bind) ;; Turn off this little trick in case the buffer is put in view-mode. (add-hook 'view-mode-hook (lambda () (setq minor-mode-overriding-map-alist (delq ro-bind minor-mode-overriding-map-alist))) nil t)) ;; add-log support (set (make-local-variable 'add-log-current-defun-function) #'diff-current-defun) (set (make-local-variable 'add-log-buffer-file-name-function) (lambda () (diff-find-file-name nil 'noprompt))) (add-function :filter-return (local 'filter-buffer-substring-function) #'diff--filter-substring) (unless (buffer-file-name) (hack-dir-local-variables-non-file-buffer))) ;;;###autoload (define-minor-mode diff-minor-mode "Toggle Diff minor mode. \\{diff-minor-mode-map}" :group 'diff-mode :lighter " Diff" ;; FIXME: setup font-lock ;; setup change hooks (if (not diff-update-on-the-fly) (add-hook 'write-contents-functions #'diff-write-contents-hooks nil t) (make-local-variable 'diff-unhandled-changes) (add-hook 'after-change-functions #'diff-after-change-function nil t) (add-hook 'post-command-hook #'diff-post-command-hook nil t))) ;;; Handy hook functions ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; (defun diff-setup-whitespace () "Set up Whitespace mode variables for the current Diff mode buffer. This sets `whitespace-style' and `whitespace-trailing-regexp' so that Whitespace mode shows trailing whitespace problems on the modified lines of the diff." (set (make-local-variable 'whitespace-style) '(face trailing)) (let ((style (save-excursion (goto-char (point-min)) ;; FIXME: For buffers filled from async processes, this search ;; will simply fail because the buffer is still empty :-( (when (re-search-forward diff-hunk-header-re nil t) (goto-char (match-beginning 0)) (diff-hunk-style))))) (set (make-local-variable 'whitespace-trailing-regexp) (if (eq style 'context) "^[-+!] .*?\\([\t ]+\\)$" "^[-+!<>].*?\\([\t ]+\\)$")))) (defun diff-delete-if-empty () ;; An empty diff file means there's no more diffs to integrate, so we ;; can just remove the file altogether. Very handy for .rej files if we ;; remove hunks as we apply them. (when (and buffer-file-name (eq 0 (file-attribute-size (file-attributes buffer-file-name)))) (delete-file buffer-file-name))) (defun diff-delete-empty-files () "Arrange for empty diff files to be removed." (add-hook 'after-save-hook #'diff-delete-if-empty nil t)) (defun diff-make-unified () "Turn context diffs into unified diffs if applicable." (if (save-excursion (goto-char (point-min)) (and (looking-at diff-hunk-header-re) (eq (char-after) ?*))) (let ((mod (buffer-modified-p))) (unwind-protect (diff-context->unified (point-min) (point-max)) (restore-buffer-modified-p mod))))) ;;; ;;; Misc operations that have proved useful at some point. ;;; (defun diff-next-complex-hunk () "Jump to the next \"complex\" hunk. \"Complex\" is approximated by \"the hunk changes the number of lines\". Only works for unified diffs." (interactive) (while (and (re-search-forward diff-hunk-header-re-unified nil t) (equal (match-string 2) (match-string 4))))) (defun diff-sanity-check-context-hunk-half (lines) (let ((count lines)) (while (cond ((and (memq (char-after) '(?\s ?! ?+ ?-)) (memq (char-after (1+ (point))) '(?\s ?\t))) (cl-decf count) t) ((or (zerop count) (= count lines)) nil) ((memq (char-after) '(?! ?+ ?-)) (if (not (and (eq (char-after (1+ (point))) ?\n) (y-or-n-p "Try to auto-fix whitespace loss damage? "))) (error "End of hunk ambiguously marked") (forward-char 1) (insert " ") (forward-line -1) t)) ((< lines 0) (error "End of hunk ambiguously marked")) ((not (y-or-n-p "Try to auto-fix whitespace loss and word-wrap damage? ")) (error "Abort!")) ((eolp) (insert " ") (forward-line -1) t) (t (insert " ") (delete-region (- (point) 2) (- (point) 1)) t)) (forward-line)))) (defun diff-sanity-check-hunk () (let (;; Every modification is protected by a y-or-n-p, so it's probably ;; OK to override a read-only setting. (inhibit-read-only t)) (save-excursion (cond ((not (looking-at diff-hunk-header-re)) (error "Not recognizable hunk header")) ;; A context diff. ((eq (char-after) ?*) (if (not (looking-at "\\*\\{15\\}\\(?: .*\\)?\n\\*\\*\\* \\([0-9]+\\)\\(?:,\\([0-9]+\\)\\)? \\*\\*\\*\\*")) (error "Unrecognized context diff first hunk header format") (forward-line 2) (diff-sanity-check-context-hunk-half (if (match-end 2) (1+ (- (string-to-number (match-string 2)) (string-to-number (match-string 1)))) 1)) (if (not (looking-at diff-context-mid-hunk-header-re)) (error "Unrecognized context diff second hunk header format") (forward-line) (diff-sanity-check-context-hunk-half (if (match-end 2) (1+ (- (string-to-number (match-string 2)) (string-to-number (match-string 1)))) 1))))) ;; A unified diff. ((eq (char-after) ?@) (if (not (looking-at diff-hunk-header-re-unified)) (error "Unrecognized unified diff hunk header format") (let ((before (string-to-number (or (match-string 2) "1"))) (after (string-to-number (or (match-string 4) "1")))) (forward-line) (while (pcase (char-after) (?\s (cl-decf before) (cl-decf after) t) (?- (cond ((and (looking-at diff-separator-re) (zerop before) (zerop after)) nil) ((and (looking-at diff-file-header-re) (zerop before) (zerop after)) ;; No need to query: this is a case where two patches ;; are concatenated and only counting the lines will ;; give the right result. Let's just add an empty ;; line so that our code which doesn't count lines ;; will not get confused. (save-excursion (insert "\n")) nil) (t (cl-decf before) t))) (?+ (cl-decf after) t) (_ (cond ((and diff-valid-unified-empty-line ;; Not just (eolp) so we don't infloop at eob. (eq (char-after) ?\n) (> before 0) (> after 0)) (cl-decf before) (cl-decf after) t) ((and (zerop before) (zerop after)) nil) ((or (< before 0) (< after 0)) (error (if (or (zerop before) (zerop after)) "End of hunk ambiguously marked" "Hunk seriously messed up"))) ((not (y-or-n-p (concat "Try to auto-fix " (if (eolp) "whitespace loss" "word-wrap damage") "? "))) (error "Abort!")) ((eolp) (insert " ") (forward-line -1) t) (t (insert " ") (delete-region (- (point) 2) (- (point) 1)) t)))) (forward-line))))) ;; A plain diff. (t ;; TODO. ))))) (defun diff-hunk-text (hunk destp char-offset) "Return the literal source text from HUNK as (TEXT . OFFSET). If DESTP is nil, TEXT is the source, otherwise the destination text. CHAR-OFFSET is a char-offset in HUNK, and OFFSET is the corresponding char-offset in TEXT." (with-temp-buffer (insert hunk) (goto-char (point-min)) (let ((src-pos nil) (dst-pos nil) (divider-pos nil) (num-pfx-chars 2)) ;; Set the following variables: ;; SRC-POS buffer pos of the source part of the hunk or nil if none ;; DST-POS buffer pos of the destination part of the hunk or nil ;; DIVIDER-POS buffer pos of any divider line separating the src & dst ;; NUM-PFX-CHARS number of line-prefix characters used by this format" (cond ((looking-at "^@@") ;; unified diff (setq num-pfx-chars 1) (forward-line 1) (setq src-pos (point) dst-pos (point))) ((looking-at "^\\*\\*") ;; context diff (forward-line 2) (setq src-pos (point)) (re-search-forward diff-context-mid-hunk-header-re nil t) (forward-line 0) (setq divider-pos (point)) (forward-line 1) (setq dst-pos (point))) ((looking-at "^[0-9]+a[0-9,]+$") ;; normal diff, insert (forward-line 1) (setq dst-pos (point))) ((looking-at "^[0-9,]+d[0-9]+$") ;; normal diff, delete (forward-line 1) (setq src-pos (point))) ((looking-at "^[0-9,]+c[0-9,]+$") ;; normal diff, change (forward-line 1) (setq src-pos (point)) (re-search-forward "^---$" nil t) (forward-line 0) (setq divider-pos (point)) (forward-line 1) (setq dst-pos (point))) (t (error "Unknown diff hunk type"))) (if (if destp (null dst-pos) (null src-pos)) ;; Implied empty text (if char-offset '("" . 0) "") ;; For context diffs, either side can be empty, (if there's only ;; added or only removed text). We should then use the other side. (cond ((equal src-pos divider-pos) (setq src-pos dst-pos)) ((equal dst-pos (point-max)) (setq dst-pos src-pos))) (when char-offset (goto-char (+ (point-min) char-offset))) ;; Get rid of anything except the desired text. (save-excursion ;; Delete unused text region (let ((keep (if destp dst-pos src-pos))) (when (and divider-pos (> divider-pos keep)) (delete-region divider-pos (point-max))) (delete-region (point-min) keep)) ;; Remove line-prefix characters, and unneeded lines (unified diffs). ;; Also skip lines like "\ No newline at end of file" (let ((kill-chars (list (if destp ?- ?+) ?\\))) (goto-char (point-min)) (while (not (eobp)) (if (memq (char-after) kill-chars) (delete-region (point) (progn (forward-line 1) (point))) (delete-char num-pfx-chars) (forward-line 1))))) (let ((text (buffer-substring-no-properties (point-min) (point-max)))) (if char-offset (cons text (- (point) (point-min))) text)))))) (defun diff-find-text (text) "Return the buffer position (BEG . END) of the nearest occurrence of TEXT. If TEXT isn't found, nil is returned." (let* ((orig (point)) (forw (and (search-forward text nil t) (cons (match-beginning 0) (match-end 0)))) (back (and (goto-char (+ orig (length text))) (search-backward text nil t) (cons (match-beginning 0) (match-end 0))))) ;; Choose the closest match. (if (and forw back) (if (> (- (car forw) orig) (- orig (car back))) back forw) (or back forw)))) (defun diff-find-approx-text (text) "Return the buffer position (BEG . END) of the nearest occurrence of TEXT. Whitespace differences are ignored." (let* ((orig (point)) (re (concat "^[ \t\n ]*" (mapconcat #'regexp-quote (split-string text) "[ \t\n ]+") "[ \t\n ]*\n")) (forw (and (re-search-forward re nil t) (cons (match-beginning 0) (match-end 0)))) (back (and (goto-char (+ orig (length text))) (re-search-backward re nil t) (cons (match-beginning 0) (match-end 0))))) ;; Choose the closest match. (if (and forw back) (if (> (- (car forw) orig) (- orig (car back))) back forw) (or back forw)))) (defsubst diff-xor (a b) (if a (if (not b) a) b)) (defun diff-find-source-location (&optional other-file reverse noprompt) "Find out (BUF LINE-OFFSET POS SRC DST SWITCHED). BUF is the buffer corresponding to the source file. LINE-OFFSET is the offset between the expected and actual positions of the text of the hunk or nil if the text was not found. POS is a pair (BEG . END) indicating the position of the text in the buffer. SRC and DST are the two variants of text as returned by `diff-hunk-text'. SRC is the variant that was found in the buffer. SWITCHED is non-nil if the patch is already applied. NOPROMPT, if non-nil, means not to prompt the user." (save-excursion (let* ((other (diff-xor other-file diff-jump-to-old-file)) (char-offset (- (point) (diff-beginning-of-hunk t))) ;; Check that the hunk is well-formed. Otherwise diff-mode and ;; the user may disagree on what constitutes the hunk ;; (e.g. because an empty line truncates the hunk mid-course), ;; leading to potentially nasty surprises for the user. ;; ;; Suppress check when NOPROMPT is non-nil (Bug#3033). (_ (unless noprompt (diff-sanity-check-hunk))) (hunk (buffer-substring (point) (save-excursion (diff-end-of-hunk) (point)))) (old (diff-hunk-text hunk reverse char-offset)) (new (diff-hunk-text hunk (not reverse) char-offset)) ;; Find the location specification. (line (if (not (looking-at "\\(?:\\*\\{15\\}.*\n\\)?[-@* ]*\\([0-9,]+\\)\\([ acd+]+\\([0-9,]+\\)\\)?")) (error "Can't find the hunk header") (if other (match-string 1) (if (match-end 3) (match-string 3) (unless (re-search-forward diff-context-mid-hunk-header-re nil t) (error "Can't find the hunk separator")) (match-string 1))))) (file (or (diff-find-file-name other noprompt) (error "Can't find the file"))) (revision (and other diff-vc-backend (if reverse (nth 1 diff-vc-revisions) (or (nth 0 diff-vc-revisions) ;; When diff shows changes in working revision (vc-working-revision file))))) (buf (if revision (let ((vc-find-revision-no-save t)) (vc-find-revision (expand-file-name file) revision diff-vc-backend)) (find-file-noselect file)))) ;; Update the user preference if he so wished. (when (> (prefix-numeric-value other-file) 8) (setq diff-jump-to-old-file other)) (with-current-buffer buf (goto-char (point-min)) (forward-line (1- (string-to-number line))) (let* ((orig-pos (point)) (switched nil) ;; FIXME: Check for case where both OLD and NEW are found. (pos (or (diff-find-text (car old)) (progn (setq switched t) (diff-find-text (car new))) (progn (setq switched nil) (condition-case nil (diff-find-approx-text (car old)) (invalid-regexp nil))) ;Regex too big. (progn (setq switched t) (condition-case nil (diff-find-approx-text (car new)) (invalid-regexp nil))) ;Regex too big. (progn (setq switched nil) nil)))) (nconc (list buf) (if pos (list (count-lines orig-pos (car pos)) pos) (list nil (cons orig-pos (+ orig-pos (length (car old)))))) (if switched (list new old t) (list old new)))))))) (defun diff-hunk-status-msg (line-offset reversed dry-run) (let ((msg (if dry-run (if reversed "already applied" "not yet applied") (if reversed "undone" "applied")))) (message (cond ((null line-offset) "Hunk text not found") ((= line-offset 0) "Hunk %s") ((= line-offset 1) "Hunk %s at offset %d line") (t "Hunk %s at offset %d lines")) msg line-offset))) (defvar diff-apply-hunk-to-backup-file nil) (defun diff-apply-hunk (&optional reverse) "Apply the current hunk to the source file and go to the next. By default, the new source file is patched, but if the variable `diff-jump-to-old-file' is non-nil, then the old source file is patched instead (some commands, such as `diff-goto-source' can change the value of this variable when given an appropriate prefix argument). With a prefix argument, REVERSE the hunk." (interactive "P") (diff-beginning-of-hunk t) (pcase-let ((`(,buf ,line-offset ,pos ,old ,new ,switched) ;; Sometimes we'd like to have the following behavior: if ;; REVERSE go to the new file, otherwise go to the old. ;; But that means that by default we use the old file, which is ;; the opposite of the default for diff-goto-source, and is thus ;; confusing. Also when you don't know about it it's ;; pretty surprising. ;; TODO: make it possible to ask explicitly for this behavior. ;; ;; This is duplicated in diff-test-hunk. (diff-find-source-location nil reverse))) (cond ((null line-offset) (error "Can't find the text to patch")) ((with-current-buffer buf (and buffer-file-name (backup-file-name-p buffer-file-name) (not diff-apply-hunk-to-backup-file) (not (set (make-local-variable 'diff-apply-hunk-to-backup-file) (yes-or-no-p (format "Really apply this hunk to %s? " (file-name-nondirectory buffer-file-name))))))) (error "%s" (substitute-command-keys (format "Use %s\\[diff-apply-hunk] to apply it to the other file" (if (not reverse) "\\[universal-argument] "))))) ((and switched ;; A reversed patch was detected, perhaps apply it in reverse. (not (save-window-excursion (pop-to-buffer buf) (goto-char (+ (car pos) (cdr old))) (y-or-n-p (if reverse "Hunk hasn't been applied yet; apply it now? " "Hunk has already been applied; undo it? "))))) (message "(Nothing done)")) (t ;; Apply the hunk (with-current-buffer buf (goto-char (car pos)) (delete-region (car pos) (cdr pos)) (insert (car new))) ;; Display BUF in a window (set-window-point (display-buffer buf) (+ (car pos) (cdr new))) (diff-hunk-status-msg line-offset (diff-xor switched reverse) nil) (when diff-advance-after-apply-hunk (diff-hunk-next)))))) (defun diff-test-hunk (&optional reverse) "See whether it's possible to apply the current hunk. With a prefix argument, try to REVERSE the hunk." (interactive "P") (pcase-let ((`(,buf ,line-offset ,pos ,src ,_dst ,switched) (diff-find-source-location nil reverse))) (set-window-point (display-buffer buf) (+ (car pos) (cdr src))) (diff-hunk-status-msg line-offset (diff-xor reverse switched) t))) (defun diff-kill-applied-hunks () "Kill all hunks that have already been applied starting at point." (interactive) (while (not (eobp)) (pcase-let ((`(,_buf ,line-offset ,_pos ,_src ,_dst ,switched) (diff-find-source-location nil nil))) (if (and line-offset switched) (diff-hunk-kill) (diff-hunk-next))))) (defalias 'diff-mouse-goto-source 'diff-goto-source) (defun diff-goto-source (&optional other-file event) "Jump to the corresponding source line. `diff-jump-to-old-file' (or its opposite if the OTHER-FILE prefix arg is given) determines whether to jump to the old or the new file. If the prefix arg is bigger than 8 (for example with \\[universal-argument] \\[universal-argument]) then `diff-jump-to-old-file' is also set, for the next invocations. Under version control, the OTHER-FILE prefix arg means jump to the old revision of the file if point is on an old changed line, or to the new revision of the file otherwise." (interactive (list current-prefix-arg last-input-event)) ;; When pointing at a removal line, we probably want to jump to ;; the old location, and else to the new (i.e. as if reverting). ;; This is a convenient detail when using smerge-diff. (if event (posn-set-point (event-end event))) (let ((buffer (when event (current-buffer))) (reverse (not (save-excursion (beginning-of-line) (looking-at "[-<]"))))) (pcase-let ((`(,buf ,line-offset ,pos ,src ,_dst ,switched) (diff-find-source-location other-file reverse))) (pop-to-buffer buf) (goto-char (+ (car pos) (cdr src))) (when buffer (next-error-found buffer (current-buffer))) (diff-hunk-status-msg line-offset (diff-xor reverse switched) t)))) (defun diff-current-defun () "Find the name of function at point. For use in `add-log-current-defun-function'." ;; Kill change-log-default-name so it gets recomputed each time, since ;; each hunk may belong to another file which may belong to another ;; directory and hence have a different ChangeLog file. (kill-local-variable 'change-log-default-name) (save-excursion (when (looking-at diff-hunk-header-re) (forward-line 1) (re-search-forward "^[^ ]" nil t)) (pcase-let ((`(,buf ,_line-offset ,pos ,src ,dst ,switched) (ignore-errors ;Signals errors in place of prompting. ;; Use `noprompt' since this is used in which-func-mode ;; and such. (diff-find-source-location nil nil 'noprompt)))) (when buf (beginning-of-line) (or (when (memq (char-after) '(?< ?-)) ;; Cursor is pointing at removed text. This could be a removed ;; function, in which case, going to the source buffer will ;; not help since the function is now removed. Instead, ;; try to figure out the function name just from the ;; code-fragment. (let ((old (if switched dst src))) (with-temp-buffer (insert (car old)) (funcall (buffer-local-value 'major-mode buf)) (goto-char (+ (point-min) (cdr old))) (add-log-current-defun)))) (with-current-buffer buf (goto-char (+ (car pos) (cdr src))) (add-log-current-defun))))))) (defun diff-ignore-whitespace-hunk () "Re-diff the current hunk, ignoring whitespace differences." (interactive) (let* ((char-offset (- (point) (diff-beginning-of-hunk t))) (opts (pcase (char-after) (?@ "-bu") (?* "-bc") (_ "-b"))) (line-nb (and (or (looking-at "[^0-9]+\\([0-9]+\\)") (error "Can't find line number")) (string-to-number (match-string 1)))) (inhibit-read-only t) (hunk (delete-and-extract-region (point) (save-excursion (diff-end-of-hunk) (point)))) (lead (make-string (1- line-nb) ?\n)) ;Line nums start at 1. (file1 (make-temp-file "diff1")) (file2 (make-temp-file "diff2")) (coding-system-for-read buffer-file-coding-system) old new) (unwind-protect (save-excursion (setq old (diff-hunk-text hunk nil char-offset)) (setq new (diff-hunk-text hunk t char-offset)) (write-region (concat lead (car old)) nil file1 nil 'nomessage) (write-region (concat lead (car new)) nil file2 nil 'nomessage) (with-temp-buffer (let ((status (call-process diff-command nil t nil opts file1 file2))) (pcase status (0 nil) ;Nothing to reformat. (1 (goto-char (point-min)) ;; Remove the file-header. (when (re-search-forward diff-hunk-header-re nil t) (delete-region (point-min) (match-beginning 0)))) (_ (goto-char (point-max)) (unless (bolp) (insert "\n")) (insert hunk))) (setq hunk (buffer-string)) (unless (memq status '(0 1)) (error "Diff returned: %s" status))))) ;; Whatever happens, put back some equivalent text: either the new ;; one or the original one in case some error happened. (insert hunk) (delete-file file1) (delete-file file2)))) ;;; Fine change highlighting. (defface diff-refine-changed '((((class color) (min-colors 88) (background light)) :background "#ffff55") (((class color) (min-colors 88) (background dark)) :background "#aaaa22") (t :underline t)) "Face used for char-based changes shown by `diff-refine-hunk'.") (defface diff-refine-removed '((default :inherit diff-refine-changed) (((class color) (min-colors 88) (background light)) :background "#ffbbbb") (((class color) (min-colors 88) (background dark)) :background "#aa2222")) "Face used for removed characters shown by `diff-refine-hunk'." :version "24.3") (defface diff-refine-added '((default :inherit diff-refine-changed) (((class color) (min-colors 88) (background light)) :background "#aaffaa") (((class color) (min-colors 88) (background dark)) :background "#22aa22")) "Face used for added characters shown by `diff-refine-hunk'." :version "24.3") (defun diff-refine-preproc () (while (re-search-forward "^[+>]" nil t) ;; Remove spurious changes due to the fact that one side of the hunk is ;; marked with leading + or > and the other with leading - or <. ;; We used to replace all the prefix chars with " " but this only worked ;; when we did char-based refinement (or when using ;; smerge-refine-weight-hack) since otherwise, the `forward' motion done ;; in chopup do not necessarily do the same as the ones in highlight ;; since the "_" is not treated the same as " ". (replace-match (cdr (assq (char-before) '((?+ . "-") (?> . "<")))))) ) (defun diff--forward-while-leading-char (char bound) "Move point until reaching a line not starting with CHAR. Return new point, if it was moved." (let ((pt nil)) (while (and (< (point) bound) (eql (following-char) char)) (forward-line 1) (setq pt (point))) pt)) (defun diff-refine-hunk () "Highlight changes of hunk at point at a finer granularity." (interactive) (when (diff--some-hunks-p) (save-excursion (let ((beg (diff-beginning-of-hunk t)) ;; Be careful to start from the hunk header so diff-end-of-hunk ;; gets to read the hunk header's line info. (end (progn (diff-end-of-hunk) (point)))) (diff--refine-hunk beg end))))) (defun diff--refine-hunk (start end) (require 'smerge-mode) (goto-char start) (let* ((style (diff-hunk-style)) ;Skips the hunk header as well. (beg (point)) (props-c '((diff-mode . fine) (face . diff-refine-changed))) (props-r '((diff-mode . fine) (face . diff-refine-removed))) (props-a '((diff-mode . fine) (face . diff-refine-added)))) (remove-overlays beg end 'diff-mode 'fine) (goto-char beg) (pcase style ('unified (while (re-search-forward "^-" end t) (let ((beg-del (progn (beginning-of-line) (point))) beg-add end-add) (when (and (diff--forward-while-leading-char ?- end) ;; Allow for "\ No newline at end of file". (progn (diff--forward-while-leading-char ?\\ end) (setq beg-add (point))) (diff--forward-while-leading-char ?+ end) (progn (diff--forward-while-leading-char ?\\ end) (setq end-add (point)))) (smerge-refine-regions beg-del beg-add beg-add end-add nil #'diff-refine-preproc props-r props-a))))) ('context (let* ((middle (save-excursion (re-search-forward "^---"))) (other middle)) (while (re-search-forward "^\\(?:!.*\n\\)+" middle t) (smerge-refine-regions (match-beginning 0) (match-end 0) (save-excursion (goto-char other) (re-search-forward "^\\(?:!.*\n\\)+" end) (setq other (match-end 0)) (match-beginning 0)) other (if diff-use-changed-face props-c) #'diff-refine-preproc (unless diff-use-changed-face props-r) (unless diff-use-changed-face props-a))))) (_ ;; Normal diffs. (let ((beg1 (1+ (point)))) (when (re-search-forward "^---.*\n" end t) ;; It's a combined add&remove, so there's something to do. (smerge-refine-regions beg1 (match-beginning 0) (match-end 0) end nil #'diff-refine-preproc props-r props-a))))))) (defun diff--font-lock-refined (max) "Apply hunk refinement from font-lock." (when diff-font-lock-refine (when (get-char-property (point) 'diff--font-lock-refined) ;; Refinement works over a complete hunk, whereas font-lock limits itself ;; to highlighting smallish chunks between point..max, so we may be ;; called N times for a large hunk in which case we don't want to ;; rehighlight that hunk N times (especially since each highlighting ;; of a large hunk can itself take a long time, adding insult to injury). ;; So, after refining a hunk (including a failed attempt), we place an ;; overlay over the whole hunk to mark it as refined, to avoid redoing ;; the job redundantly when asked to highlight subsequent parts of the ;; same hunk. (goto-char (next-single-char-property-change (point) 'diff--font-lock-refined nil max))) (let* ((min (point)) (beg (or (ignore-errors (diff-beginning-of-hunk)) (ignore-errors (diff-hunk-next) (point)) max))) (while (< beg max) (let ((end (save-excursion (goto-char beg) (diff-end-of-hunk) (point)))) (if (< end min) (setq beg min)) (unless (or (< end beg) (get-char-property beg 'diff--font-lock-refined)) (diff--refine-hunk beg end) (let ((ol (make-overlay beg end))) (overlay-put ol 'diff--font-lock-refined t) (overlay-put ol 'diff-mode 'fine) (overlay-put ol 'evaporate t) (overlay-put ol 'modification-hooks '(diff--font-lock-refine--refresh)))) (goto-char (max beg end)) (setq beg (or (ignore-errors (diff-hunk-next) (point)) max))))))) (defun diff--font-lock-refine--refresh (ol _after _beg _end &optional _len) (delete-overlay ol)) (defun diff-undo (&optional arg) "Perform `undo', ignoring the buffer's read-only status." (interactive "P") (let ((inhibit-read-only t)) (undo arg))) (defun diff-add-change-log-entries-other-window () "Iterate through the current diff and create ChangeLog entries. I.e. like `add-change-log-entry-other-window' but applied to all hunks." (interactive) ;; XXX: Currently add-change-log-entry-other-window is only called ;; once per hunk. Some hunks have multiple changes, it would be ;; good to call it for each change. (save-excursion (goto-char (point-min)) (condition-case nil ;; Call add-change-log-entry-other-window for each hunk in ;; the diff buffer. (while (progn (diff-hunk-next) ;; Move to where the changes are, ;; `add-change-log-entry-other-window' works better in ;; that case. (re-search-forward (concat "\n[!+-<>]" ;; If the hunk is a context hunk with an empty first ;; half, recognize the "--- NNN,MMM ----" line "\\(-- [0-9]+\\(,[0-9]+\\)? ----\n" ;; and skip to the next non-context line. "\\( .*\n\\)*[+]\\)?") nil t)) (save-excursion ;; FIXME: this pops up windows of all the buffers. (add-change-log-entry nil nil t nil t))) ;; When there's no more hunks, diff-hunk-next signals an error. (error nil)))) (defun diff-delete-trailing-whitespace (&optional other-file) "Remove trailing whitespace from lines modified in this diff. This edits both the current Diff mode buffer and the patched source file(s). If `diff-jump-to-old-file' is non-nil, edit the original (unpatched) source file instead. With a prefix argument OTHER-FILE, flip the choice of which source file to edit. If a file referenced in the diff has no buffer and needs to be fixed, visit it in a buffer." (interactive "P") (save-excursion (goto-char (point-min)) (let* ((other (diff-xor other-file diff-jump-to-old-file)) (modified-buffers nil) (style (save-excursion (when (re-search-forward diff-hunk-header-re nil t) (goto-char (match-beginning 0)) (diff-hunk-style)))) (regexp (concat "^[" (if other "-<" "+>") "!]" (if (eq style 'context) " " "") ".*?\\([ \t]+\\)$")) (inhibit-read-only t) (end-marker (make-marker)) hunk-end) ;; Move to the first hunk. (re-search-forward diff-hunk-header-re nil 1) (while (progn (save-excursion (re-search-forward diff-hunk-header-re nil 1) (setq hunk-end (point))) (< (point) hunk-end)) ;; For context diffs, search only in the appropriate half of ;; the hunk. For other diffs, search within the entire hunk. (if (not (eq style 'context)) (set-marker end-marker hunk-end) (let ((mid-hunk (save-excursion (re-search-forward diff-context-mid-hunk-header-re hunk-end) (point)))) (if other (set-marker end-marker mid-hunk) (goto-char mid-hunk) (set-marker end-marker hunk-end)))) (while (re-search-forward regexp end-marker t) (let ((match-data (match-data))) (pcase-let ((`(,buf ,line-offset ,pos ,src ,_dst ,_switched) (diff-find-source-location other-file))) (when line-offset ;; Remove the whitespace in the Diff mode buffer. (set-match-data match-data) (replace-match "" t t nil 1) ;; Remove the whitespace in the source buffer. (with-current-buffer buf (save-excursion (goto-char (+ (car pos) (cdr src))) (beginning-of-line) (when (re-search-forward "\\([ \t]+\\)$" (line-end-position) t) (unless (memq buf modified-buffers) (push buf modified-buffers)) (replace-match "")))))))) (goto-char hunk-end)) (if modified-buffers (message "Deleted trailing whitespace from %s." (mapconcat (lambda (buf) (format-message "`%s'" (buffer-name buf))) modified-buffers ", ")) (message "No trailing whitespace to delete."))))) ;;; Prettifying from font-lock (define-fringe-bitmap 'diff-fringe-add [#b00000000 #b00000000 #b00010000 #b00010000 #b01111100 #b00010000 #b00010000 #b00000000 #b00000000] nil nil 'center) (define-fringe-bitmap 'diff-fringe-del [#b00000000 #b00000000 #b00000000 #b00000000 #b01111100 #b00000000 #b00000000 #b00000000 #b00000000] nil nil 'center) (define-fringe-bitmap 'diff-fringe-rep [#b00000000 #b00010000 #b00010000 #b00010000 #b00010000 #b00010000 #b00000000 #b00010000 #b00000000] nil nil 'center) (define-fringe-bitmap 'diff-fringe-nul ;; Maybe there should be such an "empty" bitmap defined by default? [#b00000000 #b00000000 #b00000000 #b00000000 #b00000000 #b00000000 #b00000000 #b00000000 #b00000000] nil nil 'center) (defun diff--font-lock-prettify (limit) (when diff-font-lock-prettify (save-excursion ;; FIXME: Include the first space for context-style hunks! (while (re-search-forward "^[-+! ]" limit t) (let ((spec (alist-get (char-before) '((?+ . (left-fringe diff-fringe-add diff-indicator-added)) (?- . (left-fringe diff-fringe-del diff-indicator-removed)) (?! . (left-fringe diff-fringe-rep diff-indicator-changed)) (?\s . (left-fringe diff-fringe-nul)))))) (put-text-property (match-beginning 0) (match-end 0) 'display spec)))) ;; Mimicks the output of Magit's diff. ;; FIXME: This has only been tested with Git's diff output. (while (re-search-forward "^diff " limit t) ;; FIXME: Switching between context<->unified leads to messed up ;; file headers by cutting the `display' property in chunks! (when (save-excursion (forward-line 0) (looking-at (eval-when-compile (concat "diff.*\n" "\\(?:\\(?:new file\\|deleted\\).*\n\\)?" "\\(?:index.*\n\\)?" "--- \\(?:/dev/null\\|a/\\(.*\\)\\)\n" "\\+\\+\\+ \\(?:/dev/null\\|b/\\(.*\\)\\)\n")))) (put-text-property (match-beginning 0) (or (match-beginning 2) (match-beginning 1)) 'display (propertize (cond ((null (match-beginning 1)) "new file ") ((null (match-beginning 2)) "deleted ") (t "modified ")) 'face '(diff-file-header diff-header))) (unless (match-beginning 2) (put-text-property (match-end 1) (1- (match-end 0)) 'display ""))))) nil) ;;; Syntax highlighting from font-lock (defun diff--font-lock-syntax (max) "Apply source language syntax highlighting from font-lock. Calls `diff-syntax-fontify' on every hunk found between point and the position in MAX." (when diff-font-lock-syntax (when (get-char-property (point) 'diff--font-lock-syntax) (goto-char (next-single-char-property-change (point) 'diff--font-lock-syntax nil max))) (let* ((min (point)) (beg (or (ignore-errors (diff-beginning-of-hunk)) (ignore-errors (diff-hunk-next) (point)) max))) (while (< beg max) (let ((end (save-excursion (goto-char beg) (diff-end-of-hunk) (point)))) (if (< end min) (setq beg min)) (unless (or (< end beg) (get-char-property beg 'diff--font-lock-syntax)) (diff-syntax-fontify beg end) (let ((ol (make-overlay beg end))) (overlay-put ol 'diff--font-lock-syntax t) (overlay-put ol 'diff-mode 'syntax) (overlay-put ol 'evaporate t) (overlay-put ol 'modification-hooks '(diff--font-lock-syntax--refresh)))) (goto-char (max beg end)) (setq beg (or (ignore-errors (diff-hunk-next) (point)) max)))))) nil) (defun diff--font-lock-syntax--refresh (ol _after _beg _end &optional _len) (delete-overlay ol)) (defun diff-syntax-fontify (beg end) "Highlight source language syntax in diff hunk between BEG and END." (save-excursion (diff-syntax-fontify-hunk beg end t) (diff-syntax-fontify-hunk beg end nil))) (defvar diff-syntax-fontify-revisions (make-hash-table :test 'equal)) (eval-when-compile (require 'subr-x)) ; for string-trim-right (defun diff-syntax-fontify-hunk (beg end old) "Highlight source language syntax in diff hunk between BEG and END. When OLD is non-nil, highlight the hunk from the old source." (remove-overlays beg end 'diff-mode 'syntax) (goto-char beg) (let* ((hunk (buffer-substring-no-properties beg end)) (text (string-trim-right (or (ignore-errors (diff-hunk-text hunk (not old) nil)) ""))) (line (if (looking-at "\\(?:\\*\\{15\\}.*\n\\)?[-@* ]*\\([0-9,]+\\)\\([ acd+]+\\([0-9,]+\\)\\)?") (if old (match-string 1) (if (match-end 3) (match-string 3) (match-string 1))))) (line-nb (when line (if (string-match "\\([0-9]+\\),\\([0-9]+\\)" line) (list (string-to-number (match-string 1 line)) (string-to-number (match-string 2 line))) (list (string-to-number line) 1)))) ; One-line diffs props) (cond ((and diff-vc-backend (not (eq diff-font-lock-syntax 'hunk-only))) (let* ((file (diff-find-file-name old t)) (revision (and file (if (not old) (nth 1 diff-vc-revisions) (or (nth 0 diff-vc-revisions) (vc-working-revision file)))))) (if file (if (not revision) ;; Get properties from the current working revision (when (and (not old) (file-exists-p file) (file-regular-p file)) ;; Try to reuse an existing buffer (if (get-file-buffer (expand-file-name file)) (with-current-buffer (get-file-buffer (expand-file-name file)) (setq props (diff-syntax-fontify-props nil text line-nb t))) ;; Get properties from the file (with-temp-buffer (insert-file-contents file t) (setq props (diff-syntax-fontify-props file text line-nb))))) ;; Get properties from a cached revision (let* ((buffer-name (format " *diff-syntax:%s.~%s~*" (expand-file-name file) revision)) (buffer (gethash buffer-name diff-syntax-fontify-revisions))) (unless (and buffer (buffer-live-p buffer)) (let* ((vc-buffer (ignore-errors (vc-find-revision-no-save (expand-file-name file) revision diff-vc-backend (get-buffer-create buffer-name))))) (when vc-buffer (setq buffer vc-buffer) (puthash buffer-name buffer diff-syntax-fontify-revisions)))) (when buffer (with-current-buffer buffer (setq props (diff-syntax-fontify-props file text line-nb t)))))) ;; If file is unavailable, get properties from the hunk alone (setq file (car (diff-hunk-file-names old))) (with-temp-buffer (insert text) (setq props (diff-syntax-fontify-props file text line-nb nil t)))))) ((and diff-default-directory (not (eq diff-font-lock-syntax 'hunk-only))) (let ((file (car (diff-hunk-file-names old)))) (if (and file (file-exists-p file) (file-regular-p file)) ;; Try to get full text from the file (with-temp-buffer (insert-file-contents file t) (setq props (diff-syntax-fontify-props file text line-nb))) ;; Otherwise, get properties from the hunk alone (with-temp-buffer (insert text) (setq props (diff-syntax-fontify-props file text line-nb nil t)))))) ((memq diff-font-lock-syntax '(hunk-also hunk-only)) (let ((file (car (diff-hunk-file-names old)))) (with-temp-buffer (insert text) (setq props (diff-syntax-fontify-props file text line-nb nil t)))))) ;; Put properties over the hunk text (goto-char beg) (when (and props (eq (diff-hunk-style) 'unified)) (while (< (progn (forward-line 1) (point)) end) (when (or (and (not old) (not (looking-at-p "[-<]"))) (and old (not (looking-at-p "[+>]")))) (unless (looking-at-p "\\\\") ; skip "\ No newline at end of file" (if (and old (not (looking-at-p "[-<]"))) ;; Fontify context lines only from new source, ;; don't refontify context lines from old source. (pop props) (let ((line-props (pop props)) (bol (1+ (point)))) (dolist (prop line-props) (let ((ol (make-overlay (+ bol (nth 0 prop)) (+ bol (nth 1 prop)) nil 'front-advance nil))) (overlay-put ol 'evaporate t) (overlay-put ol 'face (nth 2 prop)))))))))))) (defun diff-syntax-fontify-props (file text line-nb &optional no-init hunk-only) "Get font-lock properties from the source code. FILE is the name of the source file. TEXT is the literal source text from hunk. LINE-NB is a pair of numbers: start line number and the number of lines in the hunk. NO-INIT means no initialization is needed to set major mode. When HUNK-ONLY is non-nil, then don't verify the existence of the hunk text in the source file. Otherwise, don't highlight the hunk if the hunk text is not found in the source file." (unless no-init (buffer-disable-undo) (font-lock-mode -1) (let ((enable-local-variables :safe) ;; to find `mode:' (buffer-file-name file)) (set-auto-mode) (when (and (memq 'generic-mode-find-file-hook find-file-hook) (fboundp 'generic-mode-find-file-hook)) (generic-mode-find-file-hook)))) (let ((font-lock-defaults (or font-lock-defaults '(nil t))) (inhibit-read-only t) props beg end) (goto-char (point-min)) (if hunk-only (setq beg (point-min) end (point-max)) (forward-line (1- (nth 0 line-nb))) ;; non-regexp looking-at to compare hunk text for verification (if (search-forward text (+ (point) (length text)) t) (setq beg (- (point) (length text)) end (point)) (goto-char (point-min)) (if (search-forward text nil t) (setq beg (- (point) (length text)) end (point))))) (when (and beg end) (goto-char beg) (font-lock-ensure beg end) (while (< (point) end) (let* ((bol (point)) (eol (line-end-position)) line-props (searching t) (from (point)) to (val (get-text-property from 'face))) (while searching (setq to (next-single-property-change from 'face nil eol)) (when val (push (list (- from bol) (- to bol) val) line-props)) (setq val (get-text-property to 'face) from to) (unless (< to eol) (setq searching nil))) (when val (push (list from eol val) line-props)) (push (nreverse line-props) props)) (forward-line 1))) (set-buffer-modified-p nil) (nreverse props))) (defun diff--filter-substring (str) (when diff-font-lock-prettify ;; Strip the `display' properties added by diff-font-lock-prettify, ;; since they look weird when you kill&yank! (remove-text-properties 0 (length str) '(display nil) str) ;; We could also try to only remove those `display' properties actually ;; added by diff-font-lock-prettify rather than removing them all blindly. ;; E.g.: ;;(let ((len (length str)) ;; (i 0)) ;; (while (and (< i len) ;; (setq i (text-property-not-all i len 'display nil str))) ;; (let* ((val (get-text-property i 'display str)) ;; (end (or (text-property-not-all i len 'display val str) len))) ;; ;; FIXME: Check for display props that prettify the file header! ;; (when (eq 'left-fringe (car-safe val)) ;; ;; FIXME: Should we check that it's a diff-fringe-* bitmap? ;; (remove-text-properties i end '(display nil) str)) ;; (setq i end)))) ) str) ;;; Support for converting a diff to diff3 markers via `wiggle'. ;; Wiggle can be found at http://neil.brown.name/wiggle/ or in your nearest ;; Debian repository. (defun diff-wiggle () "Use `wiggle' to apply the whole current file diff by hook or by crook. When a hunk can't cleanly be applied, it gets turned into a diff3-style conflict." (interactive) (let* ((bounds (diff-bounds-of-file)) (file (diff-find-file-name)) (tmpbuf (current-buffer)) (filebuf (find-buffer-visiting file)) (patchfile (make-temp-file (expand-file-name "wiggle" (file-name-directory file)) nil ".diff")) (errfile (make-temp-file (expand-file-name "wiggle" (file-name-directory file)) nil ".error"))) (unwind-protect (with-temp-buffer (set-buffer (prog1 tmpbuf (setq tmpbuf (current-buffer)))) (when (buffer-modified-p filebuf) (save-some-buffers nil (lambda () (eq (current-buffer) filebuf))) (if (buffer-modified-p filebuf) (user-error "Abort!"))) (write-region (car bounds) (cadr bounds) patchfile nil 'silent) (let ((exitcode (call-process "wiggle" nil (list tmpbuf errfile) nil file patchfile))) (if (not (memq exitcode '(0 1))) (message "diff-wiggle error: %s" (with-current-buffer tmpbuf (goto-char (point-min)) (insert-file-contents errfile) (buffer-string))) (with-current-buffer tmpbuf (write-region nil nil file nil 'silent) (with-current-buffer filebuf (revert-buffer t t t) (save-excursion (goto-char (point-min)) (if (re-search-forward "^<<<<<<<" nil t) (smerge-mode 1))) (pop-to-buffer filebuf)))))) (delete-file patchfile) (delete-file errfile)))) ;; provide the package (provide 'diff-mode) ;;; Old Change Log from when diff-mode wasn't part of Emacs: ;; Revision 1.11 1999/10/09 23:38:29 monnier ;; (diff-mode-load-hook): dropped. ;; (auto-mode-alist): also catch *.diffs. ;; (diff-find-file-name, diff-mode): add smarts to find the right file ;; for *.rej files (that lack any file name indication). ;; ;; Revision 1.10 1999/09/30 15:32:11 monnier ;; added support for "\ No newline at end of file". ;; ;; Revision 1.9 1999/09/15 00:01:13 monnier ;; - added basic `compile' support. ;; - have diff-kill-hunk call diff-kill-file if it's the only hunk. ;; - diff-kill-file now tries to kill the leading garbage as well. ;; ;; Revision 1.8 1999/09/13 21:10:09 monnier ;; - don't use CL in the autoloaded code ;; - accept diffs using -T ;; ;; Revision 1.7 1999/09/05 20:53:03 monnier ;; interface to ediff-patch ;; ;; Revision 1.6 1999/09/01 20:55:13 monnier ;; (ediff=patch-file): add bindings to call ediff-patch. ;; (diff-find-file-name): taken out of diff-goto-source. ;; (diff-unified->context, diff-context->unified, diff-reverse-direction, ;; diff-fixup-modifs): only use the region if a prefix arg is given. ;; ;; Revision 1.5 1999/08/31 19:18:52 monnier ;; (diff-beginning-of-file, diff-prev-file): fixed wrong parenthesis. ;; ;; Revision 1.4 1999/08/31 13:01:44 monnier ;; use `combine-after-change-calls' to minimize the slowdown of font-lock. ;; ;;; diff-mode.el ends here