]> code.delx.au - gnu-emacs-elpa/blobdiff - README.md
Update docs to reflect new diff-hl-flydiff-mode
[gnu-emacs-elpa] / README.md
index ea3afb76a1bc4dc698d08da499b2da43e70fe674..4a71d5e0db6d696b14d0a5ce286ed66c4c2cc2ac 100644 (file)
--- a/README.md
+++ b/README.md
@@ -15,6 +15,7 @@ The package also contains auxiliary modes:
 * `diff-hl-margin-mode` changes the highlighting function to\r
   use the margin instead of the fringe.\r
 * `diff-hl-amend-mode` shifts the reference revision back by one.\r
+* `diff-hl-flydiff-mode` enables diffing unsaved changes\r
 \r
 Check out the Commentary section in each respective file for the usage\r
 instructions.\r
@@ -24,11 +25,10 @@ Screenshots
 \r
 diff-hl-mode\r
 -----\r
+Top window: a buffer in this minor mode, bottom window: the corresponding diff.\r
 \r
 ![screenie](screenshot.png)\r
 \r
-Top window: a buffer in this minor mode, bottom window: the corresponding diff.\r
-\r
 diff-hl-dired-mode\r
 -----\r
 \r
@@ -47,25 +47,21 @@ Emacs 24+. On OS X, Emacs 24.3 or higher is recommended.
 Notes\r
 =====\r
 \r
-* Since it uses the corresponding VC diff command, it's only accurate when the\r
-  buffer is in saved state. Highlighting changes "on the fly" might be better,\r
-  maybe we can do something similar to `highlight-markup-buffers` with a hidden\r
-  buffer containing the unmodified copy.\r
-\r
 * We conflict with other modes when they put indicators on the fringe,\r
   such as [Flycheck](https://github.com/flycheck/flycheck). This is\r
   rarely a significant problem, since if you're using such a mode,\r
   you'd usually want to fix all errors and warnings before continuing,\r
   and then the conflicting indicators go away.\r
 \r
-* There's no fringe when Emacs is running in the console, but the navigation and\r
-  revert commands still work. Consider turning `diff-hl-margin-mode` on.\r
+* There's no fringe when Emacs is running in the console, but the navigation\r
+  and revert commands still work. Consider turning `diff-hl-margin-mode` on,\r
+  to show the indicators in the margin instead.\r
 \r
 * Frame-local and buffer-local values of `line-spacing` are not supported.\r
 \r
-* [git-gutter](https://github.com/syohex/emacs-git-gutter) provides interactive\r
-  commands to show/hide/toggle margin indicators for the same information, and\r
-  allows you to customize how the indicators look.\r
+* [emacs-git-gutter](https://github.com/syohex/emacs-git-gutter) shows\r
+  indicators in the margin by default, allows you to customize how the\r
+  indicators look more easily, and has a "stage hunk" command.\r
 \r
 Integration\r
 =====\r
@@ -82,3 +78,9 @@ psvn
 (defadvice svn-status-update-modeline (after svn-update-diff-hl activate)\r
   (diff-hl-update))\r
 ```\r
+\r
+Magit\r
+-----\r
+\r
+If you have a recent enough version installed, it defines\r
+`magit-revert-buffer-hook` (or `magit-not-reverted-hook`), which we use.\r