Commit graph

11188 commits

Author SHA1 Message Date
Eli Zaretskii
f149de223b Merge branch 'emacs-29' of git.savannah.gnu.org:/srv/git/emacs into emacs-29 2024-01-13 20:40:35 +02:00
Eli Zaretskii
1f97a87879 Fix info-xref-tests
* doc/lispintro/emacs-lisp-intro.texi (How let Binds Variables):
Fix cross-reference.  (Bug#68428)

* test/lisp/info-xref-tests.el (info-xref-test-write-file): Fix
test on MS-Windows when run from MSYS Bash.
2024-01-13 20:38:34 +02:00
Juri Linkov
51f391998b Add @kindex in manuals for existing keybindings on 'C-x x/w' (bug#13167)
* doc/emacs/buffers.texi (Misc Buffer): Add @kindex for 'C-x x r',
'C-x x u', 'C-x x i'.

* doc/emacs/display.texi (Line Truncation): Add @kindex for 'C-x x t'.

* doc/emacs/files.texi (Reverting): Add @kindex for 'C-x x g'.

* doc/emacs/windows.texi (Change Window): Use new keybinding 'C-x w 0'
instead of 'M-x delete-windows-on'.

* doc/misc/info.texi (Create Info buffer): Add @kindex for 'C-x x n'.
2024-01-13 20:11:21 +02:00
Eli Zaretskii
c494a6e879 Improve documentation of 'emacs_function' in modules
* doc/lispref/internals.texi (Module Functions): Warn about
accessing the ARGS array in module functions.
2024-01-13 12:01:47 +02:00
Eli Zaretskii
a08e6423cc ; * doc/emacs/fixit.texi (Spelling): Fix last change. 2024-01-13 11:23:43 +02:00
Eli Zaretskii
418547162d Improve documentation of Ispell commands
* doc/emacs/fixit.texi (Spelling): Document "C-u M-$" and warn
against modifications in recursive-edit.  (Bug#14192)
2024-01-12 10:03:08 +02:00
Xiyue Deng
26eb9d3a8a Fix typo in lispref "Creating Strings" section
* doc/lispref/strings.texi (String Basics): Fix typo (bug#68375).
2024-01-11 15:18:37 +01:00
Xiyue Deng
99efe5c80f Fix count of no-op functions (bug#68375)
It looks like there are actually three kinds of no-op functions.

* doc/lispref/functions.texi (Calling Functions): Fix count and
plural of no-op functions.

Copyright-paperwork-exempt: yes
2024-01-11 12:39:43 +02:00
Xiyue Deng
0c01f97b73 Wrap @pxref of Abbrevs in parentheses (bug#68375)
* doc/lispref/symbols.texi (Shorthands): Wrap `@pxref{Abbrevs}' in
parentheses.

Copyright-paperwork-exempt: yes
2024-01-11 12:36:31 +02:00
Eli Zaretskii
70a09325d6 ; Fix last change in widget.texi
* doc/misc/widget.texi (url-link, toggle, Defining New Widgets):
Divide @example's into @group's.  (Bug#66229)
2024-01-11 08:22:14 +02:00
Stefan Kangas
63411709a8 ; Fix typos 2024-01-11 00:32:15 +01:00
Mauro Aranda
4fadbfe300 Add examples to the Widget manual
* doc/misc/widget.texi (Widget Gallery, Defining New Widgets): Add
examples.  (Bug#66229)
2024-01-10 22:28:01 +01:00
Jim Porter
d58d0fa52f Introduce 'let' using lexical binding in the Lisp Introduction
* doc/lispintro/emacs-lisp-intro.texi (Prevent confusion): Rework the
explanation to discuss how things work under lexical binding.
(How let Binds Variables): Describe the differences between lexical
and dynamic binding (including how to configure it).
(defvar): Mention that 'defvar' declares variables as always
dynamically-bound (bug#66756).
2024-01-09 10:31:06 -08:00
Jean-Christophe Helary
2a8c00bfc0 * doc/emacs/back.texi: Fix a typo. 2024-01-06 18:51:22 +02:00
Eli Zaretskii
bf7034048c ; * doc/emacs/custom.texi (Changing a Variable): Update example (bug#68279). 2024-01-06 13:45:33 +02:00
Eli Zaretskii
2a861124e8 ; Improve documentation of 'buffer-match-p'
* doc/lispref/buffers.texi (Buffer List):
* doc/lispref/windows.texi (Choosing Window): Add caveats for
calling 'buffer-match-p' too early, when CONDITION is
'derived-mode' or 'major-mode'.  (Bug#68081)
2024-01-06 11:15:31 +02:00
Eli Zaretskii
a2a6619b28 Provide decent documentation for 'help-quick'
* lisp/help.el (help-quick, help-quick-toggle): Doc fix.

* doc/emacs/help.texi (Help Summary, Misc Help): Document
'help-quick-toggle'.
2024-01-04 10:17:30 +02:00
Po Lu
8e1c56ae46 ; Add 2024 to copyright years 2024-01-02 09:47:10 +08:00
Kyle Meyer
7591acfe38 Update to Org 9.6.15 2024-01-01 12:47:27 -05:00
Eli Zaretskii
01be4fe39d * doc/emacs/custom.texi (Modifier Keys): Fix markup (bug#68164).
Suggested by Jens Quade <jq@qdevelop.de>.
2023-12-31 09:44:32 +02:00
Yuan Fu
5303152872
Revert "Fix treesit-node-field-name and friends (bug#66674)"
This reverts commit 9874561f39.

See bug#67990.  Basically our original code is correct, the error is
in libtree-sitter, which only manifests in certain cases.

https://github.com/tree-sitter/tree-sitter/pull/2104
2023-12-29 19:52:07 -08:00
Stefan Kangas
44517037ae ; Fix typo 2023-12-26 22:09:57 +01:00
Eli Zaretskii
03dc914fd3 ; Fix footnotes in ELisp Intro manual 2023-12-24 10:46:04 +02:00
Xiyue Deng
ceacf75395 Fix usage of `setq-default' and offer more suggestions
cd61af0 changed from default-major-mode to major-mode in the first
code sample but didn't change the rest.  This patch fixes this and add
some explanations of why use `setq-default' instead of `setq'.  In
addition, it gives background on suggesting using text-mode as default
mode and suggest other alternatives.

* doc/lispintro/emacs-lisp-intro.texi (Text and Auto-fill): Fix usage
of `setq-default' and offer more suggestions.  (Bug#67848)
2023-12-24 10:38:46 +02:00
Michael Albinus
a475165738 * doc/man/emacsclient.1: Fix --tramp option. 2023-12-23 12:04:37 +01:00
Peter Oliver
1e5357d3d1 * doc/man/emacsclient.1: Add missing sections (bug#66598)
Copyright-paperwork-exempt: yes
2023-12-23 11:45:22 +02:00
Xiyue Deng
fba7b9db39 Add explanation for extra parentheses in ELisp Introduction
* doc/lispintro/emacs-lisp-intro.texi (fwd-para while): Add
a note to explain the extra parentheses.  (Bug#67820)
2023-12-23 11:35:33 +02:00
Xiyue Deng
7723282682 Add sample code to the "let*" section in "forward-paragraph"
* doc/lispintro/emacs-lisp-intro.texi (fwd-para let): Add code
sample.  (Bug#67817)
2023-12-23 10:48:06 +02:00
Stefan Kangas
d386a8aa43 Recommend customizing eglot for python-base-mode
* doc/misc/eglot.texi (Project-specific configuration): Recommend
setting directory local variables for 'python-base-mode' instead of
'python-mode'.  This makes any customizations effective also for
'python-ts-mode'.
2023-12-22 22:39:55 +01:00
Eli Zaretskii
bd0c758971 Improve documentation of new native-compilation commands
* lisp/progmodes/elisp-mode.el (emacs-lisp-mode-menu)
(emacs-lisp-native-compile, emacs-lisp-native-compile-and-load):
Doc fixes.

* doc/lispref/compile.texi (Native-Compilation Functions):
Document 'emacs-lisp-native-compile' and
'emacs-lisp-native-compile-and-load'.
2023-12-22 16:49:49 +02:00
Stefan Monnier
77678244b8 doc/lispintro: Don't mention set (bug#67734)
* doc/lispintro/emacs-lisp-intro.texi (Using set): Delete.
(Using setq): Adjust accordingly.
(setq): Rename from "set & setq" and don't refer to `set` any more.
(Review): Don't mention `set` any more.
2023-12-21 10:24:29 -05:00
Eli Zaretskii
f68f350023 Improve documentation of text properties handling when yanking
* doc/lispref/text.texi (Text Properties): Mention special
handling of text properties while yanking.
2023-12-16 21:21:33 +02:00
Eli Zaretskii
0d9e2e448d ; * doc/lispref/functions.texi (Function Documentation): Fix @itemize. 2023-12-16 16:06:29 +02:00
Jeremy Bryant
efcbf0b5ab Add use cases of (fn) documentation facility.
* doc/lispref/functions.texi (Function Documentation):  Add examples.
(Bug#67499)

Co-authored-by: Eli Zaretskii <eliz@gnu.org>
2023-12-16 14:57:06 +02:00
Adam Porter
ed8a8a5ba1 Fix symbol name in Multisession Variables examples
* doc/lispref/variables.texi (Multisession Variables): Fix symbol
name.  (Bug#67823)
2023-12-15 01:54:35 +01:00
Yuan Fu
9874561f39
Fix treesit-node-field-name and friends (bug#66674)
So turns out ts_node_field_name_for_child takes a named node index,
but we were passing it normal index that counts both named and
anonymous nodes.  That's what makes the field name all wrong in
treesit explorer.

* doc/lispref/parsing.texi:
(Accessing Node Information): Update docstring.
* lisp/treesit.el (treesit-node-index): Add some unrelated comment.
(treesit-node-field-name): Get named node index rather than all node
index.
* src/treesit.c (Ftreesit_node_field_name_for_child): Update
docstring, use ts_node_named_child_count.
2023-12-10 16:28:21 -08:00
Stefan Kangas
2773cf9e01 ; Fix typos 2023-12-10 12:39:54 +01:00
Stefan Kangas
020aff95fa ; Fix typos in ChangeLog files 2023-12-10 12:38:19 +01:00
Eli Zaretskii
0f361cc985 ; Minor copyedits in description of ':box' face property
* doc/lispref/display.texi (Face Attributes): Rearrange
description of ':box' attributes.  Suggested by Arash Esbati
<arash@gnu.org>.  (Bug#67713)
2023-12-09 13:05:07 +02:00
Eli Zaretskii
12daf386f3 ; * doc/lispref/processes.texi (Network): Fix wording and punctuation. 2023-12-09 09:48:40 +02:00
Eli Zaretskii
82ddcf37ec ; * doc/lispref/files.texi (Changing Files): Fix last change. 2023-12-04 19:13:50 +02:00
Philipp Stephani
89068516b3 Don't claim to signal an error when deleting a nonexisting file.
The behavior has changed in commit
1a65afb7ec to no longer signal an error
on ENOENT.

* doc/lispref/files.texi (Changing Files): Fix documentation about
error reporting.
2023-12-04 14:17:31 +01:00
Stefan Kangas
5f923ff1a6 ; Fix typos 2023-12-03 23:31:30 +01:00
Xiyue Deng
7f0bef47dd Drop extra parenthesis in example code in Emacs Lisp Introduction
* doc/lispintro/emacs-lisp-intro.texi (Small buffer case): Drop
trailing unmatched parenthesis.  (Bug#67576)

Copyright-paperwork-exempt: yes
2023-12-02 09:59:43 +02:00
Xiyue Deng
bd62bdbc68 Fix example code in Emacs Lisp Introduction manual
* doc/lispintro/emacs-lisp-intro.texi (Optional Arguments): Fix
indentation in an example.  (Bug#67559)

Copyright-paperwork-exempt: yes
2023-12-01 13:55:59 +02:00
Eli Zaretskii
c7e459132a Fix example in Emacs Lisp Intro manual
* doc/lispintro/emacs-lisp-intro.texi (beginning-of-buffer opt
arg): Fix indentation in example.  Reported by Xiyue Deng
<manphiz@gmail.com>.  (Bug#67560)
2023-12-01 10:47:27 +02:00
Eli Zaretskii
a6e9c26c8f ; * doc/emacs/files.texi (Save Commands): Fix last change. 2023-12-01 10:36:55 +02:00
Jeremy Bryant
f6a06ed6c5 Elisp manual: Mention 'write-region' for saving the buffer
* doc/emacs/files.texi (Save Commands):  Mention
'write-region'.  (Bug#67313)
2023-12-01 10:33:20 +02:00
Michael Albinus
4774a3abb4 Document, that PROCESS of signal-process can be a string
* doc/lispref/processes.texi (Signals to Processes) [signal-process]:
* src/process.c (Fsignal_process): Document, that PROCESS can be a
string.
2023-11-30 14:37:40 +01:00
Eli Zaretskii
2e5d47f578 ; * doc/lispintro/emacs-lisp-intro.texi (copy-to-buffer): Fix last change. 2023-11-29 15:04:49 +02:00