Commit graph

5760 commits

Author SHA1 Message Date
Yuan Fu
10f976300d
; Add some tree-sitter thing content to the manual
* doc/lispref/parsing.texi (User-defined Things): List "builtin"
things.
2024-12-15 21:40:49 -08:00
Eli Zaretskii
5c6dbc65f3 ; * doc/lispref/frames.texi (Multiple Terminals): Add indexing. 2024-12-15 09:45:58 +02:00
Chu
6fd5e02cb9 Fix typo in maps.texi
* doc/lispref/maps.texi (Standard Keymaps): Fix typo.  (Bug#74761)

Copyright-paperwork-exempt: yes
2024-12-10 11:51:12 +01:00
Yuan Fu
cf4f1387a6
; Update tree-sitter manual
* doc/lispref/parsing.texi (User-defined Things): Add manual
entry for treesit-node-match-p, treesit-thing-defined-p,
treesit-thing-definition.  Change wording for some functions.
2024-12-01 11:35:06 -08:00
Eli Zaretskii
afb34a3b23 ; Improve documentation of ':box' face attribute
* doc/lispref/display.texi (Face Attributes): Describe a subtlety
of displaying ':box'.  (Bug#74536)
2024-11-30 12:44:01 +02:00
Mike Kupfer
3f99cdaf26 Mention special variables in lexical binding documentation
* doc/lispref/variables.texi (Lexical Binding): Briefly mention
special variables and their semantics.  (Bug#74540)
2024-11-28 17:27:16 +02:00
Joost Kremers
3e396b2c5b Improve documentation for 'while-let'
* doc/lispref/control.texi (Conditionals): Reorganise describing
what's overlapping between the macros (and between the macros
and let*), and then improve the documentation for 'while-let'.
2024-11-25 12:45:00 +08:00
Juri Linkov
5339c6f69e ; Improve example of display-buffer-alist category in ELisp Reference
* doc/lispref/windows.texi (Choosing Window): Use 'add-to-list'
and add an example how to override display-buffer-alist entries
such as 'inhibit-same-window' by matching the window
using the 'category' condition (bug#74457).
2024-11-23 20:27:39 +02:00
Eli Zaretskii
c50ce03afc ; Fix recent additions to the manuals
* doc/lispref/objects.texi (Type Specifiers):
* doc/lispref/functions.texi (Declare Form):
* doc/emacs/help.texi (Name Help): Fix wording and markup.
(Bug#73626)
2024-11-21 17:47:22 +02:00
Andrea Corallo
59b3eae481 ; Introduce type specifiers to the elisp manual (bug#73626)
* doc/lispref/objects.texi (Programming Types): Add 'Type Specifiers' entry.
(Type Specifiers): Add node.
* doc/lispref/functions.texi (Declare Form): Add 'Type Specifiers'
reference.
2024-11-21 15:38:15 +01:00
Eli Zaretskii
3eb3018682 ; Improve documentation of 'category' in display-buffer actions
* doc/lispref/windows.texi (Choosing Window)
(Buffer Display Action Alists): Add cross-references.
* doc/lispref/buffers.texi (Buffer List):

* lisp/subr.el (buffer-match-p): Improve documentation of
'category' condition.  (Bug#74361)
2024-11-21 12:28:26 +02:00
Stefan Kangas
0856360d80 ; Fix typo in recent change 2024-11-16 07:22:48 +01:00
Eli Zaretskii
94bf7ad797 Document the 'display-line-numbers-disable' property
* doc/lispref/display.texi (Overlay Properties):
* doc/lispref/text.texi (Special Properties): Document
'display-line-numbers-disable'.  Fix indexing.
2024-11-09 13:33:21 +02:00
Robert Pluim
3231af3727 Improve 'open-network-stream' documentation.
* doc/lispref/processes.texi (Network): Correct explanation of
':warn-unless-encrypted'.  Document ':error' return keyword.
* lisp/net/network-stream.el (open-network-stream): Improve
':return-list' documentation.  Document ':error'.  Correct
explanation of ':warn-unless-encrypted'.
2024-11-05 13:51:21 +01:00
Robert Pluim
fb55431c44 ; Fix typos in case-conversion descriptions
* doc/lispref/nonascii.texi (Character Properties): Fix typos.
* doc/lispref/strings.texi (Case Conversion): Fix typos.
(Case Tables): Fix typos.
2024-11-05 12:33:49 +01:00
Eli Zaretskii
83f095d1fd ; Fix typo and indexing in the ELisp manual
* doc/lispref/display.texi (Image Descriptors): Fix typo and indexing.
(Defining Images): Fix indexing.
2024-11-04 21:34:25 +02:00
Eli Zaretskii
f7b85fe986 Improve documentation of letter-case conversions
* doc/lispref/nonascii.texi (Character Properties):
* doc/lispref/strings.texi (Case Conversion, Case Tables):
Document that special-casing rules override the case-table
conversions.  (Bug#74155)
2024-11-01 16:39:39 +02:00
Eli Zaretskii
8a4d13e370 ; * doc/lispref/frames.texi (Yanking Media): Add index entry. 2024-10-29 16:27:51 +02:00
Stefan Monnier
9e1abf11fc Tweak doc w.r.t to "void function" (bug#73886)
* doc/lispref/functions.texi (Function Cells): Avoid talking
about the function cell being void.

* src/data.c (Fboundp, Ffmakunbound, Fsymbol_function):
Don't suggest that "void" can be considered as a kind of value.
2024-10-27 14:52:25 -04:00
Eli Zaretskii
55a8cec013 Another 'void' update
* doc/lispref/symbols.texi (Symbol Components): Another update due
to the change in 'void' function implementation.  (Bug#73886)
2024-10-27 16:07:08 +02:00
Eli Zaretskii
b0aaee93fd Update the documentation of void functions
* doc/lispref/functions.texi (Function Cells):
* src/data.c (Ffboundp, Ffmakunbound, Fsymbol_function): Update
documentation to the changes of how void functions are represented
since Emacs 24.5.  (Bug#73886)
2024-10-27 13:16:36 +02:00
Eli Zaretskii
1a91d37a21 ; * doc/lispref/control.texi (Conditionals): Fix markup. 2024-10-24 08:42:29 +03:00
Sean Whitton
eae798486a Update special conditionals documentation
* doc/lispref/control.texi (Conditionals): Document if-let* and
when-let*, not if-let and when-let.  Document and-let*.
2024-10-24 12:10:09 +08:00
Eli Zaretskii
c35d6ba9f0 ; * doc/lispref/display.texi (Fontsets): Clarify wording. 2024-10-21 18:32:07 +03:00
Eli Zaretskii
88a1a32fc5 ; * doc/lispref/display.texi (Fontsets): Fix typo. 2024-10-21 13:04:18 +03:00
Eli Zaretskii
6be47058cd ; Add indexing for 'use-default-font-for-symbols'
* doc/emacs/mule.texi (Modifying Fontsets):
* doc/lispref/display.texi (Fontsets): Index
'use-default-font-for-symbols'.
2024-10-21 13:01:53 +03:00
Michael Albinus
7dbbd58d6c Locate password icon in global-mode-string
* doc/emacs/mini.texi (Passwords): Precise the location of the
password icon.

* doc/lispref/minibuf.texi (Reading a Password): The password icon
is added to global-mode-string.

* lisp/auth-source.el (read-passwd--mode-line-buffer): Remove.
(read-passwd--hide-password): Fix docstring.
(read-passwd-toggle-visibility): Don't use
`read-passwd--mode-line-buffer'.  Check for `read-passwd-mode'.
Force update in all mode lines.
(read-passwd-mode): Set `read-passwd--mode-line-icon' in
`global-mode-string'.  (Bug#73768)
2024-10-18 17:47:43 +02:00
Eli Zaretskii
19049efd30 ; Fix last documentation change
* doc/misc/efaq.texi (Colors on a TTY):
* doc/lispref/frames.texi (Font and Color Parameters):
* doc/emacs/cmdargs.texi (Colors X): More accurate documentation
of TTY color modes and 'tty-color-mode' frame parameter.
(Bug#73813)
2024-10-18 15:46:17 +03:00
Robert Pluim
2c640e63a8 Explain tty-color-mode frame parameter more.
* doc/emacs/cmdargs.texi (Colors X): Explain that tty color
support is dynamic.
* doc/lispref/frames.texi (Font and Color Parameters): Explain
that 'tty-color-mode' can be changed on the fly.
* doc/misc/efaq.texi (Colors on a TTY): Explain how to disable
'tty-color-mode', either at startup or dynamically.
2024-10-18 11:44:49 +02:00
Eli Zaretskii
569186c36e ; * doc/lispref/display.texi (Face Attributes): Fix typo (bug#73824). 2024-10-16 07:59:59 +03:00
Eli Zaretskii
d664227f81 ; More accurate documentation of 'file-newer-than-file-p'
* doc/lispref/files.texi (File Attributes):
* src/fileio.c (Ffile_newer_than_file_p): Say the comparison uses
the last-modification times.  (Bug#73709)
2024-10-10 11:03:48 +03:00
Stefan Kangas
5a462948e1 Update Arni Magnusson's email address
* .mailmap:
* doc/lispref/ChangeLog.1:
* doc/misc/ChangeLog.1:
* lisp/ChangeLog.16:
* lisp/ChangeLog.17:
* lisp/progmodes/bat-mode.el: Update email address of
Arni Magnusson.  (Bug#73631)
2024-10-05 02:30:41 +02:00
Eli Zaretskii
4c866abab9 ; * doc/lispref/variables.texi (Creating Buffer-Local): Fix wording. 2024-10-02 08:47:29 +03:00
Stefan Kangas
108b3179bd Revert "; Minor clarification in variables.texi"
This reverts commit 44156c2140.
2024-10-02 00:12:34 +02:00
Stefan Kangas
44156c2140 ; Minor clarification in variables.texi
* doc/lispref/variables.texi (Creating Buffer-Local): Add comma to make
reference clearer.
2024-10-01 22:10:35 +02:00
Robert Pluim
4729065ee7 Document 'buttonize-region' in manual
It was added in emacs-29, but never added to the lisp reference
manual.

* doc/lispref/display.texi (Making Buttons): Document
'buttonize-region'.
2024-09-24 17:03:49 +02:00
Eli Zaretskii
8f265b49e3 ; Fix last change
* doc/lispref/lists.texi (Building Lists):
* src/fns.c (Fappend): Fix last change (bug#73427).  Suggested by
Mattias Engdegård <mattias.engdegard@gmail.com>.
2024-09-23 17:13:31 +03:00
Eli Zaretskii
c8ed48b990 ; Improve documentation of 'append'
* doc/lispref/lists.texi (Building Lists):
* src/fns.c (Fappend): Improve documentation of 'append'.  (Bug#73427)
2024-09-23 14:41:34 +03:00
Eli Zaretskii
ad289f364e ; Improve documentation of 'easy-menu-define'
* doc/lispref/keymaps.texi (Easy Menu):
* lisp/emacs-lisp/easymenu.el (easy-menu-define): Document that
SYMBOL is also defined as a variable.  (Bug#73108)
2024-09-14 11:55:08 +03:00
Mattias Engdegård
f47297782b ; * doc/lispref/searching.texi (Rx Notation): Simplify rx example 2024-09-09 15:22:32 +02:00
Eli Zaretskii
03e5698167 Clarify the semantics of 'string-pixel-width'
* doc/lispref/display.texi (Size of Displayed Text):
* lisp/emacs-lisp/subr-x.el (string-pixel-width):
* src/xdisp.c (Fwindow_text_pixel_size, Fbuffer_text_pixel_size):
Doc fixes.  (Bug#73129)
2024-09-09 14:28:12 +03:00
Mattias Engdegård
e55e2e1c6b Make json-serialize always return a unibyte string (bug#70007)
The JSON format is defined as a byte sequence and will always be used as
such, so returning a multibyte string makes little sense.

* src/json.c (json_out_to_string): Remove.
(Fjson_serialize): Return unibyte string.
* test/src/json-tests.el (json-serialize/roundtrip)
(json-serialize/roundtrip-scalars, json-serialize/string):
Update tests.
* doc/lispref/text.texi (Parsing JSON): Document.
* etc/NEWS: Announce.
2024-09-08 20:02:34 +02:00
Eli Zaretskii
89c99891b2 ; * doc/lispref/os.texi (Suspending Emacs): Fix last change. 2024-09-07 19:41:36 +03:00
Eli Zaretskii
4f044d0d3d ; Improve documentation of 'suspend-emacs'
* doc/lispref/os.texi (Suspending Emacs):
* src/keyboard.c (Fsuspend_emacs): Document possible failures
in sending STUFFSTRING to the shell.  (Bug#73100).
2024-09-07 18:38:40 +03:00
Eli Zaretskii
c1cd036d27 ; * doc/lispref/modes.texi (Mode Line Data): Fox wording. 2024-09-04 17:14:25 +03:00
Eli Zaretskii
ae2463796f ; Caveats about using :eval in 'mode-line-format'
* doc/lispref/modes.texi (Mode Line Data): Warn against more
infinite-recursion cases in ':eval' in mode line.  Reported by
Nicolas P. Rougier <nicolas.rougier@inria.fr>.
2024-09-03 17:33:28 +03:00
Stefan Kangas
4047072c7d Update FSF's address
* doc/emacs/emacs.texi (Distrib):
* doc/lispintro/emacs-lisp-intro.texi:
* doc/lispref/elisp.texi:
* doc/misc/org.org (Link Abbreviations):
* etc/tutorials/TUTORIAL.eo:
* lisp/elide-head.el:
* lisp/textmodes/page-ext.el: Update the FSF address to 31 Milk Street.
2024-09-02 21:02:09 +02:00
Eli Zaretskii
8c044bd972 ; Fix recent changes in documentation
* doc/lispref/positions.texi (List Motion): Fix indexing.
* doc/emacs/mini.texi (Completion Options): Fix wording.
2024-09-01 20:57:03 +03:00
Juri Linkov
4ff4b78f92 ; Small doc fixes
* doc/emacs/dired.texi (Operating on Files): Add indexed function
'dired-do-open' to the text.

* doc/emacs/mini.texi (Completion Options): Add indexed functions
'previous-line-completion' and 'next-line-completion' to the text.

* doc/lispref/minibuf.texi (Completion Variables): Remove self-reference.

* doc/lispref/positions.texi (List Motion): Add indexed function
'treesit-forward-sexp' to the text.  Add @vindex for
'forward-sexp-function'.

* etc/NEWS: Group tab-bar and tab-line items separately.
Move two Buffer-menu items to separate outline.
2024-09-01 19:53:52 +03:00
Mattias Engdegård
2ca7d5649c ; More accurate text about how equal compares various objects
* doc/lispref/objects.texi (Equality Predicates):
Attempt at improving the text further (bug#72888).
2024-08-31 18:39:46 +02:00