[nongnu] elpa/alect-themes a858dea 061/269: Add description of emacs bug in theming variables

[ELPA Syncer]

branch: elpa/alect-themes
commit a858deaf76c037f99fba176dc3b4b96994519ff0
Author: Alex Kost <alezost@gmail.com>
Commit: Alex Kost <alezost@gmail.com>

    Add description of emacs bug in theming variables
---
 README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/README.md b/README.md
index 4719e77..f887855 100644
--- a/README.md
+++ b/README.md
@@ -188,6 +188,30 @@ then the override spec."
 If you put it into your `.emacs`, you will always get pure themes
 without unintended face settings.
 
+### Emacs bug
+
+Emacs has a bug
+([#16266](http://debbugs.gnu.org/cgi/bugreport.cgi?bug=16266)) that
+doesn't allow to set undefined variables.  For example, if a theme
+customizes a color for emms icon and you load the theme before emms,
+then emms icon will use a default color instead of the themed one.  This
+bug takes effect only on `defvar`-ed variables, `defcustom`-ed variables
+are safe.
+
+The range of such variables (effected by the bug) suitable for
+colorizing is very limited.  For alect themes, the following variables
+are themed: `emms-mode-line-icon-image-cache`,
+`gnus-mode-line-image-cache` and `gnus-logo-colors`.
+
+You can use this workaround to avoid the bug:
+```lisp
+(defadvice custom-theme-set-variables
+  (around fix-inhibit-bug activate)
+  "Allow setting of undefined variables in themes."
+  (let (custom--inhibit-theme-enable)
+    ad-do-it))
+```
+
 ## Screenshots
 
 You can see the following and other screenshots in