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

5140 commits

Author SHA1 Message Date
Eli Zaretskii
396b49871a ; Fix last change in package.texi
* doc/lispref/package.texi (Multi-file Packages): Fix wording and
markup.  (Bug#65027)

(cherry picked from commit 6d76e39912)
2024-01-28 15:06:37 +01:00
Jim Porter
b2db82c5ae * doc/lispref/package.texi (Multi-file Packages): Document ".elpaignore".
(cherry picked from commit 744a10a4d7)
2024-01-28 03:51:48 +01:00
Eli Zaretskii
53481cc954 Fix description of when "\xNNN" is considered a unibyte character
* doc/lispref/objects.texi (Non-ASCII in Strings): More accurate
description of when a hexadecimal escape sequence yields a unibyte
character.  (Bug#68751)
2024-01-27 10:11:32 +02:00
Eli Zaretskii
5483a1df99 Improve documentation of profiler commands
* doc/lispref/debugging.texi (Profiling): Document more commands.
Improve indexing.  (Bug#68693)
2024-01-24 21:34:16 +02:00
Basil L. Contovounesios
fb4cf0ab46 ; Fix xref under Output Overrides in Elisp manual. 2024-01-23 11:39:20 +01:00
Basil L. Contovounesios
aa6c24da61 Fix broken links to Freedesktop notifications spec
* doc/lispref/os.texi (Desktop Notifications):
* lisp/notifications.el: Replace broken developer.gnome.org links
with specifications.freedesktop.org (bug#67939).
2024-01-23 10:52:31 +01: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
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
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
Po Lu
8e1c56ae46 ; Add 2024 to copyright years 2024-01-02 09:47:10 +08: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
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
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
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
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
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
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
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
Eli Zaretskii
b4d990bd63 ; Clarify wording about arguments in doc strings
* doc/lispref/tips.texi (Documentation Tips): Clarify "important
arguments".  (Bug#67217)
2023-11-17 09:04:20 +02:00
Eli Zaretskii
c20ae7a30f ; Improve cross-references in description of 'pcase'
* doc/lispref/control.texi (pcase Macro, Backquote Patterns):
Improve cross-references.
2023-11-16 21:55:10 +02:00
Eli Zaretskii
5f3309f6b0 ; Improve indexing in ELisp manual
* doc/lispref/tips.texi (Documentation Tips, Coding Conventions)
(Key Binding Conventions, Programming Tips, Compilation Tips)
(Warning Tips, Comment Tips, Library Headers): Improve indexing.
2023-11-16 08:24:13 +02:00
Zajcev Evgeny
32a32853ce Typofix in the doc/lispref/modes.texi 2023-11-14 16:23:15 +02:00
Eli Zaretskii
ce0ebb91f2 Improve documentation of read syntax and printed representation
* doc/lispref/objects.texi (Syntax for Strings): Describe in more
detail how to specify special characters in string literals.
(Printed Representation, Character Type, Nonprinting Characters):
Improve information and add cross-references about printed
representation and read syntax.  (Bug#67033)
2023-11-11 12:02:24 +02:00
Eli Zaretskii
81f84b00a5 ; * doc/lispref/modes.texi (Other Font Lock Variables): Add link. 2023-11-11 11:05:58 +02:00
Eli Zaretskii
fe000236cf Improve documentation of signaling errors in batch mode
* doc/lispref/control.texi (Signaling Errors)
(Processing of Errors):
* doc/lispref/os.texi (Batch Mode):
* doc/lispref/debugging.texi (Invoking the Debugger):
* lisp/emacs-lisp/debug.el (debug):
* src/eval.c (Fsignal):
* lisp/subr.el (error): Document more prominently that signaling
an unhandled error in batch mode kills Emacs.  Better
documentation of backtrace in batch mode.
2023-11-09 10:33:28 +02:00
Yuan Fu
103ca678ac
Fix treesit-simple-indent-presets docstring (bug#67007)
* lisp/treesit.el (treesit-simple-indent-presets): Fix docstring.
* doc/lispref/modes.texi (Parser-based Indentation): Fix example.
2023-11-08 23:49:15 -08:00
Eli Zaretskii
196def4fa6 Fix description of 'Package-Requires' library header
* doc/lispref/tips.texi (Library Headers): Update the description
of the 'Package-Requires' header.  (Bug#66677)
2023-11-04 09:59:45 +02:00
Eli Zaretskii
889a550ca0 ; Fix Texinfo warnings
* doc/misc/wisent.texi (Grammar format):
* doc/misc/efaq.texi (Not writing files to the current directory):
* doc/misc/ede.texi:
* doc/lispref/errors.texi (Standard Errors): Fix warnings emitted
by makeinfo 7.1.
2023-10-22 12:21:08 +03:00
Jens Schmidt
b99d12c30c ; Fix argument name for function `copy-file'
* doc/lispref/files.texi (Changing Files): Change name of last
argument of function `copy-file' from `preserve-extended-attributes'
to `preserve-permissions', as used in the function's description, its
doc string and the description below in the manual.
2023-10-20 09:04:39 +03:00
Bob Rogers
0ea2d6d9e8 Document that time-to-days and days-to-time use different epochs
* doc/lispref/os.texi (Time Calculations):
* lisp/calendar/time-date.el (days-to-time, time-to-days): Doc fixes.
(Bug#66502)
2023-10-14 11:57:30 +03:00
Eli Zaretskii
809da7fc9a ; * doc/lispref/processes.texi (Process Buffers): More accurate wording. 2023-10-07 19:09:58 +03:00
Eli Zaretskii
e110312ad9 ; * doc/lispref/minibuf.texi (Text from Minibuffer): Mention alias. 2023-09-16 08:55:17 +03:00
shynur
d11d81dfcc ; Fix doc typos (Bug#65868) 2023-09-11 17:16:23 +02:00
Stefan Kangas
5ab2792d5c Update defvar usage tips example in manual
* doc/lispref/variables.texi (Tips for Defining): Change example
to be about syntax tables instead of old way of defining keymaps
using 'defvar' and 'make-sparse-keymap'.  (Bug#59224)
2023-09-11 01:49:36 +02:00
Vincent Lefevre
b8a8106fa1 ; Add missing space in the manual
* doc/lispref/compile.texi (Native-Compilation Variables): Add missing
space.  (Bug#65782)

Copyright-paperwork-exempt: yes
2023-09-08 18:49:23 +02:00
Eli Zaretskii
4e7112ab21 ; Fix inaccuracy in ELisp reference manual
* doc/lispref/text.texi (Motion by Indent): Remove incorrect
information about return values that can be anything.  (Bug#65819)
2023-09-08 14:39:49 +03:00
Sebastian Miele
b068fcd4a3 * doc/lispref/strings.texi (Text Comparison): Fix typo (bug#65799). 2023-09-07 16:16:34 +03:00