Reword the manual for setting customisations

1 files changed, 17 insertions, 11 deletions

diff --git a/README.org b/README.org
index 7378d4f..54b9f6f 100644
--- a/README.org
+++ b/README.org
@@ -124,6 +124,20 @@ Everything is in place to set up the package.
 #+begin_src emacs-lisp
 (require 'ef-themes)
 
+;; Make customisations BEFORE loading a theme (any change needs a theme
+;; re-load to take effect).
+
+(setq ef-themes-headings ; read the manual's entry of 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))))
+
 ;; Disable all other themes to avoid awkward blending:
 (mapc #'disable-theme custom-enabled-themes)
 
@@ -138,17 +152,6 @@ Everything is in place to set up the package.
 ;; Also those which are optimized for deuteranopia (red-green color
 ;; deficiency): `ef-deuteranopia-dark', `ef-deuteranopia-light'.
 
-(setq ef-themes-headings ; read the manual's entry of 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))))
-
 ;; We also provide these commands, but do not assign them to any key:
 ;;
 ;; - `ef-themes-select'
@@ -180,6 +183,9 @@ The =ef-themes= provide a limited set of user options which tweak
 secondary aspects of the theme.  No option affects coloration or the
 overall character of each theme ([[#h:a6dd030c-6b6c-4992-83e8-3438b4607b51][Principles]]).
 
+All customizations need to be evaluated before loading a theme.  Any
+change thus requires a theme re-load ([[#h:a6dd030c-6b6c-4992-83e8-3438b4607b51][Loading a theme]]).
+
 ** Option for headings
 :PROPERTIES:
 :CUSTOM_ID: h:a7a02817-e324-43e9-a7d8-fde024530af6