Skip to content

Commit

Permalink
racket-hash-lang-mode: Improve doc strings
Browse files Browse the repository at this point in the history
Delete reference to obsolete customization variable.

Improve prose.
  • Loading branch information
greghendershott committed Dec 19, 2023
1 parent e6c2906 commit 8bb83cf
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 24 deletions.
23 changes: 11 additions & 12 deletions doc/racket-mode.texi
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand Down
23 changes: 11 additions & 12 deletions racket-hash-lang.el
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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)
Expand Down Expand Up @@ -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)
Expand Down

0 comments on commit 8bb83cf

Please sign in to comment.