1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-03-15 11:21:19 -07:00
Commit graph

12545 commits

Author SHA1 Message Date
Jeremy Bryant
f729828bcf ; Add texinfo reference to GNU Coding Standards.
* doc/emacs/trouble.texi (Coding Standards): Add texinfo reference to
GNU Coding Standards manual.  (Bug#76901)
2025-03-13 07:12:26 +01:00
Sean Whitton
2029104605 Correct some outdated docs for hack-local-variables
* doc/lispref/variables.texi (File Local Variables):
<hack-local-variables>: Say that it applies directory-local
variables too.  Add a cross-reference.
(Directory Local Variables): Document dir-local-variables-alist.
* lisp/files.el (hack-local-variables): Say that it always puts
into effect directory-local variables.
2025-03-12 10:05:32 +08:00
Stefan Kangas
7d0d61d854 Rewrite ERT manual introduction
* doc/misc/ert.texi (Top): Rewrite for clarity.  Don't give such
prominent mention to to TDD or JUnit, references which now seem dated.
2025-03-09 19:38:54 +01:00
Po Lu
1b80bc67aa ; * doc/emacs/android.texi (Android Software): Minor markup nits. 2025-03-04 14:30:31 +08:00
Po Lu
b09bbf22af Document requirements respecting XDG MIME databases on Android
* doc/emacs/android.texi (Android Software): State that librsvg
requires a MIME database to display embedded images, and how to
acquire such a database.
2025-03-04 14:29:37 +08:00
Stefan Kangas
7dcf9b71e6 ; Don't document package-x.el
* doc/lispref/package.texi (Package Archives): Delete documentation on
package-x.el, since it's obsolete in Emacs 31 and we want to discourage
its use.
2025-03-02 05:09:37 +01:00
Eli Zaretskii
44a770b871 ; Improve documentation of 'rmail-movemail-program'
* lisp/mail/rmail.el (rmail-movemail-program):
* doc/emacs/rmail.texi (Movemail): Document how to change the
value of 'rmail-movemail-program' safely.  (Bug#76595)
2025-03-01 15:45:57 +02:00
Eli Zaretskii
bd1d6761f4 ; Document what happens when 'display' and 'invisible' props clash
* doc/lispref/display.texi (Replacing Specs, Overlay Properties)
(Invisible Text): Document that 'invisible' is ignored when
'display' property covers the same text.  (Bug#76658)
2025-03-01 12:59:32 +02:00
Stefan Kangas
526eeedf88 keymaps.texi: Move "Changing Key Bindings" section up
* doc/lispref/keymaps.texi (Changing Key Bindings): Move section
up.  (Bug#52821)
2025-03-01 06:36:43 +01:00
Stefan Kangas
7ec6531c7b keymaps.texi: Move "Key Sequences" section down
* doc/lispref/keymaps.texi (Key Sequences): Move section
down.  (Bug#52821)
2025-03-01 06:36:43 +01:00
Stefan Kangas
fa42626a6a ; Fix indentation in cl.texi example 2025-02-26 18:32:32 +01:00
Eli Zaretskii
f88dc0f2f9 ; Fix documentation of 'buffer-text-pixel-size'
* doc/lispref/display.texi (Size of Displayed Text): Fix arguments
of 'buffer-text-pixel-size'.  (Bug#76519)
2025-02-26 14:52:26 +02:00
Po Lu
734986349f ; Minor Android documentation improvements
* doc/emacs/android.texi (Android Startup, Android File System)
(Android Document Providers): Improve phrasing.
2025-02-26 15:10:27 +08:00
Basil L. Contovounesios
02c830ba22 Fix ert-font-lock macro signatures
* doc/misc/ert.texi (Syntax Highlighting Tests):
* test/lisp/emacs-lisp/ert-font-lock-tests.el
(test-line-comment-p--emacs-lisp, test-line-comment-p--shell-script)
(test-line-comment-p--javascript, test-line-comment-p--python)
(test-line-comment-p--c, test-macro-test--correct-highlighting)
(test-macro-test--docstring, test-macro-test--failing)
(test-macro-test--file, test-macro-test--file-no-asserts)
(test-macro-test--file-failing): Reindent macro calls.
(with-temp-buffer-str-mode): Evaluate macro arguments left-to-right.
(ert-font-lock--wrap-begin-end): Use rx for more robust composition.
(test-line-comment-p--php): Require that php-mode is callable, not
already loaded.

* lisp/emacs-lisp/ert-font-lock.el (ert-font-lock-deftest)
(ert-font-lock-deftest-file): NAME is not followed by an empty list
like in ert-deftest, so the optional DOCSTRING is actually the
second argument.  Adapt calling convention in docstring, and debug,
doc-string, and indent properties accordingly (bug#76372).  Fix
docstring grammar, document MAJOR-MODE, and avoid referring to a
file name as a path.
2025-02-25 11:02:55 +01:00
Ulrich Müller
94c0ea39a5 * doc/misc/efaq.texi (New in Emacs 30): Fix typo. (Bug#76518) 2025-02-24 10:32:47 +01:00
Stefan Kangas
3c9b1c3cd1 Don't document deleted xwidget functions
* doc/lispref/display.texi (Xwidgets): Don't document deleted function
xwidget-webkit-execute-script-rv.  Fix name of deleted and then re-added
function xwidget-webkit-title.
2025-02-23 20:47:34 +01:00
Stefan Kangas
9e9b78dda9 ; Improve lsh and ash documented argument names
* doc/lispref/numbers.texi (Bitwise Operations): Improve lsh and
ash argument names.
2025-02-23 20:47:34 +01:00
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