[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/alect-themes 52fec13 097/269: Update README
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/alect-themes 52fec13 097/269: Update README |
Date: |
Thu, 21 Oct 2021 17:58:57 -0400 (EDT) |
branch: elpa/alect-themes
commit 52fec1350e5cbdb28199f8ef1e1f2f16a4d8f05c
Author: Alex Kost <alezost@gmail.com>
Commit: Alex Kost <alezost@gmail.com>
Update README
1. Add table of contents.
2. Move "History" section to the bottom.
3. Improve "Emacs 24.3.1 and earlier" section.
---
README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++------------------
1 file changed, 50 insertions(+), 20 deletions(-)
diff --git a/README.md b/README.md
index 1741f39..7a468f3 100644
--- a/README.md
+++ b/README.md
@@ -5,15 +5,23 @@ enough) **configurable** light and dark color themes for GNU
Emacs 24 or
later. The themes are intended to be used with GUI (see
[Class of terminals](#class-of-terminals)).
-## History
-
-At first i had only a light theme – it was just a set of customized
-faces. Then i realized that at night it's better for eyes to use a
-dark theme (it was derived from zenburn-theme initially, but then the
-colors were modified a lot). The idea of creating two themes with
-different colors and the same code base came from solarized-theme.
-The code of solarized and zenburn themes was used hardly. Many thanks
-to their authors.
+## Table of Contents
+
+* [Installation](#installation)
+ * [Manual](#manual)
+ * [MELPA](#melpa)
+* [Usage](#usage)
+* [Configuration](#configuration)
+ * [Class of terminals](#class-of-terminals)
+ * [Modifying palette](#modifying-palette)
+ * [Overriding faces](#overriding-faces)
+ * [Alternative themes](#alternative-themes)
+ * [Other variables](#other-variables)
+ * [Emacs 24.3.1 and earlier](#emacs-2431-and-earlier)
+ * [Emacs bug in themed variables](#emacs-bug-in-themed-variables)
+* [Screenshots](#screenshots)
+* [History](#history)
+* [Feedback](#feedback)
## Installation
@@ -203,16 +211,14 @@ instead of the themed colored buttons (the right picture):
<img src="http://i.imgur.com/66G9VvX.png" title="alect-light - Custom-mode
(proper colors)"/></a>
This happens because Emacs applies default face settings even for a
-themed face. This behaviour is changed in new versions of Emacs (24.4
-and above). Happily it can be easily fixed for earlier versions by
-redefining `face-spec-recalc` function (can be found on
-[Emacs git
mirror](http://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/faces.el)):
+themed face. This behaviour is changed in new versions of Emacs: since
+24.4 (not released yet) you will always get pure themes without
+unintended face settings. If you use a previous version of Emacs, you
+can try the following workaround to achieve the new behaviour:
```lisp
-(defun face-spec-recalc (face frame)
- "Reset the face attributes of FACE on FRAME according to its specs.
-This applies the defface/custom spec first, then the custom theme specs,
-then the override spec."
+(defun face-spec-recalc-new (face frame)
+ "Improved version of `face-spec-recalc'."
(while (get face 'face-alias)
(setq face (get face 'face-alias)))
(face-spec-reset-face face frame)
@@ -225,12 +231,26 @@ then the override spec."
(face-spec-set-2 face frame (cadr spec)))
(face-spec-set-2 face frame (face-default-spec face))))
(face-spec-set-2 face frame (get face 'face-override-spec)))
+(defadvice face-spec-recalc (around new-recalc (face frame) activate)
+ "Use `face-spec-recalc-new' instead."
+ (face-spec-recalc-new face frame))
```
-If you put it into your `.emacs`, you will always get pure themes
-without unintended face settings.
+That version of `face-spec-recalc` (wrapped with advice) is one of the
+development variants from 24.3.50.1. It works good except of one
+particular case: if you try to use that workaround and enable a theme in
+an unsupported (by the theme) terminal (e.g. alect-theme in a text
+terminal), your monitor may suddenly explode. Currently
+[faces.el](http://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/faces.el)
+is changed a lot (comparing to 24.3) and I don't know a better
+workaround.
+
+*Summary:* `alect-themes` use inheriting a lot and because of the nature
+of faces in Emacs 24.3, **many** of them look ugly. With Emacs 24.4 or
+with the above workaround (use it only with GUI), the themes look how
+they should.
-### Emacs bug
+### Emacs bug in themed variables
Emacs has a bug
([#16266](http://debbugs.gnu.org/cgi/bugreport.cgi?bug=16266)) that
@@ -318,6 +338,16 @@ alternative themes, configured to invert background (see
<a href="http://i.imgur.com/HNMr4qj.png">
<img src="http://i.imgur.com/HNMr4qj.png" title="alect-dark-alt (modified) -
dired, elisp" width=320 height=240/></a>
+## History
+
+At first i had only a light theme – it was just a set of customized
+faces. Then i realized that at night it's better for eyes to use a
+dark theme (it was derived from zenburn-theme initially, but then the
+colors were modified a lot). The idea of creating two themes with
+different colors and the same code base came from solarized-theme.
+The code of solarized and zenburn themes was used hardly. Many thanks
+to their authors.
+
## Feedback
If you want this package to support more faces, you may send me a
- [nongnu] elpa/alect-themes 6f72dc2 191/269: Add 'alect-faces' customization group, (continued)
- [nongnu] elpa/alect-themes 6f72dc2 191/269: Add 'alect-faces' customization group, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 69f19b8 195/269: Add support for 'speedbar', ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 7be9d36 197/269: Update guix faces, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes e91ad38 202/269: Add 'sh-escaped-newline' face, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 59841fd 205/269: Add 'helm-header-line-left-margin' face, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 7a9cc71 045/269: Ignore "alect-test.el", ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 509b42f 055/269: Modify erc faces, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 445fdf7 060/269: Remove "defvar"s for gnus and emms icons, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 6a12d8e 065/269: Update example of modifying palette, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes be3bdc1 077/269: Modify info-title faces, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 52fec13 097/269: Update README,
ELPA Syncer <=
- [nongnu] elpa/alect-themes 81b3e6a 104/269: Add google-translate faces, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 5d470e9 109/269: Update README for black themes, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 653ed3f 131/269: Remove grep "faces", ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 094d361 048/269: Preserve the structure of `alect-overriding-faces', ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 3ff3dc4 057/269: Ignore "colors-test", ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes c919c94 067/269: Modify gnus/message headers, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes b4e288e 070/269: Add alect-title-<N> faces, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes e005f1d 074/269: Update version (0.3.5), ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 72f6c44 075/269: Add height variables, ELPA Syncer, 2021/10/21
- [nongnu] elpa/alect-themes 1ccf42c 083/269: Add font lock faces for regexp groups, ELPA Syncer, 2021/10/21