emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
doomemacs/docs/api.org
Henrik Lissner 7d9e844e35
docs/api: add custom{,-theme}-set-faces! entry
2019-07-26 03:12:06 +02:00

3.5 KiB
Raw Blame History

API Demos

This appendix serves as a reference on how to use Doom Emacs' standard library. It is integrated into Helpful, in Doom.

add-hook! 

;; With only one hook and one function, this is identical to `add-hook'. In that
;; case, use that instead.
(add-hook! 'some-mode-hook 'enable-something)

;; Adding many-to-many functions to hooks
(add-hook! some-mode '(enable-something and-another))
(add-hook! '(one-mode-hook second-mode-hook) 'enable-something)
(add-hook! (one-mode second-mode) 'enable-something)

;; Appending and local hooks
(add-hook! :append (one-mode second-mode) 'enable-something)
(add-hook! :local (one-mode second-mode) 'enable-something)

;; With arbitrary forms
(add-hook! (one-mode second-mode) (setq v 5) (setq a 2))
(add-hook! :append :local (one-mode second-mode) (setq v 5) (setq a 2))

;; Inline named hook functions
(add-hook! '(one-mode-hook second-mode-hook)
  (defun do-something ()
    ...)
  (defun do-another-thing ()
    ...))

custom-theme-set-faces! 

(custom-theme-set-faces! 'doom-one-theme
 `(outline-1 :weight normal)
 `(outline-2 :weight normal)
 `(outline-3 :weight normal)
 `(outline-4 :weight normal)
 `(outline-5 :weight normal)
 `(outline-6 :weight normal)
 `(default :background "red" :weight bold)
 `(region :background "red" :weight bold)`)

(custom-theme-set-faces! '(doom-one-theme doom-one-light-theme)
 `((outline-1 outline-2 outline-3 outline-4 outline-5 outline-6)
   :weight normal)
 `((default region)
   :background "red" :weight bold))

(let ((red-bg-faces '(default region)))
  (custom-theme-set-faces! '(doom-one-theme doom-one-light-theme)
   `(,(cl-loop for i from 0 to 6 collect (intern (format "outline-%d" i)))
     :weight normal)
   `(,red-bg-faces
     :background "red" :weight bold)))

custom-set-faces! 

(custom-set-faces!
 `(outline-1 :weight normal)
 `(outline-2 :weight normal)
 `(outline-3 :weight normal)
 `(outline-4 :weight normal)
 `(outline-5 :weight normal)
 `(outline-6 :weight normal)
 `(default :background "red" :weight bold)
 `(region :background "red" :weight bold)`)

(custom-set-faces!
 `((outline-1 outline-2 outline-3 outline-4 outline-5 outline-6)
   :weight normal)
 `((default region)
   :background "red" :weight bold))

(let ((red-bg-faces '(default region)))
  (custom-set-faces!
   `(,(cl-loop for i from 0 to 6 collect (intern (format "outline-%d" i)))
     :weight normal)
   `(,red-bg-faces
     :background "red" :weight bold)))

file-exists-p! 

(file-exists-p! "init.el" doom-emacs-dir)
/home/hlissner/.emacs.d/init.el

(file-exists-p! (and (or "doesnotexist" "init.el")
                     "LICENSE")
                doom-emacs-dir)
/home/hlissner/.emacs.d/LICENSE

remove-hook! 

;; With only one hook and one function, this is identical to `add-hook'. In that
;; case, use that instead.
(remove-hook! 'some-mode-hook 'enable-something)

;; Adding many-to-many functions to hooks
(remove-hook! some-mode '(enable-something and-another))
(remove-hook! '(one-mode-hook second-mode-hook) 'enable-something)
(remove-hook! (one-mode second-mode) 'enable-something)

;; Appending and local hooks
(remove-hook! :append (one-mode second-mode) 'enable-something)
(remove-hook! :local (one-mode second-mode) 'enable-something)

;; With arbitrary forms
(remove-hook! (one-mode second-mode) (setq v 5) (setq a 2))