1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-03 06:00:50 -08:00
Commit graph

11172 commits

Author SHA1 Message Date
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
Xiyue Deng
c46700deb0 Add more text to clarify the behavior of 'with-current-buffer'
* doc/lispintro/emacs-lisp-intro.texi (copy-to-buffer): Expand
description of 'with-current-buffer'.  (Bug#67521)

Copyright-paperwork-exempt: yes
2023-11-29 15:01:20 +02:00
Eli Zaretskii
687c416ce9 Fix example in Emacs user manual
* doc/emacs/custom.texi (Init Rebinding): Fix syntax of example.
Reported by silarakta <silarakta@protonmail.com>.  (Bug#67474)
2023-11-27 15:03:22 +02:00
Daniel Martín
169a5ff752 ; Fix typo in Gnus manual (bug#67469). 2023-11-27 14:18:06 +02:00
Michael Albinus
30841c71a5 Mention Titankey in Tramp, which has passed the tests
* doc/misc/tramp.texi (Frequently Asked Questions):
* lisp/net/tramp.el (tramp-security-key-confirm-regexp):
Mention also Titankey.
2023-11-27 08:34:56 +01:00
Michael Albinus
0676a02931 Extend D-Bus doc and test
* doc/misc/dbus.texi (Register Objects): Adapt doc of
dbus-unregister-service.

* test/lisp/net/dbus-tests.el (dbus--test-register-service):
Extend test.
2023-11-24 16:34:26 +01:00
Eli Zaretskii
99658346d1 ; Improve documentation of desktop.el in user manual
* doc/emacs/misc.texi (Saving Emacs Sessions): Mention saving
minibuffer history via desktop.el.
2023-11-23 17:56:50 +02:00
Eli Zaretskii
5a5e36d2aa ; Improve function documentation tips
* doc/lispref/tips.texi (Documentation Tips): Clarify the good
style of descriptions in doc strings.
2023-11-23 17:26:09 +02:00
Eli Zaretskii
86016d8ecd Mention "visual line" in user manual
* doc/emacs/display.texi (Visual Line Mode):
* doc/emacs/basic.texi (Continuation Lines, Moving Point): Mention
"visual line".  (Bug#67382)
2023-11-23 16:56:10 +02:00
Eli Zaretskii
4bb65ed77a ; * doc/lispref/minibuf.texi (Programmed Completion): Improve indexing. 2023-11-23 16:43:17 +02:00
Eli Zaretskii
d72a4ed65c Fix 'with-sqlite-transaction' when BODY fails
* lisp/sqlite.el (with-sqlite-transaction): Don't commit changes
if BODY errors out.  Roll back the transaction if committing
fails.  (Bug#67142)

* etc/NEWS:
* doc/lispref/text.texi (Database): Document the error handling in
'with-sqlite-transaction'.
2023-11-21 15:36:22 +02:00
Eli Zaretskii
a7b3c92373 ; * doc/emacs/cmdargs.texi (Initial Options): Fix last change. 2023-11-21 14:40:27 +02:00
Eli Zaretskii
fd76a80864 ; Mention that -x and --script ignore file-locals
* doc/emacs/cmdargs.texi (Initial Options): Document that --script
and -x ignore file-local variables.  (Bug#67321)
2023-11-21 14:23:38 +02:00
Eli Zaretskii
e0469ddb9d ; * doc/emacs/search.texi (Special Isearch): More accurate text. 2023-11-20 21:38:55 +02:00
Richard Stallman
e521669fb3 Fix wording in ELisp Intro manual
* doc/lispintro/emacs-lisp-intro.texi (Lisp macro): Improve
wording in description of 'unless'.  (Bug#67185)
2023-11-19 12:14:36 +02:00
Eli Zaretskii
232a57a3e3 ; * doc/lispref/debugging.texi (Debugging): Add cross-references. 2023-11-17 14:28:13 +02:00
Ihor Radchenko
c65ddf26a3 ; doc/lispref/debugging.texi: Add reference to Profiler docs (bug#67236). 2023-11-17 14:25:01 +02:00