[nongnu] elpa/racket-mode 8bb83cf12e: racket-hash-lang-mode: Improve doc strings

[ELPA Syncer]

branch: elpa/racket-mode
commit 8bb83cf12ebf04d1ed3ecf2d5b46974b37976020
Author: Greg Hendershott <git@greghendershott.com>
Commit: Greg Hendershott <git@greghendershott.com>

    racket-hash-lang-mode: Improve doc strings
    
    Delete reference to obsolete customization variable.
    
    Improve prose.
---
 doc/racket-mode.texi | 23 +++++++++++------------
 racket-hash-lang.el  | 23 +++++++++++------------
 2 files changed, 22 insertions(+), 24 deletions(-)

diff --git a/doc/racket-mode.texi b/doc/racket-mode.texi
index 57e6ea5c65..48ed337cec 100644
--- a/doc/racket-mode.texi
+++ b/doc/racket-mode.texi
@@ -1558,19 +1558,16 @@ In your Emacs configuration, you may want to update the
 variable @code{auto-mode-alist} to use @ref{racket-hash-lang-mode} for
 file extensions like ``.rkt'', ``.scrbl'', and/or ``.rhm''.
 
-See also the customization variable
-@ref{racket-hash-lang-token-face-alist} and the hook variable
-@ref{racket-hash-lang-module-language-hook}.
+Languages supply colors for lexer tokens like strings and
+comments; see the customization variable
+@ref{racket-hash-lang-token-face-alist}. For more colors see the hook
+variable @ref{racket-hash-lang-module-language-hook}, which can also
+be used to vary configurations per language.
 
 A discussion of the information provided by a Racket language:
 
 @uref{https://docs.racket-lang.org/tools/lang-languages-customization.html}
 
-Note that langs supply colors only for lexer tokens like strings
-and comments. If you enable the minor mode @ref{racket-xp-mode}, it
-can contribute more colors; see the customization variable
-@code{nil}.
-
 @multitable {aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa} 
{aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa}
 @item Key
 @tab Binding
@@ -3257,8 +3254,8 @@ of these modes, and instead just use the simple delimiter
 matching built into @ref{racket-hash-lang-mode}; see
 @ref{racket-hash-lang-pairs}.
 
-As another example, if you prefer richer font-lock than just
-tokens, choices include:
+As another example, if you prefer more colors than just tokens,
+choices include:
 
 @itemize
 @item
@@ -3271,10 +3268,12 @@ the module language hook locally set
   (setq-local racket-xp-add-binding-faces t)
 @end lisp
 
+OR
+
 @itemize
 @item
-Or, use some of the regexp search-based fontification from
-classic @ref{racket-mode} for rackety module languages:
+Use some of the regexp search-based fontification from classic
+@ref{racket-mode} for rackety module languages:
 @end itemize
 
 @lisp
diff --git a/racket-hash-lang.el b/racket-hash-lang.el
index 0e9a5d79b3..9113947b00 100644
--- a/racket-hash-lang.el
+++ b/racket-hash-lang.el
@@ -148,8 +148,8 @@ of these modes, and instead just use the simple delimiter
 matching built into `racket-hash-lang-mode'; see
 `racket-hash-lang-pairs'.
 
-As another example, if you prefer richer font-lock than just
-tokens, choices include:
+As another example, if you prefer more colors than just tokens,
+choices include:
 
 - Enable `racket-xp-mode' in `racket-hash-lang-mode-hook' and in
   the module language hook locally set
@@ -159,8 +159,10 @@ tokens, choices include:
   (setq-local racket-xp-add-binding-faces t)
 #+END_SRC
 
-- Or, use some of the regexp search-based fontification from
-  classic `racket-mode' for rackety module languages:
+  OR
+
+- Use some of the regexp search-based fontification from classic
+  `racket-mode' for rackety module languages:
 
 #+BEGIN_SRC elisp
   (require \\='racket-font-lock)
@@ -206,19 +208,16 @@ In your Emacs configuration, you may want to update the
 variable `auto-mode-alist' to use `racket-hash-lang-mode' for
 file extensions like \".rkt\", \".scrbl\", and/or \".rhm\".
 
-See also the customization variable
-`racket-hash-lang-token-face-alist' and the hook variable
-`racket-hash-lang-module-language-hook'.
+Languages supply colors for lexer tokens like strings and
+comments; see the customization variable
+`racket-hash-lang-token-face-alist'. For more colors see the hook
+variable `racket-hash-lang-module-language-hook', which can also
+be used to vary configurations per language.
 
 A discussion of the information provided by a Racket language:
 
   <https://docs.racket-lang.org/tools/lang-languages-customization.html>
 
-Note that langs supply colors only for lexer tokens like strings
-and comments. If you enable the minor mode `racket-xp-mode', it
-can contribute more colors; see the customization variable
-`racket-xp-binding-font-lock-face-modes'.
-
 \\{racket-hash-lang-mode-map}
 "
   (racket-call-racket-repl-buffer-name-function)