mirror of
https://gitlab.com/dwt1/dotfiles.git
synced 2026-04-24 20:10:23 +10:00
Updating dotfiles.
This commit is contained in:
@@ -1,13 +1,83 @@
|
||||
#+TITLE: :ui hl-todo
|
||||
#+DATE: February 19, 2017
|
||||
#+SINCE: v1.3
|
||||
#+STARTUP: inlineimages
|
||||
|
||||
This module adds syntax highlighting for TODO/FIXME/NOTE tags in programming major-modes.
|
||||
* Table of Contents :TOC_3:noexport:
|
||||
- [[#description][Description]]
|
||||
- [[#module-flags][Module Flags]]
|
||||
- [[#plugins][Plugins]]
|
||||
- [[#prerequisites][Prerequisites]]
|
||||
- [[#features][Features]]
|
||||
- [[#making-items][Making Items]]
|
||||
- [[#keybindings][Keybindings]]
|
||||
- [[#adding-items][Adding items.]]
|
||||
- [[#configuration][Configuration]]
|
||||
- [[#troubleshooting][Troubleshooting]]
|
||||
|
||||
What keywords are highlighted (and their color) can be customized through ~hl-todo-keyword-faces~.
|
||||
* Description
|
||||
This module adds syntax highlighting for TODO/FIXME/NOTE tags in programming
|
||||
major-modes.
|
||||
|
||||
** Module Flags
|
||||
This module provides no flags
|
||||
|
||||
** Plugins
|
||||
+ [[https://github.com/tarius/hl-todo][hl-todo]]
|
||||
|
||||
* Prerequisites
|
||||
This module has no prerequisites
|
||||
|
||||
* Features
|
||||
|
||||
** Making Items
|
||||
You can make a TODO item by simply writing
|
||||
+ =TODO=
|
||||
For things that need to be done, just not today.
|
||||
+ =HACK=
|
||||
For tidbits that are unconventional and not intended uses of the
|
||||
constituent parts, and may break in a future update.
|
||||
+ =FIXME=
|
||||
For problems that will become bigger problems later if not fixed ASAP.
|
||||
+ =REVIEW=
|
||||
for things that were done hastily and/or hasn't been thoroughly
|
||||
tested. it may not even be necessary!
|
||||
+ =NOTE=
|
||||
For especially important gotchas with a given implementation,
|
||||
directed at another user other than the author.
|
||||
+ =DEPRECATED=
|
||||
For things that just gotta go and will soon be gone.
|
||||
+ =BUG=
|
||||
For a known bug that needs a workaround
|
||||
+ =XXX=
|
||||
For warning about a problematic or misguiding code
|
||||
|
||||
** Keybindings
|
||||
| keybind | description |
|
||||
|-----------+----------------------------------|
|
||||
| =]t= | go to next TODO item |
|
||||
| =[t= | go to previous TODO item |
|
||||
| =SPC p t= | show all TODO items in a project |
|
||||
| =SPC s p= | search project for a string |
|
||||
| =SPC s b= | search buffer for string |
|
||||
|
||||
** TODO Adding items.
|
||||
The way you would add a TODO item is to use a snippet but these have not been
|
||||
made. you can make them yourself by adding the snippet to
|
||||
=$DOOMDIR/snippets/MAJOR-MODE/name-of-snippet=. you will find more info on how
|
||||
to make them [[https://github.com/hlissner/doom-snippets][here]]
|
||||
|
||||
* Configuration
|
||||
To add your own ITEMS you would need to configure them using
|
||||
~hl-todo-keyword-faces~
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
;; the default
|
||||
(setq hl-todo-keyword-faces
|
||||
`(("TODO" . ,(face-foreground 'warning))
|
||||
("FIXME" . ,(face-foreground 'error))
|
||||
("NOTE" . ,(face-foreground 'success))))
|
||||
(after! hl-todo
|
||||
(setq hl-todo-keyword-faces
|
||||
`(
|
||||
("FOO" . ,(face-foreground "MY COLOUR HEX CODE"))
|
||||
("BAR" . ,(face-foreground 'my-colour-var)))))
|
||||
#+END_SRC
|
||||
|
||||
* TODO Troubleshooting
|
||||
If you have any problems with this module do get in touch!
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
;; -*- no-byte-compile: t; -*-
|
||||
;;; ui/hl-todo/packages.el
|
||||
|
||||
(package! hl-todo :pin "3bba4591c54951d2abab113ec5e58a6319808ca9")
|
||||
(package! hl-todo :pin "0598b98f63b623c1778cbd2e2f60b774b7a311b9")
|
||||
|
||||
Reference in New Issue
Block a user