adding the requested changes

This commit is contained in:
Jeetaditya Chatterjee 2020-08-22 18:32:02 +01:00
parent 51b47d0fa6
commit 89068d88d4
2 changed files with 47 additions and 45 deletions

View file

@ -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
(after! hl-todo
(setq hl-todo-keyword-faces (setq hl-todo-keyword-faces
`(("FOO" . ,(face-foreground "MY COLOUR HEX CODE")) `(
("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!

View file

@ -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!