[elpa] externals/ef-themes b592256c10 1/2: Minor doc fixes

[ELPA Syncer]

branch: externals/ef-themes
commit b592256c10b5afc4af239c53f0510e7d88882714
Author: Eshel Yaron <me@eshelyaron.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Minor doc fixes
    
    * README.org (Preview theme colors): Fix typo.
    (Sample configuration, Option for headings):
    * ef-themes.el (ef-themes-headings): Prefer saying '(foo bar baz)'
    over '(foo . (bar baz))' where appropriate; say "non-nil non-list
    value" to describe such values.
---
 README.org   | 54 +++++++++++++++++++++++++++---------------------------
 ef-themes.el | 33 +++++++++++++++++----------------
 2 files changed, 44 insertions(+), 43 deletions(-)

diff --git a/README.org b/README.org
index e0599b6489..987cb19e1a 100644
--- a/README.org
+++ b/README.org
@@ -137,15 +137,15 @@ Everything is in place to set up the package.
 (setq ef-themes-to-toggle '(ef-summer ef-winter))
 
 (setq ef-themes-headings ; read the manual's entry or the doc string
-      '((0 . (variable-pitch light 1.9))
-        (1 . (variable-pitch light 1.8))
-        (2 . (variable-pitch regular 1.7))
-        (3 . (variable-pitch regular 1.6))
-        (4 . (variable-pitch regular 1.5))
-        (5 . (variable-pitch 1.4)) ; absence of weight means `bold'
-        (6 . (variable-pitch 1.3))
-        (7 . (variable-pitch 1.2))
-        (t . (variable-pitch 1.1))))
+      '((0 variable-pitch light 1.9)
+        (1 variable-pitch light 1.8)
+        (2 variable-pitch regular 1.7)
+        (3 variable-pitch regular 1.6)
+        (4 variable-pitch regular 1.5)
+        (5 variable-pitch 1.4) ; absence of weight means `bold'
+        (6 variable-pitch 1.3)
+        (7 variable-pitch 1.2)
+        (t variable-pitch 1.1)))
 
 ;; They are nil by default...
 (setq ef-themes-mixed-fonts t
@@ -334,12 +334,12 @@ combinations, followed by a presentation of all available 
properties:
 
 #+begin_src emacs-lisp
 (setq ef-themes-headings
-      '((1 . (light variable-pitch 1.5))
-        (2 . (regular 1.3))
-        (3 . (1.1))
-        (agenda-date . (1.3))
-        (agenda-structure . (variable-pitch light 1.8))
-        (t . (variable-pitch))))
+      '((1 light variable-pitch 1.5)
+        (2 regular 1.3)
+        (3 1.1)
+        (agenda-date 1.3)
+        (agenda-structure variable-pitch light 1.8)
+        (t variable-pitch)))
 #+end_src
 
 By default (a ~nil~ value for this variable), all headings have a bold
@@ -381,25 +381,25 @@ In user configuration files the form may look like this:
 
 #+begin_src emacs-lisp
 (setq ef-themes-headings
-      '((1 . (light variable-pitch 1.5))
-        (2 . (regular 1.3))
-        (3 . (1.1))
-        (t . (variable-pitch))))
+      '((1 light variable-pitch 1.5)
+        (2 regular 1.3)
+        (3 1.1)
+        (t variable-pitch)))
 #+end_src
 
-When defining the styles per heading level, it is possible to
-pass a non-~nil~ value (t) instead of a list of properties.  This
-will retain the original aesthetic for that level.  For example:
+When defining the styles per heading level, it is possible to pass a
+non-~nil~ non-list value (e.g. ~t~) instead of a list of properties.
+This will retain the original aesthetic for that level.  For example:
 
 #+begin_src emacs-lisp
 (setq ef-themes-headings
       '((1 . t)           ; keep the default style
-        (2 . (variable-pitch 1.2))
-        (t . (variable-pitch)))) ; style for all unspecified headings
+        (2 variable-pitch 1.2)
+        (t variable-pitch))) ; style for all unspecified headings
 
 (setq ef-themes-headings
-      '((1 . (variable-pitch 1.6))
-        (2 . (1.3))
+      '((1 variable-pitch 1.6)
+        (2 1.3)
         (t . t))) ; default style for all unspecified levels
 #+end_src
 
@@ -786,7 +786,7 @@ color as a backdrop.
 
 The name of the buffer describes the given Ef theme and what the
 contents are, such as =*ef-summer-list-colors*= for named colors and
-==*ef-summer-list-mappings*= for the semantic color mappings.
+=*ef-summer-list-mappings*= for the semantic color mappings.
 
 * Use colors from the active Ef theme
 :PROPERTIES:
diff --git a/ef-themes.el b/ef-themes.el
index 905081d3ce..bd517cf8d4 100644
--- a/ef-themes.el
+++ b/ef-themes.el
@@ -188,12 +188,12 @@ stylistic combinations, followed by a presentation of all
 available properties:
 
     (setq ef-themes-headings
-          (quote ((1 . (light variable-pitch 1.5))
-                  (2 . (regular 1.3))
-                  (3 . (1.1))
-                  (agenda-date . (1.3))
-                  (agenda-structure . (variable-pitch light 1.8))
-                  (t . (variable-pitch)))))
+          (quote ((1 light variable-pitch 1.5)
+                  (2 regular 1.3)
+                  (3 1.1)
+                  (agenda-date 1.3)
+                  (agenda-structure variable-pitch light 1.8)
+                  (t variable-pitch))))
 
 By default (a nil value for this variable), all headings have a
 bold typographic weight, a font family that is the same as the
@@ -232,23 +232,24 @@ The order in which the properties are set is not 
significant.
 In user configuration files the form may look like this:
 
     (setq ef-themes-headings
-          (quote ((1 . (light variable-pitch 1.5))
-                  (2 . (regular 1.3))
-                  (3 . (1.1))
-                  (t . (variable-pitch)))))
+          (quote ((1 light variable-pitch 1.5)
+                  (2 regular 1.3)
+                  (3 1.1)
+                  (t variable-pitch))))
 
 When defining the styles per heading level, it is possible to
-pass a non-nil value (t) instead of a list of properties.  This
-will retain the original aesthetic for that level.  For example:
+pass a non-nil non-list value (e.g. t) instead of a list of
+properties.  This will retain the original aesthetic for that
+level.  For example:
 
     (setq ef-themes-headings
           (quote ((1 . t)           ; keep the default style
-                  (2 . (variable-pitch 1.2))
-                  (t . (variable-pitch))))) ; style for all other headings
+                  (2 variable-pitch 1.2)
+                  (t variable-pitch)))) ; style for all other headings
 
     (setq ef-themes-headings
-          (quote ((1 . (variable-pitch 1.6))
-                  (2 . (1.3))
+          (quote ((1 variable-pitch 1.6)
+                  (2 1.3)
                   (t . t)))) ; default style for all other levels"
   :group 'ef-themes
   :package-version '(ef-themes . "0.10.0")