diff options
| author | Eli Zaretskii | 2023-09-16 07:36:49 -0400 |
|---|---|---|
| committer | Eli Zaretskii | 2023-09-16 07:36:49 -0400 |
| commit | 302bc23f7cb9fbde7f225650d833e1c09da97338 (patch) | |
| tree | 127047d962b30405980589a95412338f513c1353 /doc | |
| parent | f44c1969b6fae3651ca6cc5e077e5f6430a6b57b (diff) | |
| parent | 755ae813a6adf203d4a602a3e7fc0b9ed547be8c (diff) | |
| download | emacs-302bc23f7cb9fbde7f225650d833e1c09da97338.tar.gz emacs-302bc23f7cb9fbde7f225650d833e1c09da97338.zip | |
Merge from origin/emacs-29
755ae813a6a ; Declare some treesit.c functions in typescript-ts-mode.el.
89fa204b706 Fix loss of encrypted data in plstore.el
d9a1175a611 Close SQL database when corresponding 'sqlite-mode' buffe...
cbd8fac283a Fix Unicode normalization of characters
825be05b379 Support one-time passwords in Tramp
f880b94e649 Fix the 'C' and 'c' categories of characters
58fd212d8a2 Fix Emoji zooming commands
8970cdd009a ; Fix last change.
ba924be4522 ; * etc/DEBUG: Improve the redisplay section.
e110312ad95 ; * doc/lispref/minibuf.texi (Text from Minibuffer): Ment...
65f4810003b tsx-ts-mode--font-lock-compatibility-bb1f97b: Improve
6fe11b88ed0 Avoid using --display in emacsclient to reuse frames on PGTK
2fc7463c0e5 ; * INSTALL: Don't advertise -O3. (Bug#65988)
29055412f2d ; Fix doc string of 'lsh'
738d8543337 Support emacsclient on Windows with server on GNU or Unix...
f0a89fa1d0e ; * lisp/saveplace.el (save-place-ignore-files-regexp): F...
c9cb8ee0fc0 Fix defcustom in saveplace.el (Bug#65977)
5ec8be1d589 ; * lisp/subr.el (string-suffix-p, string-prefix-p): Doc ...
809305e6d8f Fix 'window-text-pixel-size' when there are several image...
ea14b0dcc20 : Doc fix.
01e8a0c6cbf Doc fix for prettify-symbols-unprettify-at-point
0065621d0d3 (report_overlay_modification): Fix bug#65929
6cc6455e931 Fix SVG colors (bug#56182)
9396d73942e * doc/emacs/text.texi (Outline Minor Mode): Add a note ab...
a65d1a5a167 Improve documentation of 'list-abbrevs'
5dcc4b7eab1 Tweak s-p-f for js-ts-mode
1fb2fb501f3 typescript-ts-mode, tsx-ts-mode: Fix syntax properties fo...
946b395e7e1 * lisp/progmodes/c-ts-mode.el (c++-ts-mode): Provide (bug...
33ee3e588fd Fix regression of treesit_cursor_helper_1
d11d81dfcc6 ; Fix doc typos (Bug#65868)
6554ec22465 Update docs for passing of Thien-Thi Nguyen
5ab2792d5c1 Update defvar usage tips example in manual
35d88c657e1 Document using Flymake together with Eglot
3f04efe9e7d ; * src/font.h (struct font): Comment about use of averag...
459b5f6b6d1 ; * admin/authors.el (authors-aliases): Update.
0c029ae8bcb ; tweak etc/TODO item
# Conflicts:
# admin/authors.el
# lisp/subr.el
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/emacs/abbrevs.texi | 15 | ||||
| -rw-r--r-- | doc/emacs/ack.texi | 5 | ||||
| -rw-r--r-- | doc/emacs/custom.texi | 2 | ||||
| -rw-r--r-- | doc/emacs/text.texi | 9 | ||||
| -rw-r--r-- | doc/lispref/compile.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/keymaps.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/minibuf.texi | 4 | ||||
| -rw-r--r-- | doc/lispref/variables.texi | 16 | ||||
| -rw-r--r-- | doc/misc/flymake.texi | 11 | ||||
| -rw-r--r-- | doc/misc/tramp.texi | 6 |
10 files changed, 50 insertions, 22 deletions
diff --git a/doc/emacs/abbrevs.texi b/doc/emacs/abbrevs.texi index 3678377e9b5..6c171d47427 100644 --- a/doc/emacs/abbrevs.texi +++ b/doc/emacs/abbrevs.texi | |||
| @@ -275,6 +275,8 @@ Edit a list of abbrevs; you can add, alter or remove definitions. | |||
| 275 | 275 | ||
| 276 | @example | 276 | @example |
| 277 | @var{various other tables@dots{}} | 277 | @var{various other tables@dots{}} |
| 278 | (python-mode-skeleton-abbrev-table) | ||
| 279 | "class" (sys) 0 "" python-skeleton-class | ||
| 278 | (lisp-mode-abbrev-table) | 280 | (lisp-mode-abbrev-table) |
| 279 | "ks" 0 "keymap-set" | 281 | "ks" 0 "keymap-set" |
| 280 | (global-abbrev-table) | 282 | (global-abbrev-table) |
| @@ -297,11 +299,14 @@ keeps track of this to help you see which abbrevs you actually use, so | |||
| 297 | that you can eliminate those that you don't use often. The string at | 299 | that you can eliminate those that you don't use often. The string at |
| 298 | the end of the line is the expansion. | 300 | the end of the line is the expansion. |
| 299 | 301 | ||
| 300 | Some abbrevs are marked with @samp{(sys)}. These @dfn{system abbrevs} | 302 | Some abbrevs are marked with @samp{(sys)}. These @dfn{system |
| 301 | (@pxref{Abbrevs,,, elisp, The Emacs Lisp Reference Manual}) are | 303 | abbrevs} (@pxref{Abbrevs,,, elisp, The Emacs Lisp Reference Manual}) |
| 302 | pre-defined by various modes, and are not saved to your abbrev file. | 304 | are pre-defined by various modes, and are not saved to your abbrev |
| 303 | To disable a system abbrev, define an abbrev of the same name that | 305 | file. To disable a system abbrev, define an abbrev of the same name |
| 304 | expands to itself, and save it to your abbrev file. | 306 | that expands to itself, and save it to your abbrev file. The system |
| 307 | abbrevs have an associated hook function, which is called to perform | ||
| 308 | the abbrev expansion; the name of that function follows the abbrev | ||
| 309 | expansion in the buffer shown by @code{list-abbrevs}. | ||
| 305 | 310 | ||
| 306 | @findex edit-abbrevs | 311 | @findex edit-abbrevs |
| 307 | @kindex C-c C-c @r{(Edit Abbrevs)} | 312 | @kindex C-c C-c @r{(Edit Abbrevs)} |
diff --git a/doc/emacs/ack.texi b/doc/emacs/ack.texi index b21d1e766ef..483ea3306a3 100644 --- a/doc/emacs/ack.texi +++ b/doc/emacs/ack.texi | |||
| @@ -906,6 +906,11 @@ Thomas Neumann and Eric S. Raymond wrote @file{make-mode.el}, | |||
| 906 | a mode for editing makefiles. | 906 | a mode for editing makefiles. |
| 907 | 907 | ||
| 908 | @item | 908 | @item |
| 909 | Thien-Thi Nguyen wrote the @samp{xpm}, @samp{gnugo}, and | ||
| 910 | @samp{ascii-art-to-unicode} packages. He also made substantial | ||
| 911 | contributions to many others, such as @file{vc.el}. | ||
| 912 | |||
| 913 | @item | ||
| 909 | Thien-Thi Nguyen and Dan Nicolaescu wrote @file{hideshow.el}, a minor | 914 | Thien-Thi Nguyen and Dan Nicolaescu wrote @file{hideshow.el}, a minor |
| 910 | mode for selectively displaying blocks of text. | 915 | mode for selectively displaying blocks of text. |
| 911 | 916 | ||
diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 456e2087217..23dcc44a928 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi | |||
| @@ -626,7 +626,7 @@ button. | |||
| 626 | the theme file and asks if you really want to load it. Because | 626 | the theme file and asks if you really want to load it. Because |
| 627 | loading a Custom theme can execute arbitrary Lisp code, you should | 627 | loading a Custom theme can execute arbitrary Lisp code, you should |
| 628 | only say yes if you know that the theme is safe; in that case, Emacs | 628 | only say yes if you know that the theme is safe; in that case, Emacs |
| 629 | offers to remember in the future that the theme is safe(this is done | 629 | offers to remember in the future that the theme is safe (this is done |
| 630 | by saving the theme file's SHA-256 hash to the variable | 630 | by saving the theme file's SHA-256 hash to the variable |
| 631 | @code{custom-safe-themes}; if you want to treat all themes as safe, | 631 | @code{custom-safe-themes}; if you want to treat all themes as safe, |
| 632 | change its value to @code{t}). Themes that come with Emacs (in the | 632 | change its value to @code{t}). Themes that come with Emacs (in the |
diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi index 3d3f2562617..6f57bae8fef 100644 --- a/doc/emacs/text.texi +++ b/doc/emacs/text.texi | |||
| @@ -1024,10 +1024,11 @@ addition to ellipsis, to show that a section is hidden. Clicking the | |||
| 1024 | mouse on the button toggles display of the section. If the value of | 1024 | mouse on the button toggles display of the section. If the value of |
| 1025 | this variable is @code{insert}, the buttons are inserted directly into | 1025 | this variable is @code{insert}, the buttons are inserted directly into |
| 1026 | the buffer text, so @key{RET} on the button will also toggle display | 1026 | the buffer text, so @key{RET} on the button will also toggle display |
| 1027 | of the section, like a mouse click does. If the value is | 1027 | of the section, like a mouse click does. Using the value @code{insert} |
| 1028 | @code{in-margins}, Outline minor mode will use the window margins to | 1028 | is not recommended in editable buffers because it modifies them. |
| 1029 | indicate that a section is hidden. The buttons are customizable as icons | 1029 | If the value is @code{in-margins}, Outline minor mode will use the |
| 1030 | (@pxref{Icons}). | 1030 | window margins to indicate that a section is hidden. The buttons are |
| 1031 | customizable as icons (@pxref{Icons}). | ||
| 1031 | 1032 | ||
| 1032 | @vindex outline-minor-mode-cycle | 1033 | @vindex outline-minor-mode-cycle |
| 1033 | If the @code{outline-minor-mode-cycle} user option is | 1034 | If the @code{outline-minor-mode-cycle} user option is |
diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi index 0057979778f..5a824649d42 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi | |||
| @@ -422,7 +422,7 @@ execution of the compiled file. For example, | |||
| 422 | @lisp | 422 | @lisp |
| 423 | (eval-when-compile | 423 | (eval-when-compile |
| 424 | (unless (fboundp 'some-new-thing) | 424 | (unless (fboundp 'some-new-thing) |
| 425 | (defmacro 'some-new-thing () | 425 | (defmacro some-new-thing () |
| 426 | (compatibility code)))) | 426 | (compatibility code)))) |
| 427 | @end lisp | 427 | @end lisp |
| 428 | 428 | ||
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi index 99bc10677cd..d4b1c4f2b3e 100644 --- a/doc/lispref/keymaps.texi +++ b/doc/lispref/keymaps.texi | |||
| @@ -90,7 +90,7 @@ Manual}. | |||
| 90 | (kbd "C-x C-f") @result{} "\C-x\C-f" | 90 | (kbd "C-x C-f") @result{} "\C-x\C-f" |
| 91 | (kbd "C-x 4 C-f") @result{} "\C-x4\C-f" | 91 | (kbd "C-x 4 C-f") @result{} "\C-x4\C-f" |
| 92 | (kbd "X") @result{} "X" | 92 | (kbd "X") @result{} "X" |
| 93 | (kbd "RET") @result{} "\^M" | 93 | (kbd "RET") @result{} "^M" |
| 94 | (kbd "C-c SPC") @result{} "\C-c@ " | 94 | (kbd "C-c SPC") @result{} "\C-c@ " |
| 95 | (kbd "<f1> SPC") @result{} [f1 32] | 95 | (kbd "<f1> SPC") @result{} [f1 32] |
| 96 | (kbd "C-M-<down>") @result{} [C-M-down] | 96 | (kbd "C-M-<down>") @result{} [C-M-down] |
diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi index 6cdfe1bd1cb..be4d7e37261 100644 --- a/doc/lispref/minibuf.texi +++ b/doc/lispref/minibuf.texi | |||
| @@ -374,6 +374,7 @@ key, so the text properties are only preserved on the last three | |||
| 374 | characters. | 374 | characters. |
| 375 | @end defvar | 375 | @end defvar |
| 376 | 376 | ||
| 377 | @vindex minibuffer-mode-map | ||
| 377 | @defvar minibuffer-local-map | 378 | @defvar minibuffer-local-map |
| 378 | This | 379 | This |
| 379 | @anchor{Definition of minibuffer-local-map} | 380 | @anchor{Definition of minibuffer-local-map} |
| @@ -414,6 +415,9 @@ default, it makes the following bindings: | |||
| 414 | @code{file-cache-minibuffer-complete} | 415 | @code{file-cache-minibuffer-complete} |
| 415 | @end ignore | 416 | @end ignore |
| 416 | @end table | 417 | @end table |
| 418 | |||
| 419 | @noindent | ||
| 420 | The variable @code{minibuffer-mode-map} is an alias for this variable. | ||
| 417 | @end defvar | 421 | @end defvar |
| 418 | 422 | ||
| 419 | @defun read-no-blanks-input prompt &optional initial inherit-input-method | 423 | @defun read-no-blanks-input prompt &optional initial inherit-input-method |
diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi index 93930d17587..404726e1f92 100644 --- a/doc/lispref/variables.texi +++ b/doc/lispref/variables.texi | |||
| @@ -678,15 +678,15 @@ which are being phased out.) | |||
| 678 | it as safe or risky; see @ref{File Local Variables}. | 678 | it as safe or risky; see @ref{File Local Variables}. |
| 679 | 679 | ||
| 680 | When defining and initializing a variable that holds a complicated | 680 | When defining and initializing a variable that holds a complicated |
| 681 | value (such as a keymap with bindings in it), it's best to put the | 681 | value (such as a syntax table for a major mode), it's best to put the |
| 682 | entire computation of the value into the @code{defvar}, like this: | 682 | entire computation of the value into the @code{defvar}, like this: |
| 683 | 683 | ||
| 684 | @example | 684 | @example |
| 685 | (defvar my-mode-map | 685 | (defvar my-major-mode-syntax-table |
| 686 | (let ((map (make-sparse-keymap))) | 686 | (let ((table (make-syntax-table))) |
| 687 | (keymap-set map "C-c C-a" 'my-command) | 687 | (modify-syntax-entry ?# "<" table) |
| 688 | @dots{} | 688 | @dots{} |
| 689 | map) | 689 | table) |
| 690 | @var{docstring}) | 690 | @var{docstring}) |
| 691 | @end example | 691 | @end example |
| 692 | 692 | ||
| @@ -696,9 +696,9 @@ loading the file, the variable is either still uninitialized or | |||
| 696 | initialized properly, never in-between. If it is still uninitialized, | 696 | initialized properly, never in-between. If it is still uninitialized, |
| 697 | reloading the file will initialize it properly. Second, reloading the | 697 | reloading the file will initialize it properly. Second, reloading the |
| 698 | file once the variable is initialized will not alter it; that is | 698 | file once the variable is initialized will not alter it; that is |
| 699 | important if the user has run hooks to alter part of the contents | 699 | important if the user has changed its value. Third, evaluating the |
| 700 | (such as, to rebind keys). Third, evaluating the @code{defvar} form | 700 | @code{defvar} form with @kbd{C-M-x} will reinitialize the variable |
| 701 | with @kbd{C-M-x} will reinitialize the map completely. | 701 | completely. |
| 702 | 702 | ||
| 703 | @node Accessing Variables | 703 | @node Accessing Variables |
| 704 | @section Accessing Variable Values | 704 | @section Accessing Variable Values |
diff --git a/doc/misc/flymake.texi b/doc/misc/flymake.texi index 237f0702778..e68692afb10 100644 --- a/doc/misc/flymake.texi +++ b/doc/misc/flymake.texi | |||
| @@ -59,8 +59,11 @@ types of diagnostics. | |||
| 59 | 59 | ||
| 60 | To learn about using Flymake, @pxref{Using Flymake}. | 60 | To learn about using Flymake, @pxref{Using Flymake}. |
| 61 | 61 | ||
| 62 | Flymake is designed to be easily extended to support new backends via | 62 | When the Emacs LSP support mode Eglot is enabled, Flymake will use |
| 63 | an Elisp interface. @xref{Extending Flymake}. | 63 | that as an additional back-end. @xref{Eglot Features,,, eglot, Eglot: |
| 64 | The Emacs LSP Client} Flymake is also designed to be easily extended | ||
| 65 | to support new backends via an Elisp interface. @xref{Extending | ||
| 66 | Flymake}. | ||
| 64 | 67 | ||
| 65 | Historically, Flymake used to accept diagnostics from a single | 68 | Historically, Flymake used to accept diagnostics from a single |
| 66 | backend. Although obsolete, it is still functional. To learn how to | 69 | backend. Although obsolete, it is still functional. To learn how to |
| @@ -93,6 +96,10 @@ already setup this hook for you, by adding @dfn{backend functions} to | |||
| 93 | @code{flymake-diagnostic-functions}. If you know Elisp you may also | 96 | @code{flymake-diagnostic-functions}. If you know Elisp you may also |
| 94 | write your own Flymake backend functions. @xref{Backend functions}. | 97 | write your own Flymake backend functions. @xref{Backend functions}. |
| 95 | 98 | ||
| 99 | When the Emacs LSP support mode Eglot is enabled, Flymake will use | ||
| 100 | that as an additional back-end automatically. @xref{Eglot Features,,, | ||
| 101 | eglot, Eglot: The Emacs LSP Client} | ||
| 102 | |||
| 96 | @menu | 103 | @menu |
| 97 | * Starting Flymake:: | 104 | * Starting Flymake:: |
| 98 | * Finding diagnostics:: | 105 | * Finding diagnostics:: |
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index ea3bf8570b7..56d5fcd4bf0 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi | |||
| @@ -2436,8 +2436,10 @@ which may not be the same as the local login shell prompt, | |||
| 2436 | @value{tramp} sets a similar default value for both prompts. | 2436 | @value{tramp} sets a similar default value for both prompts. |
| 2437 | 2437 | ||
| 2438 | @item @code{tramp-password-prompt-regexp} | 2438 | @item @code{tramp-password-prompt-regexp} |
| 2439 | @item @code{tramp-otp-password-prompt-regexp} | ||
| 2439 | @item @code{tramp-wrong-passwd-regexp} | 2440 | @item @code{tramp-wrong-passwd-regexp} |
| 2440 | @vindex tramp-password-prompt-regexp | 2441 | @vindex tramp-password-prompt-regexp |
| 2442 | @vindex tramp-otp-password-prompt-regexp | ||
| 2441 | @vindex tramp-wrong-passwd-regexp | 2443 | @vindex tramp-wrong-passwd-regexp |
| 2442 | 2444 | ||
| 2443 | @value{tramp} uses @code{tramp-password-prompt-regexp} to | 2445 | @value{tramp} uses @code{tramp-password-prompt-regexp} to |
| @@ -2471,6 +2473,10 @@ This user option is, by default, initialized from | |||
| 2471 | is usually more convenient to add new passphrases to that user option | 2473 | is usually more convenient to add new passphrases to that user option |
| 2472 | instead of altering this user option. | 2474 | instead of altering this user option. |
| 2473 | 2475 | ||
| 2476 | The user option @code{tramp-otp-password-prompt-regexp} has a similar | ||
| 2477 | purpose, but for one-time passwords. Those passwords are not cached | ||
| 2478 | by @value{tramp} for reuse. | ||
| 2479 | |||
| 2474 | Similar localization may be necessary for handling wrong password | 2480 | Similar localization may be necessary for handling wrong password |
| 2475 | prompts, for which @value{tramp} uses @code{tramp-wrong-passwd-regexp}. | 2481 | prompts, for which @value{tramp} uses @code{tramp-wrong-passwd-regexp}. |
| 2476 | 2482 | ||