Commit graph

12528 commits

Author SHA1 Message Date
Stefan Kangas
92e96a1175 ; Delete troff markers from ChangeLog files 2025-02-20 02:46:43 +01:00
Stefan Kangas
be7625cae7 ; Fix typos 2025-02-18 05:42:12 +01:00
Eli Zaretskii
e9c4f642b9 ; * doc/emacs/package.texi (Package Installation): Add omitted index entry. 2025-02-15 12:12:30 +02:00
Eli Zaretskii
8c4294f370 ; Move index entries in user manual
* doc/emacs/package.texi (Packages): Move index entries from here...
(Package Installation): ...to here.  Index entries should be where
the main description of the subject can be found.
2025-02-15 12:08:41 +02:00
Stefan Kangas
b9b9c33dcb Fix (Non)GNU ELPA description in manual
* doc/emacs/package.texi (Packages): Move detailed (Non)GNU ELPA
description...
(Package Installation): ...here, and fix incorrect information.
2025-02-13 16:42:01 +01:00
Stefan Kangas
87a61eba1b Move 'package-archives' documentation to emacs manual
* doc/lispref/package.texi (Package Archives): Move documentation
of package-archives variable from here...
* doc/emacs/package.texi (Package Installation): ...to here.
(Bug#76266)
2025-02-13 16:40:15 +01:00
Stefan Kangas
c68886ddb7 ; Change "virus" to "malicious" in lispref
* doc/lispref/functions.texi (Function Safety): Replace 'virus' with
'malicious' to ensure broader accuracy, as 'malicious' encompasses all
harmful software types.
2025-02-13 03:04:30 +01:00
Stefan Kangas
6701866be4 Document (Non-)GNU ELPA in emacs manual
* doc/emacs/package.texi (Packages): Document GNU ELPA and NonGNU
ELPA.  (Bug#59609)
2025-02-12 16:40:04 +01:00
Stefan Kangas
19791839cf ; Don't document a complicated default
* doc/misc/message.texi (Superseding): Don't document the default value
of 'message-ignored-supersedes-headers' here; the list was out-of-date,
and is likely to become out-of-date again in the future if updated.
It's also easy enough to look up for users outside of Info.
2025-02-11 16:48:23 +01:00
Eli Zaretskii
737f249aa2 ; Document 'completing-read-multiple' in the ELisp manual
* doc/lispref/minibuf.texi (Minibuffer Completion): Mention
'completing-read-multiple' (bug#76194).
2025-02-11 16:42:19 +02:00
Eli Zaretskii
223ee56aae ; Avoid passive tense in Emacs manual
* doc/lispref/variables.texi (Defining Variables): Avoid passive
tense (bug#76135).
2025-02-08 13:47:11 +02:00
Eli Zaretskii
143f1096da Improve documentation of 'file-name-concat'
* doc/lispref/files.texi (Directory Names):
* src/fileio.c (Ffile_name_concat): Advise not to use
'file-name-concat' unless necessary.  (Bug#76023)
2025-02-06 10:42:04 +02:00
Stefan Kangas
a3b3083081 ; Don't use HTTPS in HTTP-specific example
* doc/misc/org.org (External Links): Change HTTP example to use HTTP.
Changing it to HTTPS has been done before, but it's a mistake.  To avoid
making this mistake again, change the URL to orgmode.org to make it more
similar to the example on the next line, thereby contrasting the two.
2025-02-03 14:03:43 +01:00
Eli Zaretskii
6d7e7899d8 Improve documentation of 'display-monitor-attributes-
* doc/lispref/frames.texi (Multiple Terminals):
* lisp/frame.el (display-monitor-attributes-list): Better
documentation of what the 'source' key means on X.  (Bug#75936)
2025-02-02 15:58:18 +02:00
Stefan Kangas
3bccd04c5c Improve wording in symbols.texi
* doc/lispref/symbols.texi (Symbol Components): Improve wording
(Bug#75512).   Reported by Matt Trzcinski <matt@excalamus.com>.
2025-02-01 04:08:43 +01:00
Manuel Giraud
6441b9ea7a Fix typo in Gnus manual
* doc/misc/gnus.texi (Comparing Mail Back Ends): Fix a missing
verb.  (Bug#75974)
2025-02-01 04:02:05 +01:00
Stefan Kangas
486d5d524c Update cc-mode URL to point to nongnu.org
* doc/misc/cc-mode.texi (Getting Started)
(Custom Filling and Breaking, Updating CC Mode)
(Mailing Lists and Bug Reports):
* lisp/progmodes/cc-mode.el: Update cc-mode URL to point to nongnu.org,
instead of old URL on SourceForge.
2025-01-28 18:44:05 +01:00
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