[nongnu] elpa/dracula-theme e4672e2 137/187: Do not advertize dracula-use-24-bit-colors-on-256-colors-terms in README

[ELPA Syncer]

branch: elpa/dracula-theme
commit e4672e22885772d2be0c75df03c4f805f1acf5fa
Author: Étienne Deparis <etienne@depar.is>
Commit: Étienne Deparis <etienne@depar.is>

    Do not advertize dracula-use-24-bit-colors-on-256-colors-terms in README
    
    The issue 59 proves again that 256 colors terminal cannot handle the
    24bit colors of the graphical definition.  Thus regular user should not
    try to activate this new setting, or, if they want to, must fully
    aknowledge the possible drawbacks.
    
    I also add a long comment to this setting to explain one of the possible
    problems and a solution to it.
    
    See: https://github.com/dracula/emacs/issues/59
---
 README.md        |  3 ---
 dracula-theme.el | 20 ++++++++++++++++----
 2 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index c9be0df..b607b0c 100644
--- a/README.md
+++ b/README.md
@@ -36,9 +36,6 @@ need to be set before `load-theme` is invoked for Dracula.
 
 ;; Use less pink and bold on the mode-line and minibuffer (default nil)
 (setq dracula-alternate-mode-line-and-minibuffer t)
-
-;; Force 24 bit colors (regular colors) on terminals (default nil)
-(setq dracula-use-24-bit-colors-on-256-colors-terms t)
 ```
 
 ## Test
diff --git a/dracula-theme.el b/dracula-theme.el
index e168a94..7be48e0 100644
--- a/dracula-theme.el
+++ b/dracula-theme.el
@@ -56,10 +56,22 @@ The theme has to be reloaded after changing anything in 
this group."
   :type 'boolean
   :group 'dracula)
 
-(defcustom dracula-use-24-bit-colors-on-256-colors-terms nil
-  "Use true colors even on terminals announcing less capabilities."
-  :type 'boolean
-  :group 'dracula)
+(defvar dracula-use-24-bit-colors-on-256-colors-terms nil
+  "Use true colors even on terminals announcing less capabilities.
+
+Beware the use of this variable.  Using it may lead to unwanted
+behavior, the most common one being an ugly blue background on
+terminals, which don't understand 24 bit colors.  To avoid this
+blue background, when using this variable, one can try to add the
+following lines in their config file after having load the
+Dracula theme:
+
+    (unless (display-graphic-p)
+      (set-face-background 'default \"black\" nil))
+
+There is a lot of discussion behind the 256 colors theme (see URL
+`https://github.com/dracula/emacs/pull/57').  Please take time to
+read it before opening a new issue about your will.")
 
 
 ;;;; Theme definition: