nit(hl-todo): revise keyword summaries in comments

This commit is contained in:
Henrik Lissner 2022-05-23 02:34:28 +02:00
parent e2e33b1b49
commit 398b91b623
No known key found for this signature in database
GPG key ID: B60957CA074D39A3

View file

@ -6,25 +6,23 @@
:config :config
(setq hl-todo-highlight-punctuation ":" (setq hl-todo-highlight-punctuation ":"
hl-todo-keyword-faces hl-todo-keyword-faces
`(;; For things that need to be done, just not today. '(;; For missing features or functionality that should be added at a
;; later date.
("TODO" warning bold) ("TODO" warning bold)
;; For problems that will become bigger problems later if not ;; For code (or code paths) that are broken or slow, and may become
;; fixed ASAP. ;; bigger problems later.
("FIXME" error bold) ("FIXME" error bold)
;; For tidbits that are unconventional and not intended uses of the ;; For code smells, where questionable coding practices are
;; constituent parts, and may break in a future update. ;; intentionally used, and/or may break in a future update.
("HACK" font-lock-constant-face bold) ("HACK" font-lock-constant-face bold)
;; For things that were done hastily and/or hasn't been thoroughly ;; For things that need confirmation that they work or more testing.
;; tested. It may not even be necessary!
("REVIEW" font-lock-keyword-face bold) ("REVIEW" font-lock-keyword-face bold)
;; For especially important gotchas with a given implementation,
;; directed at another user other than the author.
("NOTE" success bold)
;; For things that just gotta go and will soon be gone. ;; For things that just gotta go and will soon be gone.
("DEPRECATED" font-lock-doc-face bold) ("DEPRECATED" font-lock-doc-face bold)
;; For a known bug that needs a workaround ;; These are extra, commonly seen annotation keywords. What they mean
;; or are for depend on the project.
("NOTE" success bold)
("BUG" error bold) ("BUG" error bold)
;; For warning about a problematic or misguiding code
("XXX" font-lock-constant-face bold))) ("XXX" font-lock-constant-face bold)))