mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-15 10:30:25 -08:00
Code Issues Projects Releases Wiki Activity

; Mention LSP semantic highlighting in the Emacs manual

Browse source 
* doc/emacs/display.texi (Semantic Font Lock): Mention
LSP-based semantic highlighting, refer to the Eglot manual.
This commit is contained in:
Eshel Yaron 2025-11-18 16:08:05 +01:00
parent 0026445dd6
commit ce5d8ddb32
No known key found for this signature in database
GPG key ID: EF3EE9CA35D78618
1 changed files with 16 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

27
doc/emacs/display.texi
View file

@ -1234,18 +1234,23 @@ occur, such as Lisp and Prolog. In such languages, syntactic analysis
alone misses a lot of important information that coders need to reason
about their programs.
@vindex elisp-fontify-semantically
Emacs implements semantic highlighting for Emacs Lisp as an optional
feature of @code{emacs-lisp-mode} (@pxref{Executing Lisp}). To enable
it, customize the option @code{elisp-fontify-semantically} to a
non-@code{nil} value.
Some language servers provide semantic highlighting information, which
Emacs can leverage via its LSP client, Eglot. @xref{Eglot Features,,,
eglot, Eglot: The Emacs LSP Client}.
When this option is enabled, @code{emacs-lisp-mode} analyzes your code
and highlights symbols according to their semantic roles, as part of the
mode's usual Font Lock highlighting (@pxref{Font Lock}). It doesn't
affect the highlighting of strings, comments and other syntactic
elements such as brackets; @code{elisp-fontify-semantically} only
affects highlighting of symbols.
@vindex elisp-fontify-semantically
Additionally, Emacs implements semantic highlighting for Emacs Lisp as
an optional feature of @code{emacs-lisp-mode} (@pxref{Executing Lisp}).
To enable it, customize the option @code{elisp-fontify-semantically} to
a non-@code{nil} value. The rest of this subsection describes the use
of this Emacs Lisp-specific semantic highlighting support.
When @code{elisp-fontify-semantically} is enabled,
@code{emacs-lisp-mode} analyzes your code and highlights symbols
according to their semantic roles, as part of the mode's usual Font Lock
highlighting (@pxref{Font Lock}). It doesn't affect the highlighting of
strings, comments and other syntactic elements such as brackets;
@code{elisp-fontify-semantically} only affects highlighting of symbols.
@cindex symbol role, in semantic analysis
The semantic analysis assigns to each symbol a @dfn{symbol role}, such