From 6779cb9b25dd7c0ba2b795a498722448a8d3ae85 Mon Sep 17 00:00:00 2001
From: Pierre Neidhardt <ambrevar@gmail.com>
Date: Sun, 18 Jun 2017 19:52:00 +0100
Subject: [PATCH] Emacs: Normalize some comment tags

---
 .emacs.d/lisp/init-dired.el  | 2 +-
 .emacs.d/lisp/init-eshell.el | 5 ++---
 .emacs.d/lisp/init-evil.el   | 4 ++--
 .emacs.d/lisp/init-latex.el  | 2 +-
 .emacs.d/lisp/init-page.el   | 6 +++---
 .emacs.d/lisp/main.el        | 4 ++--
 6 files changed, 11 insertions(+), 12 deletions(-)

diff --git a/.emacs.d/lisp/init-dired.el b/.emacs.d/lisp/init-dired.el
index 2a644292..ace73206 100644
--- a/.emacs.d/lisp/init-dired.el
+++ b/.emacs.d/lisp/init-dired.el
@@ -1,5 +1,5 @@
 ;;; Dired
-;;; Warning: This file is loaded unconditionally on startup.
+;;; WARNING: This file is loaded unconditionally on startup.
 ;;; We cannot assume that current buffer is in dired-mode.
 
 (define-keys dired-mode-map
diff --git a/.emacs.d/lisp/init-eshell.el b/.emacs.d/lisp/init-eshell.el
index 8aa6d068..aca59af9 100644
--- a/.emacs.d/lisp/init-eshell.el
+++ b/.emacs.d/lisp/init-eshell.el
@@ -76,10 +76,9 @@
 ;;; `nobreak-char-display' makes some output look weird, e.g. with 'tree'.
 (add-hook 'eshell-mode-hook 'turn-off-nobreak-char-display)
 
-;;; Emacs' standard functions fail when output has empty lines.
+;;; REVIEW: Emacs' standard functions fail when output has empty lines.
 ;;; This implementation is more reliable.
-;;; DONE: Reported upstream:
-;;; https://debbugs.gnu.org/cgi/bugreport.cgi?bug=27405
+;;; Reported at https://debbugs.gnu.org/cgi/bugreport.cgi?bug=27405.
 (with-eval-after-load 'em-prompt
   (defun eshell-next-prompt (n)
     "Move to end of Nth next prompt in the buffer.
diff --git a/.emacs.d/lisp/init-evil.el b/.emacs.d/lisp/init-evil.el
index ef1e6252..69f80f14 100644
--- a/.emacs.d/lisp/init-evil.el
+++ b/.emacs.d/lisp/init-evil.el
@@ -14,8 +14,8 @@
 ;; - linum-relative: integrates well but not with fringe string, must be a function.
 ;; - relative-line-number: linum must be disabled before running this.
 (when (require 'linum-relative nil t)
-  ;; TODO: Current symbol is displayed on all lines when we run `occur', `set-variables',
-  ;; `helm-occur', etc: https://github.com/coldnew/linum-relative/issues/40
+  ;; REVIEW: Current symbol is displayed on all lines when we run `occur', `set-variables',
+  ;; `helm-occur', etc: https://github.com/coldnew/linum-relative/issues/40.
   (setq linum-relative-current-symbol "")
   (linum-relative-toggle))
 
diff --git a/.emacs.d/lisp/init-latex.el b/.emacs.d/lisp/init-latex.el
index 171d0ac5..717692cf 100644
--- a/.emacs.d/lisp/init-latex.el
+++ b/.emacs.d/lisp/init-latex.el
@@ -1,5 +1,5 @@
 ;;; LaTeX
-;;; Warning: This file is loaded from a hook.
+;;; WARNING: This file is loaded from a hook.
 
 ;;; We use the TeX setup.
 (require 'mode-tex)
diff --git a/.emacs.d/lisp/init-page.el b/.emacs.d/lisp/init-page.el
index 9d6f6621..01f9555a 100644
--- a/.emacs.d/lisp/init-page.el
+++ b/.emacs.d/lisp/init-page.el
@@ -73,8 +73,8 @@ WARNING: this may slow down editing on big files."
 
 
 
-;;; Fix forward-page. Previously, when the point was at the end of the page,
-;;; going forward would skip 1 page.  Changed:
+;;; REVIEW: Fix forward-page. Previously, when the point was at the end of the
+;;; page, going forward would skip 1 page.  Changed:
 ;;
 ;;    (if (bolp) (forward-char 1))
 ;;
@@ -84,7 +84,7 @@ WARNING: this may slow down editing on big files."
 ;;
 ;;; I do not know why the (bolp) condition was used since it does not match the
 ;;; above comment.
-;;; TODO: Fix reported to http://debbugs.gnu.org/cgi/bugreport.cgi?bug=20663.
+;;; Reported at http://debbugs.gnu.org/cgi/bugreport.cgi?bug=20663.
 (defun forward-page (&optional count)
   "Move forward to page boundary.
 With prefix or COUNT, repeat, or go back if negative.
diff --git a/.emacs.d/lisp/main.el b/.emacs.d/lisp/main.el
index 7d9e7031..c8db7567 100644
--- a/.emacs.d/lisp/main.el
+++ b/.emacs.d/lisp/main.el
@@ -100,10 +100,10 @@
 (setq
  whitespace-style
  '(face empty indentation space-after-tab space-before-tab tab-mark trailing))
-;;; `whitespace-report' will mistakenly always report empty lines at
+;;; REVIEW: `whitespace-report' will mistakenly always report empty lines at
 ;;; beginning and end of buffer as long as there is at least one empty line.
 ;;; `whitespace-cleanup' works properly however.
-;;; DONE: Reported at http://debbugs.gnu.org/cgi/bugreport.cgi?bug=23740.
+;;; Reported at http://debbugs.gnu.org/cgi/bugreport.cgi?bug=23740.
 ;; (setq whitespace-action '(report-on-bogus))
 
 ;;; WARNING: this can break some configuration files needing whitespaces at the