branch: externals/substitute
commit a708398645f971ca507fe29fdf96d7dde642f7b9
Author: Protesilaos Stavrou <[email protected]>
Commit: Protesilaos Stavrou <[email protected]>

    Update the backronym and the README.md
---
 README.md  | 17 +++++++++--------
 README.org |  3 +--
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 14ce1891e8..07a5bb3087 100644
--- a/README.md
+++ b/README.md
@@ -5,14 +5,16 @@ Efficiently replace targets in the buffer or context.
 Substitute is a set of commands that perform text replacement (i)
 throughout the buffer, (ii) limited to the current definition (per
 `narrow-to-defun`), (iii) from point to the end of the buffer, and
-(iv) from point to the beginning of the buffer.
+(iv) from point to the beginning of the buffer. Variations of these
+scopes are also available.
 
 These substitutions are meant to be as quick as possible and, as such,
-differ from the standard `query-replace` (which I still use).  The
-provided commands prompt for substitute text and perform the
-substitution outright.
-
-**Video demo:** 
<https://protesilaos.com/codelog/2023-01-16-emacs-substitute-package-demo/>
+differ from the standard `query-replace` (which I still use when
+necessary). The provided commands prompt for substitute text and
+perform the substitution outright, without moving the point. The
+target is the symbol/word at point or the text corresponding to the
+currently marked region. All matches in the given scope are
+highlighted by default.
 
 + Package name (GNU ELPA): `substitute`
 + Official manual: <https://protesilaos.com/emacs/substitute>
@@ -20,5 +22,4 @@ substitution outright.
   + GitHub: <https://github.com/protesilaos/substitute>
   + GitLab: <https://gitlab.com/protesilaos/substitute>
 + Video demo: 
<https://protesilaos.com/codelog/2023-01-16-emacs-substitute-package-demo/>
-+ Backronym: Some Utilities Built to Substitute Targets Independent of
-  Their Utterances, Thoroughly and Easily.
++ Backronym: Substitutions Uniformly Beget Standardisation for Text Invariably 
Transfigured Unto This Entry.
diff --git a/README.org b/README.org
index 506242ddfe..5569fc5b90 100644
--- a/README.org
+++ b/README.org
@@ -37,8 +37,7 @@ Current development target is {{{development-version}}}.
   + GitHub: <https://github.com/protesilaos/substitute>
   + GitLab: <https://gitlab.com/protesilaos/substitute>
 + Video demo: 
<https://protesilaos.com/codelog/2023-01-16-emacs-substitute-package-demo/>
-+ Backronym: Some Utilities Built to Substitute Targets Independent of
-  Their Utterances, Thoroughly and Easily.
++ Backronym: Substitutions Uniformly Beget Standardisation for Text Invariably 
Transfigured Unto This Entry.
 
 If you are viewing the README.org version of this file, please note that
 the GNU ELPA machinery automatically generates an Info manual out of it.

Reply via email to