[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/sweeprolog 07fc84b716 140/166: DOC: document new user opti
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/sweeprolog 07fc84b716 140/166: DOC: document new user option sweep-faces-style |
Date: |
Fri, 30 Sep 2022 04:59:32 -0400 (EDT) |
branch: elpa/sweeprolog
commit 07fc84b716ba243504400ba2134e9d72548ae8f0
Author: Eshel Yaron <me@eshelyaron.com>
Commit: Eshel Yaron <me@eshelyaron.com>
DOC: document new user option sweep-faces-style
---
NEWS.org | 6 ++++++
README.org | 28 +++++++++++++++++-----------
2 files changed, 23 insertions(+), 11 deletions(-)
diff --git a/NEWS.org b/NEWS.org
index cfc5222bc4..8466c491b1 100644
--- a/NEWS.org
+++ b/NEWS.org
@@ -30,6 +30,12 @@ Follows file specifications in =sweep-mode= buffers.
* New user options available in =sweep= {{{version({{{input-file}}})}}}
+** New user option =sweep-faces-style=
+
+This option controls the which style of faces will be used for
+highlighting in =sweep-mode= buffers. Possible options are =light=, =dark=
+and =default=.
+
** New user option =sweep-indent-offset=
This option, set by default to 4, is an integer denoting the number of
diff --git a/README.org b/README.org
index 84809c85aa..ac655103ad 100644
--- a/README.org
+++ b/README.org
@@ -422,17 +422,23 @@ highlighting can be set via the user option
=sweep= defines more than 60 different faces (named sets of properties
that determine the appearance of a specific text in Emacs buffers, see
also [[info:emacs#Faces][Faces in the Emacs manual]]) to signify the specific
semantics of
-each token in a Prolog code buffer. For example, calls to built in
-Prolog predicates are highlighted with the =sweep-built-in-face=, while
-recursive calls to predicates in their own definitions are assigned
-the =sweep-recursion-face=. The different appearance properties
-associated which each face, like color, font, etc., can be customized
-according to best suite the user's preferences. By default, =sweep=
-defines its faces to inherit from standard Emacs faces such as
-=font-lock-variable-face= commonly used for variables in different
-programming languages, which =sweep= uses a basis for
-=sweep-variable-face=. To view and customize all of the faces defined
-and used in =sweep=, type =M-x customize-group RET sweep-faces RET=.
+each token in a Prolog code buffer. =sweep= comes with three /styles/:
+
+- The =default= style includes faces that mostly inherit from
+standard Emacs faces commonly used in programming modes.
+- The =light= style mimics the colors used in the SWI-Prolog built-in
+ editor.
+- The =light= style mimics the colors used in the SWI-Prolog built-in
+ editor in dark mode.
+
+#+VINDEX: sweep-faces-style
+To choose a style, customize the user option =sweep-faces-style= with
+=M-x customize-option RET sweep-faces-style RET=. The new style will
+apply to all new =sweep-mode= buffers. To apply the new style to an
+existing buffer, use =C-x x f= (=font-lock-update=) in that buffer.
+
+To view and customize all of the faces defined and used in =sweep=, type
+=M-x customize-group RET sweep-faces RET=.
** Definitions and references
:PROPERTIES:
- [nongnu] elpa/sweeprolog 6d1509a06a 090/166: FIXED: sweep-beginning-of-top-term stopping at comment start, (continued)
- [nongnu] elpa/sweeprolog 6d1509a06a 090/166: FIXED: sweep-beginning-of-top-term stopping at comment start, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 9dfbbf9e9b 128/166: ADDED: new user option for choosing indentation increments, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 19d725b869 129/166: New make target: make info, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog a563bc36dc 121/166: FIXED: package-lint complaint about autoloaded private function, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog c94b509fcb 119/166: DOC: Add Top-level history section, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog fc6c2964d9 105/166: ADDED: (sweep-file-at-point): new function, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 1f83ce9f04 088/166: FIXED: use operators from xref in sweep_colourise_some_terms, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 92f599fbbc 094/166: FIXED: premature cut in sweep_predicate_location/2, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 9d87b4d445 131/166: BUILD: rely on preexisting emacs-module.h, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 504d4ff714 136/166: Find Emacs as `emacs`, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 07fc84b716 140/166: DOC: document new user option sweep-faces-style,
ELPA Syncer <=
- [nongnu] elpa/sweeprolog f7dfbda2f2 148/166: Update LICENSE, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog b6e444bbdc 152/166: FIXED: remove message_hook during cleanup to avoid possible crash, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 04964e36b4 143/166: ENHANCED: also update highlighting between sub terms, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 8affae71da 138/166: ADDED: sweep-faces-style user option for controlling highlighting, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 615312796c 048/166: FIXED: copy paste error (singleton variable), ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 37f83755f6 049/166: PORT: detect older swipl and disable custom GMP alloc functions, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 3139de3e6c 056/166: ENHANCED: prompt for buffer name in sweep-top-level with C-u, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog ea43b81c95 058/166: DOC: update manual section about filespec expansion, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 3351766605 103/166: sweep.el: bump Package-Version to 0.2.0, ELPA Syncer, 2022/09/30
- [nongnu] elpa/sweeprolog 5b9e2d7d7c 126/166: ADDED: sweep_op_info/2: new_predicate, ELPA Syncer, 2022/09/30