[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/standard-themes f40d1adace 71/74: Make minor correction
From: |
ELPA Syncer |
Subject: |
[elpa] externals/standard-themes f40d1adace 71/74: Make minor corrections to documentation |
Date: |
Wed, 30 Nov 2022 08:58:27 -0500 (EST) |
branch: externals/standard-themes
commit f40d1adace299c0b4a22e964801afa7ed843595b
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>
Make minor corrections to documentation
---
README.org | 42 +++++++++++++++++++++---------------------
standard-themes.el | 33 +++++++++++++++++----------------
2 files changed, 38 insertions(+), 37 deletions(-)
diff --git a/README.org b/README.org
index bb3520d716..ef2f899bd8 100644
--- a/README.org
+++ b/README.org
@@ -306,7 +306,7 @@ With ~intense~, use a more pronounced gray background color.
#+vindex: standard-themes-links
The user option ~standard-themes-links~ controls the style of links.
The value is a list of properties, each designated by a symbol. The
-default (a nil value or an empty list) is a prominent text color,
+default (a ~nil~ value or an empty list) is a prominent text color,
typically blue, with an underline of the same color.
For the style of the underline, a ~neutral-underline~ property
@@ -354,25 +354,24 @@ Please refer to their documentation strings.
The user option ~standard-themes-prompts~ controls the style of all
prompts, such as those of the minibuffer and REPLs.
-The value is a list of properties, each designated by a symbol.
-The default (a nil value or an empty list) means to only use a
-subtle accented foreground color.
+The value is a list of properties, each designated by a symbol. The
+default (a ~nil~ value or an empty list) means to only use an accented
+foreground color.
-The property ~background~ applies a background color to the
-prompt's text. By default, this is a subtle accented value.
+The property ~background~ applies a background color to the prompt's
+text and adjusts the foreground accordingly.
The property ~bold~ makes the text use a bold typographic weight.
Similarly, ~italic~ adds a slant to the font's forms (italic or
oblique forms, depending on the typeface).
-Combinations of any of those properties are expressed as a list,
-like in these examples:
+Combinations of any of those properties are expressed as a list, like
+in these examples:
#+begin_src emacs-lisp
-(intense)
-(bold intense)
-(intense bold gray)
-(intense background gray bold)
+(background)
+(bold italic)
+(background bold italic)
#+end_src
The order in which the properties are set is not significant.
@@ -380,7 +379,7 @@ The order in which the properties are set is not
significant.
In user configuration files the form may look like this:
#+begin_src emacs-lisp
-(setq standard-themes-prompts '(background gray))
+(setq standard-themes-prompts '(background bold))
#+end_src
** Option for headings
@@ -392,17 +391,18 @@ In user configuration files the form may look like this:
The user option ~standard-themes-headings~ provides support for individual
heading styles for levels 0 through 8.
-This is an alist that accepts a =(key . list-of-values)= combination.
-The key is either a number, representing the heading's level (0
-through 8) or =t=, which pertains to the fallback style.
+This is an alist that accepts a =(KEY . LIST-OF-VALUES)= combination.
+The =KEY= is either a number, representing the heading's level (0-8)
+or ~t~, which pertains to the fallback style. The fallback applies to
+all heading levels that are not customized.
Level 0 is a special heading: it is used for what counts as a document
-title or equivalent, such as the =#+title= construct we find in Org
+title or equivalent, such as the =#+TITLE= construct we find in Org
files. Levels 1-8 are regular headings.
-The list of values covers symbols that refer to properties, as described
-below. Here is a complete sample, followed by a presentation of all
-available properties:
+The list of values covers symbols that refer to properties, as
+described below. Here is a complete sample, followed by a
+presentation of all available properties:
#+begin_src emacs-lisp
(setq standard-themes-headings
@@ -412,7 +412,7 @@ available properties:
(t . (variable-pitch))))
#+end_src
-By default (a ~nil~ value for this variable), all headings have a bold
+By default (a ~nil~ value for this variable), all headings have a normal
typographic weight, a font family that is the same as the ~default~ face
(typically monospaced), and a height that is equal to the ~default~
face's height.
diff --git a/standard-themes.el b/standard-themes.el
index 0d8a9daad7..b297b1f938 100644
--- a/standard-themes.el
+++ b/standard-themes.el
@@ -105,14 +105,16 @@ This affects comments, doc strings, and some other minor
elements."
This is a helper variable intended for internal use.")
(defcustom standard-themes-headings nil
- "Heading styles with optional list of values for levels 0-8.
+ "Set heading style with optional list of values for levels 0-8.
-This is an alist that accepts a (key . list-of-values)
-combination. The key is either a number, representing the
+This is an alist that accepts a (KEY . LIST-OF-VALUES)
+combination. The KEY is either a number, representing the
heading's level (0-8) or t, which pertains to the fallback style.
+The fallback applies to all heading levels that are not
+customized.
Level 0 is a special heading: it is used for what counts as a
-document title or equivalent, such as the #+title construct we
+document title or equivalent, such as the #+TITLE construct we
find in Org files. Levels 1-8 are regular headings.
The list of values covers symbols that refer to properties, as
@@ -126,7 +128,7 @@ presentation of all available properties:
(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
+normal typographic weight, a font family that is the same as the
`default' face (typically monospaced), and a height that is equal
to the `default' face's height.
@@ -253,7 +255,7 @@ Other examples:
:type '(set :tag "Properties" :greedy t
(const :tag "Do not extend to the edge of the window" no-extend)
(const :tag "More neutral/gray background" neutral)
- (const :tag "More intense background (also override text color)"
accented))
+ (const :tag "More intense background (also override text color)"
intense))
:link '(info-link "(standard-themes) Style of region highlight"))
(defcustom standard-themes-fringes 'subtle
@@ -267,7 +269,6 @@ visible yet close to the main background color.
With `intense', use a more pronounced gray background color."
:group 'standard-themes
:package-version '(standard-themes . "1.0.0")
- :version "29.1"
:type '(choice
(const :format "[%v] %t\n" :tag "No visible fringes" nil)
(const :format "[%v] %t\n" :tag "Subtle gray background" subtle)
@@ -330,11 +331,11 @@ Please refer to their documentation strings."
"Control the style of prompts (e.g. minibuffer, REPL).
The value is a list of properties, each designated by a symbol.
-The default (a nil value or an empty list) means to only use a
-subtle accented foreground color.
+The default (a nil value or an empty list) means to only use an
+accented foreground color.
The property `background' applies a background color to the
-prompt's text. By default, this is a subtle accented value.
+prompt's text and adjusts the foreground accordingly.
The property `bold' makes the text use a bold typographic weight.
Similarly, `italic' adds a slant to the font's forms (italic or
@@ -343,16 +344,15 @@ oblique forms, depending on the typeface).
Combinations of any of those properties are expressed as a list,
like in these examples:
- (intense)
- (bold intense)
- (intense bold gray)
- (intense background gray bold)
+ (background)
+ (bold italic)
+ (background bold italic)
The order in which the properties are set is not significant.
In user configuration files the form may look like this:
- (setq standard-themes-prompts (quote (background gray)))"
+ (setq standard-themes-prompts (quote (background bold)))"
:group 'standard-themes
:package-version '(standard-themes . "1.0.0")
:type '(set :tag "Properties" :greedy t
@@ -362,7 +362,8 @@ In user configuration files the form may look like this:
:link '(info-link "(standard-themes) Option for command prompts"))
(defcustom standard-themes-mode-line-accented nil
- "When non-nil, use accented background for the active mode line."
+ "When non-nil, use accented background for the active mode line.
+The default is a gray background color."
:group 'standard-themes
:package-version '(standard-themes . "1.0.0")
:type 'boolean
- [elpa] externals/standard-themes 2b4b1d59ca 45/74: standard-dark: change bg-completion hue, (continued)
- [elpa] externals/standard-themes 2b4b1d59ca 45/74: standard-dark: change bg-completion hue, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes 13cbf8896c 34/74: standard-light-theme: tweak mail-0 mapping, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes be8d4542e1 46/74: Experiment with yellow hue for bg-prompt, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes 62f0cc1172 52/74: Experiment with bespoke bg-prompt, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes 6a49e3aab1 54/74: Cover the git-commit-comment-branch-remote face, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes ae410d684e 47/74: Tweak diff colours; add foregrounds, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes dceb1d9098 66/74: Refine mail mappings, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes 56e3506a55 69/74: Remove support for selectrum (deprecated in favour of Vertico), ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes 6f859ccb20 70/74: Tweak Commentary header in files, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes 78c561c291 68/74: Use correct style for bongo-marked-track, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes f40d1adace 71/74: Make minor corrections to documentation,
ELPA Syncer <=
- [elpa] externals/standard-themes d1921204c1 74/74: Release the first version of the 'standard-themes', ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes d5a9d16213 29/74: standard-dark-theme: refine blue-warmer value, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes 5ac4d00a09 37/74: Make compilation-info face stand out more, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes 4ab877d8c1 62/74: Refine colour mapping for the mode line, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes aa0f899043 64/74: Use bespoke faces for fringe indicators, ELPA Syncer, 2022/11/30
- [elpa] externals/standard-themes cacc2ee597 13/74: Write the manual, ELPA Syncer, 2022/11/30