1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-15 10:30:25 -08:00
Commit graph

12611 commits

Author SHA1 Message Date
Eli Zaretskii
5d021a711a ; Improve documentation of '.dir-locals.el'
* doc/lispref/variables.texi (Directory Local Variables):
* doc/emacs/custom.texi (Directory Variables): Document that
'.dir-locals-2.el' must be in the same directory as
'.dir-locals.el'.  (Bug#75890)
2025-01-27 15:19:06 +02:00
Stefan Kangas
5617b07a45 ; Prefer HTTPS to HTTP in docs
* doc/emacs/android.texi (Android Software):
* doc/lispref/frames.texi (X Selections):
* doc/misc/cc-mode.texi (Custom Filling and Breaking):
* doc/misc/efaq.texi (Basic editing):
* doc/misc/gnus.texi (Propagating marks, Spam Statistics Package):
* doc/misc/org.org (External Links, Images in HTML export)
(LaTeX Export, LaTeX math snippets): Prefer HTTPS to HTTP.  Fix or
mark some broken links while we're at it.
2025-01-26 22:45:13 +01:00
Stefan Kangas
3c820cd265 Document insert-directory-program as a user option
* doc/lispref/files.texi (Contents of Directories): Document
'insert-directory-program' as a user option.
2025-01-26 22:45:13 +01:00
Stefan Monnier
2c1edf5f62 doc/lispref/modes.texi (Syntactic Font Lock): Update for commit 644c6b414f
Remove outdated `nil` element, as discussed in
https://lists.gnu.org/archive/html/help-gnu-emacs/2025-01/msg00244.html
2025-01-25 10:48:38 -05:00
Stefan Kangas
fb282da2a0 Avoid double spaces around abbrevations in Texinfo
* doc/emacs/custom.texi (Init Rebinding):
* doc/emacs/dired.texi (Operating on Files):
* doc/emacs/emacs.texi (Top):
* doc/emacs/emerge-xtra.texi (Emerge):
* doc/emacs/files.texi (Files):
* doc/emacs/frames.texi (Drag and Drop):
* doc/emacs/misc.texi (Hyperlinking):
* doc/emacs/modes.texi (Modes):
* doc/emacs/mule.texi (Input Methods):
* doc/emacs/windows.texi (Window Tool Bar):
* doc/lispintro/emacs-lisp-intro.texi
(Lexical & Dynamic Binding Differences):
* doc/lispref/elisp.texi (Top):
* doc/lispref/functions.texi (Functions, Generic Functions):
* doc/lispref/hash.texi (Defining Hash):
* doc/lispref/keymaps.texi (Creating Keymaps):
* doc/lispref/lists.texi (Property Lists):
* doc/lispref/modes.texi (%-Constructs):
* doc/lispref/nonascii.texi (Character Properties):
* doc/lispref/processes.texi (Misc Network):
* doc/lispref/searching.texi (Regexp Functions):
* doc/lispref/syntax.texi (Syntax Table Internals):
* doc/lispref/text.texi (Filling, Checksum/Hash)
(JSONRPC deferred requests):
* doc/misc/calc.texi (What is Calc, Modes Tutorial):
* doc/misc/cc-mode.texi (List Line-Up, Operator Line-Up)
(Custom Macros, Indenting Directives):
* doc/misc/efaq.texi (Colors on a TTY, Security risks with Emacs):
* doc/misc/eglot.texi (Eglot Variables):
* doc/misc/erc.texi (Connecting):
* doc/misc/eshell.texi (Aliases, Completion):
* doc/misc/flymake.texi (Backend functions):
* doc/misc/gnus-faq.texi (FAQ 5 - Composing messages):
* doc/misc/gnus.texi (Gnus Unplugged, Window Layout)
(Filtering Incoming Mail, History):
* doc/misc/idlwave.texi (Online Help, Catalogs):
* doc/misc/wisent.texi (Wisent Overview): Be more consistent with
abbreviations.  Use @: or comma or rewrite to avoid double spaces.
Ref: https://lists.gnu.org/r/emacs-devel/2025-01/msg00909.html
2025-01-24 23:10:23 +01:00
Robert Pluim
bc1ab8ac3d ; * doc/emacs/custom.texi (Init Rebinding): Fix spacing. 2025-01-24 16:55:15 +01:00
Robert Pluim
b41ef43af1 ; Fix previous change
* doc/emacs/fixit.texi (Spelling): Use "personal" instead of
"private" dictionary.
2025-01-24 15:58:47 +01:00
Stefan Kangas
cda78edc7d ; Fix typos 2025-01-23 03:14:37 +01:00
Stefan Kangas
9878092d2b Minor copyedits in internals.texi
* doc/lispref/internals.texi (Writing Emacs Primitives): Minor
copyedits.
2025-01-19 14:30:31 +01:00
Stefan Kangas
4726900fdc Better document side-effect free and pure C functions
* doc/lispref/internals.texi (Writing Emacs Primitives):
Document that side-effect free and pure properties of C functions
are defined in byte-opt.el.
2025-01-19 14:30:31 +01:00
Robert Pluim
6a864ef8f3 Add smtpmail cross-reference to 'auth-sources'.
* doc/misc/smtpmail.texi (Authentication): Add cross-reference
to 'auth-sources'.
2025-01-14 10:25:18 +01:00
Mauro Aranda
30e84fc653 Emphasize the use of :tag for new customization types
* doc/lispref/customize.texi (Type Keywords): Name important use
cases of the :tag keyword.
(Defining New Types): Emphasize the use of the :tag keyword when
using the lazy widget.  (Bug#74409)

(cherry picked from commit 99b85e116f)
2025-01-12 21:25:06 +02:00
Eli Zaretskii
26c5fadf47 Document that 'package-vc' doesn't support built-in packages
* doc/misc/use-package.texi (Install package):
* doc/emacs/package.texi (Fetching Package Sources): Document that
upgrading built-in packages is not yet supported using
'package-vc'.  (Bug#75328)
2025-01-11 12:58:03 +02:00
Stefan Kangas
6de2ee5663 Document string-as-{unibyte,multibyte} as obsolete in manual
* doc/lispref/nonascii.texi (Selecting a Representation): Document
string-as-unibyte and string-as-multibyte as obsolete.
2025-01-11 05:18:14 +01:00
Stefan Kangas
002960ceab Clarify that 'mac' line ending convention is not used on macOS
* doc/emacs/mule.texi (Coding Systems):
* doc/lispref/nonascii.texi (Coding System Basics): Clarify that the
'mac' line ending convention is not used on macOS, and is now rare
outside of legacy software.
2025-01-08 05:07:57 +01:00
Eli Zaretskii
ee1034422b ; Improve documentation of function-type display
* etc/NEWS: Document 'help-display-function-type'.

* doc/lispref/functions.texi (Declare Form):
* doc/lispref/objects.texi (Type Specifiers):
* doc/emacs/help.texi (Name Help): Better indexing of function
types.  (Bug#65288)
2025-01-07 17:20:22 +02:00
Hong Xu
6d8c3c0cbe Use keymap*-set' over global-set-key'/`define-key' in elisp intro
* doc/lispintro/emacs-lisp-intro.texi (Key Bindings): Since
`global-set-key' and `define-key' are considered legacy, we encourage
`keymap-global-set' and `keymap-set' now.  (Bug#74999)
2025-01-04 14:33:10 +02:00
Stefan Kangas
cd6e2a0828 Fix copyright years by hand
These are dates that admin/update-copyright did not update.
2025-01-02 18:44:48 +01:00
Stefan Kangas
7fa975adbc Update copyright year to 2025
Run "TZ=UTC0 admin/update-copyright".
2025-01-02 18:39:42 +01:00
Kohei Tsuruta
7acfea1935 ; * doc/lispref/modes.texi (Customizing Keywords): Fix typo (bug#75193). 2024-12-30 16:01:02 +02:00
Kohei Tsuruta
d47a7d6f0f ; Add missing parameters in keymap doc
* doc/lispref/keymaps.texi (Controlling Active Maps): Add missing
parameters.  (Bug#75174)

Copyright-paperwork-exempt: yes
2024-12-29 15:40:13 +02:00
Eli Zaretskii
07e9f27c3e ; * doc/misc/calc.texi: Fix makeinfo warnings (bug#75166). 2024-12-28 22:38:17 +02:00
Eli Zaretskii
2ba6387d1d ; Fix inaccuracy in ELisp Reference manual
* doc/lispref/objects.texi (Basic Char Syntax): Fix inaccurate
wording.  (Bug#75113)
2024-12-28 14:04:26 +02:00
Eli Zaretskii
8064b2a679 Document undocumented completion commands
* src/minibuf.c (Fread_from_minibuffer):
* lisp/minibuffer.el (minibuffer-complete-history)
(minibuffer-complete-defaults): Doc fixes.

* doc/emacs/mini.texi (Completion Commands): Fix markup, style of
describing commands, and indexing.  Document 'C-x UP' and 'C-x
DOWN'.
2024-12-24 21:25:02 +02:00
Eli Zaretskii
14e791f9ba ; Update acknowledgments for Emacs 30
* admin/release-process: Suggest a command to compare source
trees.

* doc/emacs/emacs.texi (Acknowledgments):
* doc/emacs/ack.texi (Acknowledgments): Add authors of new stuff
in Emacs 30.
2024-12-22 12:55:46 +02:00
Eli Zaretskii
861b7864fc ; Fix node name in emacs-lisp-intro.texi
* doc/lispintro/emacs-lisp-intro.texi
(Lexical vs Dynamic Binding Example): Renamed from "... vs. ...",
to avoid using period in node names.
2024-12-22 12:11:46 +02:00
Eli Zaretskii
fe2ac33bae ;* doc/misc/efaq.texi (New in Emacs 30): Mention 'trusted-contents'. 2024-12-22 10:43:57 +02:00
Michael Albinus
e281355a5e Improve D-Bus and Tramp manual
* doc/misc/dbus.texi (Overview):
* doc/misc/tramp.texi (GVFS-based methods): Describe, how the
feature can be checked at runtime.  (Bug#75004)
2024-12-22 09:30:47 +01:00
Eli Zaretskii
8a0c9c234f Document 'trusted-content
* doc/emacs/misc.texi (Host Security): Document 'trusted-content'.

* lisp/files.el (trusted-content): Doc fix.

* etc/NEWS: Mark its entry as "documented".
2024-12-18 19:57:13 +02:00
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
Paul Eggert
856a58e282 Update documentation of 'etags' regexps some more
* doc/emacs/maintaining.texi (Etags Regexps):
* doc/man/etags.1: Give more details about what's not supported.
2024-12-15 00:16:10 -07:00
Eli Zaretskii
4c68846223 Update documentation of 'etags' regexps
* doc/emacs/maintaining.texi (Etags Regexps):
* doc/man/etags.1: Say that shy groups are not supported (bug#74861).
2024-12-15 07:52:40 +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
Michael Albinus
b4bcbabf95 * doc/misc/tramp.texi (FUSE-based methods): Fix sshfs reference. 2024-12-09 15:50:59 +01:00
Stefan Kangas
f8da72b41c Improve gnus.texi indexing
* doc/misc/gnus.texi (Common Variables): Improve indexing.
2024-12-08 14:52:25 +01:00
Eli Zaretskii
130c2a13dc ; * doc/emacs/building.texi (Compilation Mode): Fix last change. 2024-12-04 18:21:19 +02:00
Robert Pluim
7c50e4cc8c Improve 'compilation-transform-file-match-alist' documentation
* doc/emacs/building.texi (Compilation Mode): Document
'compilation-transform-file-match-alist'.
* lisp/progmodes/compile.el
(compilation-transform-file-match-alist):
Expand docstring and add some examples.
2024-12-04 14:55:27 +01:00
Eli Zaretskii
d50293b0f1 ; Improve documentation of 'epa-mail-verify'
* doc/misc/epa.texi (Mail-mode integration):
* lisp/epa-mail.el (epa-mail-verify): Improve documentation of
'epa-mail-verify'.  (Bug#74630)
2024-12-04 15:21:13 +02:00
Eli Zaretskii
43c4a06ffc ; Fix grammar in Emacs user manual
* doc/emacs/trouble.texi (Sending Patches): Fix wording.  Reported
by Daniel Martín <mardani29@yahoo.es>.  (Bug#74638)
2024-12-02 14:33:52 +02: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
b71d3b2f52 ; Better clarify function types in C-h f (bug#73626)
* doc/emacs/help.texi (Name Help): Better clarify function types.
2024-11-21 15:39:27 +01: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
Eli Zaretskii
4d80c4f485 ; More accurate documentation of 'set-mark-command'
* doc/emacs/mark.texi (Setting Mark, Global Mark Ring): Explain
that activating an existing mark doesn't set a new mark, and
doesn't push the mark onto the global mark ring.  (Bug#74438)
2024-11-21 11:47:07 +02:00