aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--etc/NEWS32
1 files changed, 16 insertions, 16 deletions
diff --git a/etc/NEWS b/etc/NEWS
index cded60cca63..017fd850b4e 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -31,12 +31,12 @@ in the Emacs tree should be natively compiled ahead of time. (This is
31slow on most machines.) 31slow on most machines.)
32 32
33+++ 33+++
34** Emacs can be built with the 'tree-sitter' parsing library. 34** Emacs can be built with the tree-sitter parsing library.
35This library, together with grammar libraries, provides incremental 35This library, together with grammar libraries, provides incremental
36parsing capabilities for several popular programming languages and 36parsing capabilities for several popular programming languages and
37other formatted files. Emacs built with this library offers major 37other formatted files. Emacs built with this library offers major
38modes, described elsewhere in this file, that are based on the 38modes, described elsewhere in this file, that are based on the
39'tree-sitter's parsers. If you have the 'tree-sitter' library 39tree-sitter's parsers. If you have the tree-sitter library
40installed, the configure script will automatically include it in the 40installed, the configure script will automatically include it in the
41build; use '--without-tree-sitter' at configure time to disable that. 41build; use '--without-tree-sitter' at configure time to disable that.
42 42
@@ -49,17 +49,17 @@ required by some Emacs major mode, and your distro doesn't provide it
49as an installable package, you can compile and install such a library 49as an installable package, you can compile and install such a library
50yourself. Many libraries can be downloaded from the tree-sitter site: 50yourself. Many libraries can be downloaded from the tree-sitter site:
51 51
52 https://github.com/tree-sitter 52 https://github.com/tree-sitter
53 53
54To compile such a library, compile the files scanner.c and parser.c 54To compile such a library, compile the files "scanner.c" and "parser.c"
55(sometimes named scanner.cc and parser.cc) in the 'src' subdirectory 55(sometimes named "scanner.cc" and "parser.cc") in the "src" subdirectory
56of the library's source tree using the C or C++ compiler, then link 56of the library's source tree using the C or C++ compiler, then link
57these two files into a shared library named 'libtree-sitter-LANG.so', 57these two files into a shared library named "libtree-sitter-LANG.so",
58where LANG is the name of the language supported by the grammar as it 58where LANG is the name of the language supported by the grammar as it
59is expected by the Emacs major mode (for example, "c" for c-ts-mode, 59is expected by the Emacs major mode (for example, "c" for 'c-ts-mode',
60"cpp" for c++-ts-mode, "python" for python-ts-mode, etc.). Then place 60"cpp" for 'c++-ts-mode', "python" for 'python-ts-mode', etc.). Then place
61the shared library you've built in the same directory where you keep 61the shared library you've built in the same directory where you keep
62the other shared libraries used by Emacs, or in the 'tree-sitter' 62the other shared libraries used by Emacs, or in the "tree-sitter"
63subdirectory of your 'user-emacs-directory', or in a directory 63subdirectory of your 'user-emacs-directory', or in a directory
64mentioned in the variable 'treesit-extra-load-path'. 64mentioned in the variable 'treesit-extra-load-path'.
65 65
@@ -3065,13 +3065,13 @@ optional, and you must turn them on manually, or customize
3065'auto-mode-alist' to turn them on automatically. 3065'auto-mode-alist' to turn them on automatically.
3066 3066
3067Each major mode based on tree-sitter needs a language grammar library, 3067Each major mode based on tree-sitter needs a language grammar library,
3068usually named 'libtree-sitter-LANG.so' ('libtree-sitter-LANG.dll' on 3068usually named "libtree-sitter-LANG.so" ("libtree-sitter-LANG.dll" on
3069MS-Windows), where LANG is the corresponding language name. Emacs 3069MS-Windows), where LANG is the corresponding language name. Emacs
3070looks for these libraries in the following places: 3070looks for these libraries in the following places:
3071 3071
3072 . in the directories mentioned in the list 'treesit-extra-load-path' 3072 . in the directories mentioned in the list 'treesit-extra-load-path'
3073 . in the 'tree-sitter' subdirectory of your 'user-emacs-directory' 3073 . in the "tree-sitter" subdirectory of your 'user-emacs-directory'
3074 (by default, '~/.emacs.d/tree-sitter') 3074 (by default, "~/.emacs.d/tree-sitter")
3075 . in the standard system directories where other shared libraries are 3075 . in the standard system directories where other shared libraries are
3076 usually installed 3076 usually installed
3077 3077
@@ -4541,13 +4541,13 @@ needed. The table uses new 'external' completion style exclusively
4541and cannot work with regular styles such as 'basic' or 'flex'. 4541and cannot work with regular styles such as 'basic' or 'flex'.
4542 4542
4543+++ 4543+++
4544** Magic file handlers for make-directory-internal are no longer needed. 4544** Magic file name handlers for 'make-directory-internal' are no longer needed.
4545Instead, Emacs uses the already-existing make-directory handlers. 4545Instead, Emacs uses the already-existing 'make-directory' handlers.
4546 4546
4547+++ 4547+++
4548** (make-directory DIR t) returns non-nil if DIR already exists. 4548** '(make-directory DIR t)' returns non-nil if DIR already exists.
4549This can let a caller know whether it created DIR. Formerly, 4549This can let a caller know whether it created DIR. Formerly,
4550make-directory's return value was unspecified. 4550'make-directory's return value was unspecified.
4551 4551
4552 4552
4553* Changes in Emacs 29.1 on Non-Free Operating Systems 4553* Changes in Emacs 29.1 on Non-Free Operating Systems