[Emacs-diffs] emacs-25 2d02a5f: ; * lisp/vc/vc-annotate.el (vc-annotate): Clarify commentary.

[Eli Zaretskii]

branch: emacs-25
commit 2d02a5f729c804e841fee5df5b2ae2a06b705bd3
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    ; * lisp/vc/vc-annotate.el (vc-annotate): Clarify commentary.
---
 lisp/vc/vc-annotate.el |    9 +++++----
 1 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/lisp/vc/vc-annotate.el b/lisp/vc/vc-annotate.el
index 379ac95..774453f 100644
--- a/lisp/vc/vc-annotate.el
+++ b/lisp/vc/vc-annotate.el
@@ -432,10 +432,11 @@ should be applied to the background or to the foreground."
     (with-output-to-temp-buffer temp-buffer-name
       (let ((backend (or vc-bk (vc-backend file)))
            (coding-system-for-read buffer-file-coding-system))
-        ;; On DOS/Windows, "svn annotate" will produce CRLF EOLs even
-        ;; if the original file has Unix EOLs, which will show ^M
-        ;; characters in the Annotate buffer.  Prevent that by forcing
-        ;; DOS EOL decoding.
+        ;; For a VC backend running on DOS/Windows, it's normal to
+        ;; produce CRLF EOLs even if the original file has Unix EOLs,
+        ;; which will show ^M characters in the Annotate buffer.  (One
+        ;; known case in point is "svn annotate".)  Prevent that by
+        ;; forcing DOS EOL decoding.
         (if (memq system-type '(windows-nt ms-dos))
             (setq coding-system-for-read
                   (coding-system-change-eol-conversion coding-system-for-read