emacs-elpa-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[elpa] externals/relint c58a905 2/2: README copy-editing


From: ELPA Syncer
Subject: [elpa] externals/relint c58a905 2/2: README copy-editing
Date: Mon, 26 Apr 2021 09:57:22 -0400 (EDT)

branch: externals/relint
commit c58a9053019cf5285f008e6954643b4760bba2a0
Author: Mattias EngdegÄrd <mattiase@acm.org>
Commit: Mattias EngdegÄrd <mattiase@acm.org>

    README copy-editing
    
    Recommend `xr-pp`, not `xr-lint`, for clarifying string regexps.
    Say 'Emacs Lisp' instead of 'elisp'.
---
 README | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/README b/README
index 5a987a2..80500ad 100644
--- a/README
+++ b/README
@@ -1,10 +1,10 @@
                 relint -- Emacs regexp mistake finder
                 =====================================
 
-Relint scans elisp files for mistakes in regexps, including deprecated
-syntax and bad practice. It also checks the regexp-like arguments to
-skip-chars-forward, skip-chars-backward, skip-syntax-forward and
-skip-syntax-backward.
+Relint scans Emacs Lisp files for mistakes in regexps, including
+deprecated syntax and bad practice. It also checks the regexp-like
+arguments to the functions skip-chars-forward, skip-chars-backward,
+skip-syntax-forward and skip-syntax-backward.
 
 * Contents
 
@@ -40,7 +40,7 @@ skip-syntax-backward.
 
     In the *relint* buffer, pressing "g" will re-run the same check.
 
-  - From elisp code, use one of the above functions or
+  - From Emacs Lisp code, use one of the above functions or
 
       (relint-buffer BUFFER)
 
@@ -60,7 +60,7 @@ skip-syntax-backward.
 * What the diagnostics mean
 
   Tip: if a regexp string is difficult to understand, consider
-  decoding it using 'xr', as in (xr-lint "gibberish").
+  using 'xr' to decode it, as in (xr-pp "your-messy-regexp").
 
   - Unescaped literal 'X'
 
@@ -346,9 +346,9 @@ skip-syntax-backward.
 
   Relint uses a combination of ad-hoc rules to locate regexps:
 
-  - Arguments to standard functions taking regexps as arguments,
-    such as re-search-forward, or to user-defined functions
-    whose arguments have regexp-sounding names (like 'regexp')
+  - Arguments to certain standard functions such as re-search-forward,
+    or to user-defined functions whose arguments have regexp-sounding
+    names (like 'regexp')
 
   - Values of variables believed to be a regexp from their name
     (ending in '-regexp', for instance), from their doc string,
@@ -357,8 +357,8 @@ skip-syntax-backward.
   - Assignment to certain standard variables, such as page-delimiter
 
   It will then try to evaluate expressions statically as far as
-  possible, to arrive at strings which can be analysed. The regexp
-  analysis is done by the xr library.
+  possible in order to arrive at strings which can be analysed. The
+  regexp analysis is done by the xr library.
 
   This means that if relint complains about something that isn't
   actually a regexp, some names in your code may be misleading.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]