From 0e1bbc449977334db04d925571c06fda4f0dcf28 Mon Sep 17 00:00:00 2001
From: Henrik Lissner <henrik@lissner.net>
Date: Mon, 9 Sep 2019 21:55:27 -0400
Subject: [PATCH] Expand custom{-theme,}-set-faces! example in docs/api.org

To include usage of doom-themes' api
---
 docs/api.org | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/api.org b/docs/api.org
index ac6375c27ff..6049cc48181 100644
--- a/docs/api.org
+++ b/docs/api.org
@@ -113,6 +113,14 @@ It is integrated into Helpful, in Doom.
      :weight normal)
    `(,red-bg-faces
      :background "red" :weight bold)))
+
+;; If you want to make use of the `doom-themes' package API (e.g. `doom-color',
+;; `doom-lighten', `doom-darken', etc.), you must use `custom-set-faces!'
+;; *after* the theme has been loaded. e.g.
+(load-theme 'doom-one t)
+(custom-set-faces!
+ `(outline-1 :foreground ,(doom-color 'red))
+ `(outline-2 :background ,(doom-color 'blue)))
 #+END_SRC
 
 *** custom-theme-set-faces!
@@ -139,6 +147,14 @@ It is integrated into Helpful, in Doom.
      :weight normal)
    `(,red-bg-faces
      :background "red" :weight bold)))
+
+;; If you want to make use of the `doom-themes' package API (e.g. `doom-color',
+;; `doom-lighten', `doom-darken', etc.), you must use `custom-set-faces!'
+;; *after* the theme has been loaded. e.g.
+(load-theme 'doom-one t)
+(custom-theme-set-faces! 'doom-one
+ `(outline-1 :foreground ,(doom-color 'red))
+ `(outline-2 :background ,(doom-color 'blue)))
 #+END_SRC
 
 *** TODO defer-feature!