Commit graph

3952 commits

Author SHA1 Message Date
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
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
F. Jason Park
6036e0dadf Backport: Don't autoload erc-modules
* doc/misc/erc.texi (Modules): Recommend using `describe-variable'
instead of `customize-option' because the latter needs the symbol to be
loaded.
* lisp/erc/erc.el (erc-modules): Remove autoload cookie because it
caused customizations for this option to load the main library.  This
reverts the thrust of bb894845 "Teach customize-option about
erc-modules", which was added in ERC 5.6 and Emacs 30.  The motivation
for the original offending change was to allow new users to run M-x
customize-option RET erc-modules RET immediately after startup instead
of M-x customize-group RET, followed by an I-search.  (Bug#73812)

(Cherry picked from commit 1854f2751e)

Do not merge to master.
2024-11-16 08:17:46 -08:00
Robert Pluim
68337106f9 ; Fix TRAMP manual indexing
* doc/misc/tramp.texi (Inline methods):
(External methods):
(GVFS-based methods):
(FUSE-based methods):
(Customizing Methods):
(Remote shell setup):
(Change file name syntax):
(Archive file names):
(Frequently Asked Questions): Make sure @item comes after
@cindex and similar indexing commands.
2024-11-15 11:32:30 +01:00
Robert Pluim
8f6ff233ef ; TRAMP manual spelling and grammar fixes
* doc/misc/tramp.texi (FUSE-based methods):
(Firewalls):
(Predefined connection information):
(Remote programs):
(Remote shell setup):
(Ssh setup):
(Home directories):
(Remote processes):
(Renaming remote files):
(Archive file names):
(Bug Reports):
(Frequently Asked Questions): Use "can" instead of "could" where
it makes sense.
2024-11-14 13:56:04 +01:00
Michael Albinus
c96e576090 Precise password cache in Tramp
* doc/misc/tramp.texi (Password handling):
Describe auth-source-cache-expiry and auth-source-do-cache instead
of password-cache-expiry and password-cache.  (Bug#74105)

* lisp/net/tramp.el (tramp-read-passwd): Check for `auth-sources'
being non-nil.
2024-11-10 12:35:15 +01:00
Eli Zaretskii
b1be0f2ba6 Document issues with 'use-package's ':custom' and byte compilation
* doc/misc/use-package.texi (User options): Warn against
byte-compiling init files that use ':custom'.  (Bug#73609)
2024-11-09 11:55:49 +02:00
Michael Albinus
03fa832b4d Improve Tramp documentation on direct async processes
* doc/misc/tramp.texi (Remote processes): Add another example
enabling direct async processes based on method name.  (Bug#74105)

* etc/NEWS: Rephrase Tramp entry on direct async processes.
2024-11-03 15:48:19 +01:00
Stefan Kangas
67a27ff53b ; Fix typos 2024-10-27 07:49:32 +01:00
Eli Zaretskii
a61bf74225 New FAQ about Ctrl keys on xterm
* doc/misc/efaq.texi
(Some Ctrl-modified keys do not work on xterm): New section
(bug#73813).
2024-10-19 12:14:06 +03: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
João Távora
cd36e070c2 Eglot: minor changes to doc and docstrings
* doc/misc/eglot.texi (Quick Start): Tweak.
(Setting Up LSP Servers): Tweak.
(Customizing Eglot): Clarify eglot-connect-hook and
eglot-initialized-hook.

* lisp/progmodes/eglot.el (eglot-connect-hook)
(eglot-server-initialized-hook): Rework docstring.
2024-10-09 06:26:27 -05: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
Stefan Monnier
68f53e4348 eieio.texi: Fix bug#73505
* doc/misc/eieio.texi (Introduction): Remove "missing features" which
aren't missing any more.
(Generics, Methods): Delete sections.
(Inheritance): Adjust reference accordingly.
(Static Methods): Merge into the parent node.
(Writing Methods): Refer to the ELisp manual for `cl-defmethod/defgeneric`.
2024-09-27 10:35:18 -04:00
Jonas Bernoulli
ffc00eac53
; Set Transient's version and add admin/MAINTAINERS entry
* admin/MAINTAINERS: Add entry for externally maintained Transient
package.
* doc/misc/transient.texi: Bump version strings.
* lisp/transient.el: Bump version in Version header.
* lisp/transient.el (transient-version): New constant.
2024-09-14 19:23:40 +02:00
Stefan Kangas
d66b70f360 * doc/misc/auth.texi: Minor copy edits. 2024-09-13 00:18:37 +02:00
Eli Zaretskii
04c44405bf Fix alignment and documentation of vtable.el
* lisp/emacs-lisp/vtable.el (vtable--insert-header-line): Ensure
proper alignment between the columns in header-line and in the
body of the table.  (Bug#73032)

* doc/misc/vtable.texi (Making A Table): Document the defaults of
the various keyword parameters.
2024-09-07 11:27:03 +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
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
Stefan Kangas
e6c72aec9d ; Fix typos 2024-08-29 00:17:10 +02:00
Eli Zaretskii
52829bcee6 ; Fix bad references to other manuals
* doc/misc/bovine.texi (top, Optional Lambda Expression)
(Starting Rules, Bovine Grammar Rules, How Lexical Tokens Match):
* doc/misc/eudc.texi (Overview, Creating BBDB Records)
(Inline Query Expansion):
* doc/misc/dbus.texi (Top):
* doc/misc/efaq.texi (Top):
* doc/misc/wisent.texi (Wisent Semantic, Wisent Lex): Fix
cross-references to other manuals.  Remove redundant pointers from
Top node.  (Bug#72761)

(cherry picked from commit 7319f5e078)
2024-08-25 13:59:22 +03:00
Eli Zaretskii
6a512ab032 Fix a typo in Eglot manual
* doc/misc/eglot.texi (Eglot and Buffers): Fix typo.  Patch by
david edmonds <edmonds.david.a@gmail.com>.  (Bug#72634)
2024-08-17 13:07:56 +03:00
Eli Zaretskii
4f3e8c3b4e Improve documentation of ERT
* doc/misc/ert.texi (Running Tests Interactively)
(Test Selectors):
* lisp/emacs-lisp/ert.el (ert-select-tests)
(ert-run-tests-interactively, ert-run-tests-batch): Improve and
clarify the documentation of the main ERT functions.
2024-08-15 11:30:48 +03:00
Po Lu
c49724b964 ; Grammar fixes
* doc/misc/erc.texi (Connecting):

* lisp/erc/erc.el (erc-compute-server, erc-compute-nick)
(erc-compute-full-name, erc-compute-port): Replace "a number of
increasingly more" with an alternative more grammatical.
2024-08-12 08:10:36 +08:00
Stefan Kangas
a799661566 Standardize possessive apostrophe usage in manuals, docs, and comments
See the note in admin/notes/documentation.
Ref: https://lists.gnu.org/r/emacs-devel/2012-02/msg00649.html
2024-07-25 03:35:18 +02:00
Eli Zaretskii
cb633820c1 ; * doc/misc/use-package.texi (Getting Started): Fix wording. 2024-07-24 14:01:01 +03:00
Stefan Kangas
05629d3af0 Delete redundant "a.k.a." in use-package.texi
* doc/misc/use-package.texi (Getting Started): Delete redundant
acronym "a.k.a.".  (Bug#66350)
2024-07-23 23:32:56 +02:00
Stefan Kangas
c7609464f7 Document (use-package 'emacs) declarations
* doc/misc/use-package.texi (The @code{emacs} package): New
node.  (Bug#66350)
2024-07-23 15:16:27 +02:00
Stefan Kangas
c1382257aa ; Fix typo in use-package.texi
* doc/misc/use-package.texi (Getting Started): Fix typo.
Problem reported by GitHub user Paul Jensen (psnj) in:
https://github.com/jwiegley/use-package/pull/1070/
2024-07-22 18:07:29 +02:00
Stefan Kangas
9b426e15ab Correctly typeset nil and t in texinfo
* doc/emacs/package.texi (Fetching Package Sources):
* doc/lispref/display.texi (Image Descriptors):
* doc/lispref/windows.texi (Buffer Display Action Alists):
* doc/misc/gnus-faq.texi (FAQ 5-4): Correctly typeset nil and t.
2024-07-22 10:14:51 +02:00
Stefan Kangas
00adee897a ; Fix punctuation in docs 2024-07-21 17:35:13 +02:00
James Thomas
ea30ffc52b ; * doc/misc/gnus.texi (Agent Caveats): Fix doc
* doc/misc/gnus.texi (Agent Caveats): Change doc due to commit
2020-10-16 "Add a new variable to control Gnus Agent caching"
(41d220dc60, bug#43356).  (Bug#72134)
2024-07-20 11:58:20 +03:00
Stefan Kangas
a6cab228d4 ; Fix typos 2024-07-18 11:46:50 +02:00
Michael Albinus
85d2d7982d Update Tramp manual
* doc/misc/tramp.texi (Remote processes): Add another reason why a
direct asynchronous process could fail.
2024-07-17 17:57:20 +02:00
Steven Allen
fe28ba5d55 ; Replace quotes with @code{...} in texinfo files
* doc/misc/cc-mode.texi:
* doc/misc/cl.texi: Replace quotes with @code{...}
2024-07-15 18:20:24 +02:00
Steven Allen
ecc8516d9c ; Replace (non-)nil with (non-)@code{nil} in texinfo files
* doc/lispref/functions.texi:
* doc/lispref/keymaps.texi:
* doc/lispref/strings.texi:
* doc/misc/cl.texi:
* doc/misc/dbus.texi:
* doc/misc/eshell.texi:
* doc/misc/message.texi:
* doc/misc/ses.texi:
* doc/misc/vtable.texi: Replace (non-)nil with (non-)@code{nil}.
2024-07-15 18:16:41 +02:00
Jonas Bernoulli
04bf3172f0
; Set Transient's version 2024-07-13 21:59:20 +02:00
Michael Albinus
7de4dbea08 Adapt Tramp's "run0" method
* doc/misc/tramp.texi (Inline methods):
* etc/NEWS: Adapt "run0" entry.

* lisp/net/tramp-sh.el (tramp-enable-run0-method): Adapt "run0"
arguments.
2024-07-10 11:58:22 +02:00
Jim Porter
37475c9af7 Document Eshell entry points
* doc/misc/eshell.texi (Entry Points): New chapter.
(Scripts): Move under Entry Points.  Expand documentation.
2024-07-09 10:03:35 -07:00
Michael Albinus
069fa63909 Adapt Tramp version (don't merge)
* doc/misc/trampver.texi:
* lisp/net/trampver.el (tramp-version): Adapt Tramp versions.
2024-07-07 19:35:06 +02:00
Stefan Kangas
f39cf0beb7 Focus more on MS-Windows than MS-DOS in FAQ
* doc/misc/efaq.texi (Editing Windows files): Rename section from
"Editing MS-DOS files", and update the text to focus on Windows.
* doc/misc/efaq.texi (Colors on a TTY)
(Emacs does not display 8-bit characters): Mention MS-Windows before
MS-DOS.
2024-07-03 02:08:19 +02:00
Stefan Kangas
9d62dbc1f7 Backport file backup FAQ item to Emacs <28
* doc/misc/efaq.texi (Not writing files to the current directory):
Backport recommendation to Emacs 27 or older.
Problem reported by David Hedlund <davidh@gnu.org>.
2024-07-01 01:50:51 +02:00
Po Lu
72cf9964f3 Inaccuracy in efaq.texi
; * doc/misc/efaq.texi (New in Emacs 30): Mention GNUStep and
Mac OS separately.
2024-06-30 10:04:43 +08:00
Michael Albinus
ea8ce98434 * doc/misc/efaq.texi (New in Emacs 30): Fix typos. 2024-06-29 18:42:13 +02:00
Stefan Kangas
d95f039af4 Document security fixes in FAQ
* doc/misc/efaq.texi (New in Emacs 29): Recommend using Emacs 29.4.
* doc/misc/efaq.texi (Security risks with Emacs): New item with a
recommendation to upgrade Emacs for improved security.
2024-06-29 17:03:18 +02:00
Stefan Kangas
d063af203c Add "New in Emacs 30" to FAQ
* doc/misc/efaq.texi (New in Emacs 30): New section.
2024-06-29 16:45:23 +02:00
Jonas Bernoulli
5f3d964e39
Update to Transient v0.7.2-4-gf75bc48d 2024-06-29 14:06:12 +02:00
Eli Zaretskii
219501dd62 ; Fix use of @footnote in cc-mode.texi
* doc/misc/cc-mode.texi (Comment Commands, Minor Modes)
(Hungry WS Deletion): Move @footnote's out of @item's, to avoid
warnings from makeinfo.
2024-06-29 11:55:08 +03:00