; * etc/NEWS: Improve instructions for grammar libraries.

This commit is contained in:
Eli Zaretskii 2023-06-04 10:57:07 +03:00
parent 2a84ab905c
commit 27fcfa2c0a

View file

@ -65,12 +65,13 @@ cloning its Git repository, compile the files "scanner.c" and
"parser.c" (sometimes named "scanner.cc" and "parser.cc") in the "src" "parser.c" (sometimes named "scanner.cc" and "parser.cc") in the "src"
subdirectory of the library's source tree using the C or C++ compiler, subdirectory of the library's source tree using the C or C++ compiler,
then link these two files into a shared library named then link these two files into a shared library named
"libtree-sitter-LANG.so", where LANG is the name of the language "libtree-sitter-LANG.so" ("libtree-sitter-LANG.dll" on MS-Windows,
supported by the grammar as it is expected by the Emacs major mode "libtree-sitter-LANG.dylib" on macOS), where LANG is the name of the
(for example, "c" for 'c-ts-mode', "cpp" for 'c++-ts-mode', "python" language supported by the grammar as it is expected by the Emacs major
for 'python-ts-mode', etc.). Then place the shared library you've mode (for example, "c" for 'c-ts-mode', "cpp" for 'c++-ts-mode',
built in the same directory where you keep the other shared libraries "python" for 'python-ts-mode', etc.). Then place the shared library
used by Emacs, or in the "tree-sitter" subdirectory of your you've built in the same directory where you keep the other shared
libraries used by Emacs, or in the "tree-sitter" subdirectory of your
'user-emacs-directory', or in a directory mentioned in the variable 'user-emacs-directory', or in a directory mentioned in the variable
'treesit-extra-load-path'. 'treesit-extra-load-path'.
@ -79,6 +80,11 @@ Emacs modes you will use, as Emacs loads these libraries only when the
corresponding mode is turned on in some buffer for the first time in corresponding mode is turned on in some buffer for the first time in
an Emacs session. an Emacs session.
We generally recommend to use the latest versions of grammar libraries
available from their sites, as these libraries are in constant
development and occasionally add features and fix important bugs to
follow the advances in the programming languages they support.
+++ +++
** Emacs can be built with built-in support for accessing SQLite databases. ** Emacs can be built with built-in support for accessing SQLite databases.
This uses the popular sqlite3 library, and can be disabled by using This uses the popular sqlite3 library, and can be disabled by using