diff options
| -rw-r--r-- | etc/NEWS | 32 |
1 files changed, 16 insertions, 16 deletions
| @@ -31,12 +31,12 @@ in the Emacs tree should be natively compiled ahead of time. (This is | |||
| 31 | slow on most machines.) | 31 | slow 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. |
| 35 | This library, together with grammar libraries, provides incremental | 35 | This library, together with grammar libraries, provides incremental |
| 36 | parsing capabilities for several popular programming languages and | 36 | parsing capabilities for several popular programming languages and |
| 37 | other formatted files. Emacs built with this library offers major | 37 | other formatted files. Emacs built with this library offers major |
| 38 | modes, described elsewhere in this file, that are based on the | 38 | modes, described elsewhere in this file, that are based on the |
| 39 | 'tree-sitter's parsers. If you have the 'tree-sitter' library | 39 | tree-sitter's parsers. If you have the tree-sitter library |
| 40 | installed, the configure script will automatically include it in the | 40 | installed, the configure script will automatically include it in the |
| 41 | build; use '--without-tree-sitter' at configure time to disable that. | 41 | build; 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 | |||
| 49 | as an installable package, you can compile and install such a library | 49 | as an installable package, you can compile and install such a library |
| 50 | yourself. Many libraries can be downloaded from the tree-sitter site: | 50 | yourself. 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 | ||
| 54 | To compile such a library, compile the files scanner.c and parser.c | 54 | To 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 |
| 56 | of the library's source tree using the C or C++ compiler, then link | 56 | of the library's source tree using the C or C++ compiler, then link |
| 57 | these two files into a shared library named 'libtree-sitter-LANG.so', | 57 | these two files into a shared library named "libtree-sitter-LANG.so", |
| 58 | where LANG is the name of the language supported by the grammar as it | 58 | where LANG is the name of the language supported by the grammar as it |
| 59 | is expected by the Emacs major mode (for example, "c" for c-ts-mode, | 59 | is 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 |
| 61 | the shared library you've built in the same directory where you keep | 61 | the shared library you've built in the same directory where you keep |
| 62 | the other shared libraries used by Emacs, or in the 'tree-sitter' | 62 | the other shared libraries used by Emacs, or in the "tree-sitter" |
| 63 | subdirectory of your 'user-emacs-directory', or in a directory | 63 | subdirectory of your 'user-emacs-directory', or in a directory |
| 64 | mentioned in the variable 'treesit-extra-load-path'. | 64 | mentioned 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 | ||
| 3067 | Each major mode based on tree-sitter needs a language grammar library, | 3067 | Each major mode based on tree-sitter needs a language grammar library, |
| 3068 | usually named 'libtree-sitter-LANG.so' ('libtree-sitter-LANG.dll' on | 3068 | usually named "libtree-sitter-LANG.so" ("libtree-sitter-LANG.dll" on |
| 3069 | MS-Windows), where LANG is the corresponding language name. Emacs | 3069 | MS-Windows), where LANG is the corresponding language name. Emacs |
| 3070 | looks for these libraries in the following places: | 3070 | looks 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 | |||
| 4541 | and cannot work with regular styles such as 'basic' or 'flex'. | 4541 | and 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. |
| 4545 | Instead, Emacs uses the already-existing make-directory handlers. | 4545 | Instead, 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. |
| 4549 | This can let a caller know whether it created DIR. Formerly, | 4549 | This can let a caller know whether it created DIR. Formerly, |
| 4550 | make-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 |