; Improve documentation of 'native-comp-enable-subr-trampolines'

* doc/lispref/compile.texi (Native-Compilation Variables):
Document the interpretation of non-absolute directory names that
are the value of 'native-comp-enable-subr-trampolines'.
This commit is contained in:
Eli Zaretskii 2023-02-19 11:04:57 +02:00
parent c61a30e160
commit cd05fca5f7
2 changed files with 15 additions and 8 deletions

View file

@ -1120,16 +1120,18 @@ the trampoline generation, unless you know that all the trampolines
needed by your Lisp programs are already compiled and accessible to needed by your Lisp programs are already compiled and accessible to
Emacs. Emacs.
The value of this variable can also be a string, in which case it is The value of this variable can also be a string, in which case it
interpreted as the name of a directory in which to store the generated specifies the name of a directory in which to store the generated
trampoline @file{*.eln} files, overriding the directories specified by trampoline @file{*.eln} files, overriding the directories in
@code{native-comp-eln-load-path}. This is useful if you want the @code{native-comp-eln-load-path}. This is useful if you want the
trampolines to be generated as needed, but don't want to store them trampolines to be generated as needed, but don't want to store them
under the user's @env{HOME} directory or the other public directories under the user's @env{HOME} directory or in the other public
where @file{*.eln} files are kept. However, unlike with directories directories where @file{*.eln} files are kept. However, unlike with
in @code{native-comp-eln-load-path}, the trampolines will be stored in directories in @code{native-comp-eln-load-path}, the trampolines will
the directory given by the value of this variable, not in its be stored in the directory given by the value of this variable, not in
version-specific subdirectory. its version-specific subdirectory. If the name of this directory is
not absolute, it is interpreted relative to
@code{invocation-directory} (@pxref{System Environment})
If this variable is non-@code{nil}, and Emacs needs to produce a If this variable is non-@code{nil}, and Emacs needs to produce a
trampoline, but it cannot find any writable directory to store the trampoline, but it cannot find any writable directory to store the

View file

@ -1204,6 +1204,11 @@ See `treesit-simple-indent-presets'.")
(cons 'grand-parent (cons 'grand-parent
(lambda (_n parent &rest _) (lambda (_n parent &rest _)
(treesit-node-start (treesit-node-parent parent)))) (treesit-node-start (treesit-node-parent parent))))
(cons 'great-grand-parent
(lambda (_n parent &rest _)
(treesit-node-start
(treesit-node-parent
(treesit-node-parent parent)))))
(cons 'parent-bol (lambda (_n parent &rest _) (cons 'parent-bol (lambda (_n parent &rest _)
(save-excursion (save-excursion
(goto-char (treesit-node-start parent)) (goto-char (treesit-node-start parent))