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