diff options
| author | Eli Zaretskii | 2023-06-04 10:57:07 +0300 |
|---|---|---|
| committer | Eli Zaretskii | 2023-06-04 10:57:07 +0300 |
| commit | 27fcfa2c0a756bbe94ff0ea6accf12fd45186e5c (patch) | |
| tree | b9bc82a1d132b560a9b222497cb3e997f4c06a2a | |
| parent | 2a84ab905c8009db4d7df7b8f7cfb34c403081c8 (diff) | |
| download | emacs-27fcfa2c0a756bbe94ff0ea6accf12fd45186e5c.tar.gz emacs-27fcfa2c0a756bbe94ff0ea6accf12fd45186e5c.zip | |
; * etc/NEWS: Improve instructions for grammar libraries.
| -rw-r--r-- | etc/NEWS | 18 |
1 files changed, 12 insertions, 6 deletions
| @@ -65,12 +65,13 @@ cloning its Git repository, compile the files "scanner.c" and | |||
| 65 | "parser.c" (sometimes named "scanner.cc" and "parser.cc") in the "src" | 65 | "parser.c" (sometimes named "scanner.cc" and "parser.cc") in the "src" |
| 66 | subdirectory of the library's source tree using the C or C++ compiler, | 66 | subdirectory of the library's source tree using the C or C++ compiler, |
| 67 | then link these two files into a shared library named | 67 | then link these two files into a shared library named |
| 68 | "libtree-sitter-LANG.so", where LANG is the name of the language | 68 | "libtree-sitter-LANG.so" ("libtree-sitter-LANG.dll" on MS-Windows, |
| 69 | supported by the grammar as it is expected by the Emacs major mode | 69 | "libtree-sitter-LANG.dylib" on macOS), where LANG is the name of the |
| 70 | (for example, "c" for 'c-ts-mode', "cpp" for 'c++-ts-mode', "python" | 70 | language supported by the grammar as it is expected by the Emacs major |
| 71 | for 'python-ts-mode', etc.). Then place the shared library you've | 71 | mode (for example, "c" for 'c-ts-mode', "cpp" for 'c++-ts-mode', |
| 72 | built in the same directory where you keep the other shared libraries | 72 | "python" for 'python-ts-mode', etc.). Then place the shared library |
| 73 | used by Emacs, or in the "tree-sitter" subdirectory of your | 73 | you've built in the same directory where you keep the other shared |
| 74 | libraries used by Emacs, or in the "tree-sitter" subdirectory of your | ||
| 74 | 'user-emacs-directory', or in a directory mentioned in the variable | 75 | 'user-emacs-directory', or in a directory mentioned in the variable |
| 75 | 'treesit-extra-load-path'. | 76 | 'treesit-extra-load-path'. |
| 76 | 77 | ||
| @@ -79,6 +80,11 @@ Emacs modes you will use, as Emacs loads these libraries only when the | |||
| 79 | corresponding mode is turned on in some buffer for the first time in | 80 | corresponding mode is turned on in some buffer for the first time in |
| 80 | an Emacs session. | 81 | an Emacs session. |
| 81 | 82 | ||
| 83 | We generally recommend to use the latest versions of grammar libraries | ||
| 84 | available from their sites, as these libraries are in constant | ||
| 85 | development and occasionally add features and fix important bugs to | ||
| 86 | follow the advances in the programming languages they support. | ||
| 87 | |||
| 82 | +++ | 88 | +++ |
| 83 | ** Emacs can be built with built-in support for accessing SQLite databases. | 89 | ** Emacs can be built with built-in support for accessing SQLite databases. |
| 84 | This uses the popular sqlite3 library, and can be disabled by using | 90 | This uses the popular sqlite3 library, and can be disabled by using |