adding the requested changes
This commit is contained in:
parent
51b47d0fa6
commit
89068d88d4
2 changed files with 47 additions and 45 deletions
|
@ -1,4 +1,7 @@
|
||||||
#+TITLE: :ui hl-todo
|
#+TITLE: :ui hl-todo
|
||||||
|
#+DATE: February 19, 2017
|
||||||
|
#+SINCE: v1.3
|
||||||
|
#+STARTUP: inlineimages
|
||||||
|
|
||||||
* Table of Contents :TOC_3:noexport:
|
* Table of Contents :TOC_3:noexport:
|
||||||
- [[#description][Description]]
|
- [[#description][Description]]
|
||||||
|
@ -7,7 +10,8 @@
|
||||||
- [[#prerequisites][Prerequisites]]
|
- [[#prerequisites][Prerequisites]]
|
||||||
- [[#features][Features]]
|
- [[#features][Features]]
|
||||||
- [[#making-items][Making Items]]
|
- [[#making-items][Making Items]]
|
||||||
- [[#using-items][Using Items]]
|
- [[#keybindings][Keybindings]]
|
||||||
|
- [[#adding-items][Adding items.]]
|
||||||
- [[#configuration][Configuration]]
|
- [[#configuration][Configuration]]
|
||||||
- [[#troubleshooting][Troubleshooting]]
|
- [[#troubleshooting][Troubleshooting]]
|
||||||
|
|
||||||
|
@ -17,11 +21,15 @@ major-modes.
|
||||||
|
|
||||||
** Module Flags
|
** Module Flags
|
||||||
This module provides no flags
|
This module provides no flags
|
||||||
|
|
||||||
** Plugins
|
** Plugins
|
||||||
[[https://github.com/tarius/hl-todo][hl-todo]]
|
+ [[https://github.com/tarius/hl-todo][hl-todo]]
|
||||||
|
|
||||||
* Prerequisites
|
* Prerequisites
|
||||||
This module has no prerequisites
|
This module has no prerequisites
|
||||||
|
|
||||||
* Features
|
* Features
|
||||||
|
|
||||||
** Making Items
|
** Making Items
|
||||||
You can make a TODO item by simply writing
|
You can make a TODO item by simply writing
|
||||||
+ =TODO=
|
+ =TODO=
|
||||||
|
@ -43,37 +51,33 @@ You can make a TODO item by simply writing
|
||||||
For a known bug that needs a workaround
|
For a known bug that needs a workaround
|
||||||
+ =XXX=
|
+ =XXX=
|
||||||
For warning about a problematic or misguiding code
|
For warning about a problematic or misguiding code
|
||||||
** Using Items
|
|
||||||
To see all of the TODO items in a project you can use
|
** Keybindings
|
||||||
=SPC p t=
|
| keybind | description |
|
||||||
This will bring up a buffer you can use to quickly jump to the item
|
|-----------+----------------------------------|
|
||||||
|
| =]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
|
* Configuration
|
||||||
To add your own ITEMS you would need to configure them using
|
To add your own ITEMS you would need to configure them using
|
||||||
~hl-todo-keyword-faces~
|
~hl-todo-keyword-faces~
|
||||||
#+BEGIN_SRC emacs-lisp :tangle no
|
#+BEGIN_SRC emacs-lisp
|
||||||
;; the default
|
;; the default
|
||||||
(setq hl-todo-keyword-faces
|
(after! hl-todo
|
||||||
`(("FOO" . ,(face-foreground "MY COLOUR HEX CODE"))
|
(setq hl-todo-keyword-faces
|
||||||
("BAR" . ,(face-foreground 'my-colour-var))))
|
`(
|
||||||
|
("FOO" . ,(face-foreground "MY COLOUR HEX CODE"))
|
||||||
|
("BAR" . ,(face-foreground 'my-colour-var)))))
|
||||||
#+END_SRC
|
#+END_SRC
|
||||||
|
|
||||||
You can also add keybindings to jump and configure the next TODO item in the buffer using
|
* TODO Troubleshooting
|
||||||
| function | description | proposed binding |
|
|
||||||
|--------------------+-----------------------------------+------------------|
|
|
||||||
| ~hl-todo-previous~ | move to the last TODO item | =C-c t p= |
|
|
||||||
| ~hl-todo-next~ | move to the next TODO item | =C-c t n= |
|
|
||||||
| ~hl-todo-occur~ | list all TODO items in the buffer | =C-c t o= |
|
|
||||||
| ~hl-todo-insert~ | make a new TODO item | =C-c t i= |
|
|
||||||
|
|
||||||
this can be mapped like this
|
|
||||||
#+BEGIN_SRC emacs-lisp :tangle no
|
|
||||||
(map! :prefix "C-c t"
|
|
||||||
"p"#'hl-todo-previous
|
|
||||||
"n"#'hl-todo-next
|
|
||||||
"o"#'hl-todo-occur
|
|
||||||
"i"#'hl-todo-insert)
|
|
||||||
|
|
||||||
#+END_SRC
|
|
||||||
|
|
||||||
* Troubleshooting
|
|
||||||
If you have any problems with this module do get in touch!
|
If you have any problems with this module do get in touch!
|
||||||
|
|
|
@ -16,8 +16,8 @@
|
||||||
- [[#mathematical-symbols-replacement][Mathematical symbols replacement]]
|
- [[#mathematical-symbols-replacement][Mathematical symbols replacement]]
|
||||||
- [[#coding-ligatures][Coding ligatures]]
|
- [[#coding-ligatures][Coding ligatures]]
|
||||||
- [[#configuration][Configuration]]
|
- [[#configuration][Configuration]]
|
||||||
- [[#setting-liagtures][Setting liagtures]]
|
- [[#setting-ligatures][Setting ligatures]]
|
||||||
- [[#changing-ligatures][changing ligatures]]
|
- [[#changing-ligatures][Changing ligatures]]
|
||||||
- [[#troubleshooting][Troubleshooting]]
|
- [[#troubleshooting][Troubleshooting]]
|
||||||
|
|
||||||
* Description
|
* Description
|
||||||
|
@ -102,18 +102,18 @@ Even though harfbuzz has been included in emacs 27, there is currently a [[https
|
||||||
(#40864)]] which prevents a safe usage of /composition-function-table/ method in
|
(#40864)]] which prevents a safe usage of /composition-function-table/ method in
|
||||||
emacs 27.
|
emacs 27.
|
||||||
|
|
||||||
* TODO Configuration
|
* Configuration
|
||||||
** Setting liagtures
|
** Setting ligatures
|
||||||
If you want to set ligatures for modules that don't have them by default you can
|
If you want to set ligatures for modules that don't have them by default you can
|
||||||
use the ~set-ligatures!~ macro in your config.el file
|
use the ~set-ligatures!~ macro in your config el file
|
||||||
#+BEGIN_SRC emacs-lisp
|
#+BEGIN_SRC emacs-lisp
|
||||||
(after! major-mode
|
(after! PACKAGE
|
||||||
(set-ligatures! 'major-mode
|
(set-ligatures! 'MAJOR-MODE
|
||||||
:symbol "keyword"))
|
:symbol "keyword"))
|
||||||
#+END_SRC
|
#+END_SRC
|
||||||
eg.
|
eg.
|
||||||
#+BEGIN_SRC emacs-lisp
|
#+BEGIN_SRC emacs-lisp
|
||||||
(after! go-mode
|
(after! go-mode ; in this case the major mode and package named the same thing
|
||||||
(set-ligatures! 'go-mode
|
(set-ligatures! 'go-mode
|
||||||
:def "func" ; function keyword
|
:def "func" ; function keyword
|
||||||
:true "true" :false "false"
|
:true "true" :false "false"
|
||||||
|
@ -126,7 +126,7 @@ eg.
|
||||||
#+END_SRC
|
#+END_SRC
|
||||||
you can set these symbols out of the box
|
you can set these symbols out of the box
|
||||||
#+BEGIN_SRC emacs-lisp
|
#+BEGIN_SRC emacs-lisp
|
||||||
(set-ligatures! 'mode
|
(set-ligatures! 'MAJOR-MODE
|
||||||
;; Functional
|
;; Functional
|
||||||
:lambda "lambda keyword"
|
:lambda "lambda keyword"
|
||||||
:def "function keyword"
|
:def "function keyword"
|
||||||
|
@ -160,21 +160,19 @@ you can set these symbols out of the box
|
||||||
:dot "Dot operator")
|
:dot "Dot operator")
|
||||||
#+END_SRC
|
#+END_SRC
|
||||||
|
|
||||||
|
If you have multiple versions of the same keyword you can set the symbol twice
|
||||||
if you have multiple versions of the same keyword you can set the symbol twice
|
|
||||||
|
|
||||||
#+BEGIN_SRC emacs-lisp
|
#+BEGIN_SRC emacs-lisp
|
||||||
(set-ligatures! scala-mode
|
(set-ligatures! scala-mode
|
||||||
:null "none"
|
:null "none"
|
||||||
:null "None")
|
:null "None")
|
||||||
|
|
||||||
#+END_SRC
|
#+END_SRC
|
||||||
** changing ligatures
|
** Changing ligatures
|
||||||
if you don't like the symbols chosen you can change them by using...
|
if you don't like the symbols chosen you can change them by using...
|
||||||
|
|
||||||
#+BEGIN_SRC emacs-lisp
|
#+BEGIN_SRC emacs-lisp
|
||||||
; you don't need to include all of them you can pick and mix
|
;; you don't need to include all of them you can pick and mix
|
||||||
(setq +ligatures-extra-symbols
|
(plist-put +ligatures-extra-symbols
|
||||||
'(;; org
|
'(;; org
|
||||||
:name "»"
|
:name "»"
|
||||||
:src_block "»"
|
:src_block "»"
|
||||||
|
@ -216,4 +214,4 @@ if you don't like the symbols chosen you can change them by using...
|
||||||
#+END_SRC
|
#+END_SRC
|
||||||
|
|
||||||
* TODO Troubleshooting
|
* TODO Troubleshooting
|
||||||
# Common issues and their solution, or places to look for help.
|
If you have any problems with this module, do get in touch!
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue