[elpa] externals/modus-operandi-theme 0e45c0a 056/153: Reword manual's entry on Org user faces

[Stefan Monnier]

branch: externals/modus-operandi-theme
commit 0e45c0a59b065cbde924f99cb9428346b614018f
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Reword manual's entry on Org user faces
    
    * doc/modus-themes.org (Org user faces (DIY)): Reword entry.
    Clarify some points.
    
    * doc/modus-themes.info (File): Recompile info manual.
---
 doc/modus-themes.info | 61 ++++++++++++++++++++++++++++-----------------------
 doc/modus-themes.org  | 27 +++++++++++++++--------
 2 files changed, 52 insertions(+), 36 deletions(-)

diff --git a/doc/modus-themes.info b/doc/modus-themes.info
index 112ecef..437a9fd 100644
--- a/doc/modus-themes.info
+++ b/doc/modus-themes.info
@@ -1147,19 +1147,26 @@ applied by the ‘org-todo’ face:
              ("STUDY" . '(font-lock-variable-name-face org-todo))
              ("WRITE" . '(font-lock-type-face org-todo))))
 
-   This will refashion the keywords you specify, while letting the
-others use their original styles (which are defined in the ‘org-todo’
-face).
+   This will refashion the keywords you specify, while letting the other
+items in ‘org-todo-keywords’ use their original styles (which are
+defined in the ‘org-todo’ and ‘org-done’ faces).
 
-   When you inherit from multiple faces, you need to quote the list as
-shown above.  The order is important: the last item is applied over the
-previous ones.
+   If you want back the defaults, try specifying just the ‘org-todo’
+face (or use ‘org-done’ if the meaning of the keywords you use demands
+as much):
+
+     (setq org-todo-keyword-faces
+           '(("MEET" . org-todo)
+             ("STUDY" . org-todo)
+             ("WRITE" . org-todo)))
 
-   If you do not want to blend multiple faces, you do not need a quoted
-list.  A pattern of ‘keyword . face’ would suffice.
+   When you inherit from multiple faces, you need to quote the list as
+shown further above.  The order is important: the last item is applied
+over the previous ones.  If you do not want to blend multiple faces, you
+do not need a quoted list.  A pattern of ‘keyword . face’ would suffice.
 
-   Consider both approaches in the configuration of the priority
-cookies:
+   Both approaches can be used simultaneously, as illustrated in this
+configuration of the priority cookies:
 
      (setq org-priority-faces
            '((?A . '(org-scheduled-today org-priority))
@@ -2289,23 +2296,23 @@ Node: Font configs (DIY)38546
 Ref: Font configs (DIY)-Footnote-141126
 Ref: Font configs (DIY)-Footnote-241313
 Node: Org user faces (DIY)41535
-Node: Face coverage44367
-Node: Supported packages44869
-Node: Covered indirectly50791
-Node: Will NOT be supported51143
-Node: Notes for individual packages51861
-Node: Note for powerline or spaceline52267
-Node: Note on shr colours52639
-Node: Note for Helm grep53052
-Node: Note on vc-annotate-background-mode54499
-Node: Contributing55353
-Node: Sources of the themes55772
-Node: Issues you can help with56534
-Node: Merge requests57721
-Node: Acknowledgements58803
-Node: Meta60260
-Node: External projects (ports)61313
-Node: GNU Free Documentation License62136
+Node: Face coverage44756
+Node: Supported packages45258
+Node: Covered indirectly51180
+Node: Will NOT be supported51532
+Node: Notes for individual packages52250
+Node: Note for powerline or spaceline52656
+Node: Note on shr colours53028
+Node: Note for Helm grep53441
+Node: Note on vc-annotate-background-mode54888
+Node: Contributing55742
+Node: Sources of the themes56161
+Node: Issues you can help with56923
+Node: Merge requests58110
+Node: Acknowledgements59192
+Node: Meta60649
+Node: External projects (ports)61702
+Node: GNU Free Documentation License62525
 
 End Tag Table
 
diff --git a/doc/modus-themes.org b/doc/modus-themes.org
index dcf9037..05e0ed8 100644
--- a/doc/modus-themes.org
+++ b/doc/modus-themes.org
@@ -1027,17 +1027,27 @@ applied by the =org-todo= face:
         ("WRITE" . '(font-lock-type-face org-todo))))
 #+end_src
 
-This will refashion the keywords you specify, while letting the others
-use their original styles (which are defined in the =org-todo= face).
+This will refashion the keywords you specify, while letting the other
+items in =org-todo-keywords= use their original styles (which are defined
+in the =org-todo= and =org-done= faces).
 
-When you inherit from multiple faces, you need to quote the list as
-shown above.  The order is important: the last item is applied over the
-previous ones.
+If you want back the defaults, try specifying just the =org-todo= face (or
+use =org-done= if the meaning of the keywords you use demands as much):
 
-If you do not want to blend multiple faces, you do not need a quoted
-list.  A pattern of =keyword . face= would suffice.
+#+begin_src emacs-lisp
+(setq org-todo-keyword-faces
+      '(("MEET" . org-todo)
+        ("STUDY" . org-todo)
+        ("WRITE" . org-todo)))
+#+end_src
 
-Consider both approaches in the configuration of the priority cookies:
+When you inherit from multiple faces, you need to quote the list as
+shown further above.  The order is important: the last item is applied
+over the previous ones.  If you do not want to blend multiple faces, you
+do not need a quoted list.  A pattern of =keyword . face= would suffice.
+
+Both approaches can be used simultaneously, as illustrated in this
+configuration of the priority cookies:
 
 #+begin_src emacs-lisp
 (setq org-priority-faces
@@ -1055,7 +1065,6 @@ Also consider reading the "Notes for aspiring Emacs theme 
developers",
 published on 2020-08-28 by Protesilaos Stavrou:
 https://protesilaos.com/codelog/2020-08-28-notes-emacs-theme-devs/.
 
-
 * Face coverage
 :PROPERTIES:
 :CUSTOM_ID: h:a9c8f29d-7f72-4b54-b74b-ddefe15d6a19