[elpa] externals/diff-hl 9cadf39: Fix a warning, update some docstrings

[ELPA Syncer]

branch: externals/diff-hl
commit 9cadf39f3dba3779d58f73a0d970d26c7a8aa57d
Author: Dmitry Gutov <dgutov@yandex.ru>
Commit: Dmitry Gutov <dgutov@yandex.ru>

    Fix a warning, update some docstrings
    
    Closes #158
---
 diff-hl-flydiff.el |  3 ---
 diff-hl.el         | 17 +++++++++--------
 2 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/diff-hl-flydiff.el b/diff-hl-flydiff.el
index f82e426..893254d 100644
--- a/diff-hl-flydiff.el
+++ b/diff-hl-flydiff.el
@@ -41,9 +41,6 @@
 (make-variable-buffer-local 'diff-hl-flydiff-modified-tick)
 
 (defun diff-hl-flydiff-buffer-with-head (file &optional backend)
-  "View the differences between FILE and its associated file in HEAD revision.
-This requires the external program `diff' to be in your
-`exec-path'."
   (diff-hl-diff-buffer-with-head file " *diff-hl-diff*" backend))
 
 (defun diff-hl-flydiff-update ()
diff --git a/diff-hl.el b/diff-hl.el
index cf5c5dc..d643482 100644
--- a/diff-hl.el
+++ b/diff-hl.el
@@ -730,12 +730,13 @@ The value of this variable is a mode line template as in
       (add-hook 'vc-checkin-hook 'diff-hl-dir-update t t)
     (remove-hook 'vc-checkin-hook 'diff-hl-dir-update t)))
 
-(defun diff-hl-make-temp-file-name (buffer rev &optional manual)
-  "Return a backup file name for REV or the current version of BUFFER.
+(defun diff-hl-make-temp-file-name (file rev &optional manual)
+  "Return a backup file name for REV or the current version of FILE.
 If MANUAL is non-nil it means that a name for backups created by
 the user should be returned."
   (let* ((auto-save-file-name-transforms
-          `((".*" ,temporary-file-directory t))))
+          `((".*" ,temporary-file-directory t)))
+         (buffer-file-name file))
     (expand-file-name
      (concat (make-auto-save-file-name)
              ".~" (subst-char-in-string
@@ -744,7 +745,7 @@ the user should be returned."
      temporary-file-directory)))
 
 (defun diff-hl-create-revision (file revision)
-  "Read REVISION of BUFFER into a buffer and return the buffer."
+  "Read REVISION of FILE into a buffer and return the buffer."
   (let ((automatic-backup (diff-hl-make-temp-file-name file revision))
         (filebuf (get-file-buffer file))
         (filename (diff-hl-make-temp-file-name file revision 'manual)))
@@ -774,11 +775,11 @@ the user should be returned."
 
 (declare-function diff-no-select "diff")
 
+;; TODO: Consider simplifying given FILE always = buffer-file-name.
 (defun diff-hl-diff-buffer-with-head (file &optional dest-buffer backend)
-  "Compute the differences between FILE and its associated file
-in head revision. The diffs are computed in the buffer
-DEST-BUFFER. This requires the external program `diff' to be in
-your `exec-path'."
+  "Compute the differences between FILE and its revision.
+ The diffs are computed in the buffer DEST-BUFFER. This requires
+the `diff-program' to be in your `exec-path'."
   (require 'diff)
   (vc-ensure-vc-buffer)
   (save-current-buffer