Emacs: Normalize some comment tags

master
Pierre Neidhardt 2017-06-18 19:52:00 +01:00
parent 2573c77cc5
commit 6779cb9b25
6 changed files with 11 additions and 12 deletions

View File

@ -1,5 +1,5 @@
;;; Dired ;;; 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. ;;; We cannot assume that current buffer is in dired-mode.
(define-keys dired-mode-map (define-keys dired-mode-map

View File

@ -76,10 +76,9 @@
;;; `nobreak-char-display' makes some output look weird, e.g. with 'tree'. ;;; `nobreak-char-display' makes some output look weird, e.g. with 'tree'.
(add-hook 'eshell-mode-hook 'turn-off-nobreak-char-display) (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. ;;; This implementation is more reliable.
;;; DONE: Reported upstream: ;;; Reported at https://debbugs.gnu.org/cgi/bugreport.cgi?bug=27405.
;;; https://debbugs.gnu.org/cgi/bugreport.cgi?bug=27405
(with-eval-after-load 'em-prompt (with-eval-after-load 'em-prompt
(defun eshell-next-prompt (n) (defun eshell-next-prompt (n)
"Move to end of Nth next prompt in the buffer. "Move to end of Nth next prompt in the buffer.

View File

@ -14,8 +14,8 @@
;; - linum-relative: integrates well but not with fringe string, must be a function. ;; - linum-relative: integrates well but not with fringe string, must be a function.
;; - relative-line-number: linum must be disabled before running this. ;; - relative-line-number: linum must be disabled before running this.
(when (require 'linum-relative nil t) (when (require 'linum-relative nil t)
;; TODO: Current symbol is displayed on all lines when we run `occur', `set-variables', ;; 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 ;; `helm-occur', etc: https://github.com/coldnew/linum-relative/issues/40.
(setq linum-relative-current-symbol "") (setq linum-relative-current-symbol "")
(linum-relative-toggle)) (linum-relative-toggle))

View File

@ -1,5 +1,5 @@
;;; LaTeX ;;; LaTeX
;;; Warning: This file is loaded from a hook. ;;; WARNING: This file is loaded from a hook.
;;; We use the TeX setup. ;;; We use the TeX setup.
(require 'mode-tex) (require 'mode-tex)

View File

@ -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, ;;; REVIEW: Fix forward-page. Previously, when the point was at the end of the
;;; going forward would skip 1 page. Changed: ;;; page, going forward would skip 1 page. Changed:
;; ;;
;; (if (bolp) (forward-char 1)) ;; (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 ;;; I do not know why the (bolp) condition was used since it does not match the
;;; above comment. ;;; 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) (defun forward-page (&optional count)
"Move forward to page boundary. "Move forward to page boundary.
With prefix or COUNT, repeat, or go back if negative. With prefix or COUNT, repeat, or go back if negative.

View File

@ -100,10 +100,10 @@
(setq (setq
whitespace-style whitespace-style
'(face empty indentation space-after-tab space-before-tab tab-mark trailing)) '(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. ;;; beginning and end of buffer as long as there is at least one empty line.
;;; `whitespace-cleanup' works properly however. ;;; `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)) ;; (setq whitespace-action '(report-on-bogus))
;;; WARNING: this can break some configuration files needing whitespaces at the ;;; WARNING: this can break some configuration files needing whitespaces at the