[elpa] externals/ef-themes 4df80e1351 3/3: Clarify wording about custom faces at startup

[ELPA Syncer]

branch: externals/ef-themes
commit 4df80e13515bffc89aa1b32f712497987a681712
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Clarify wording about custom faces at startup
---
 README.org | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/README.org b/README.org
index 52849f6785..226651e69e 100644
--- a/README.org
+++ b/README.org
@@ -581,7 +581,26 @@ This function is added to the `ef-themes-post-load-hook'."
 (add-hook 'ef-themes-post-load-hook #'my-ef-themes-custom-faces)
 #+end_src
 
-All changes take effect when a theme is loaded again.
+All changes take effect when a theme is loaded again.  As such, it is
+better to use ~ef-themes-select~ at startup so that the function added
+to the hook gets applied properly upon first load.  Like this:
+
+#+begin_src emacs-lisp
+(defun my-ef-themes-custom-faces ()
+  "My customizations on top of the Ef themes.
+This function is added to the `ef-themes-post-load-hook'."
+  (ef-themes-with-colors
+    (custom-set-faces
+     `(font-lock-comment-face ((,c :foreground ,variable)))
+     `(font-lock-variable-name-face ((,c :inherit italic :foreground 
,comment))))))
+
+;; Using the hook lets our changes persist when we use the commands
+;; `ef-themes-toggle', `ef-themes-select', and `ef-themes-load-random'.
+(add-hook 'ef-themes-post-load-hook #'my-ef-themes-custom-faces)
+
+;; Load the theme and run `ef-themes-post-load-hook'
+(ef-themes-select 'ef-summer) ; Instead of (load-theme 'ef-summer :no-confirm)
+#+end_src
 
 Please contact us if you have specific questions about this mechanism.
 We are willing to help and shall provide comprehensive documentation