1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-04 22:50:59 -08:00
Commit graph

12314 commits

Author SHA1 Message Date
Stefan Kangas
ad47beb823 Remove gmane.org support from nnweb
* lisp/gnus/nnweb.el (nnweb-type, nnweb-type-definition): Remove gmane.
(nnweb-gmane-create-mapping, nnweb-gmane-wash-article)
(nnweb-gmane-search, nnweb-gmane-identity): Make obsolete.
(nnweb-definition, nnweb-init): Raise user-error when 'nnweb-type' is
'gmane'.
* doc/misc/gnus.texi (Registry Article Refer Method): Update
example to not use gmane.org.
Ref: https://gmane.io/
2023-10-24 00:52:17 +02:00
Stefan Kangas
cc3e436c82 Change news.gmane.org to news.gmane.io
* admin/notes/emba:
* doc/misc/gnus.texi (Group Parameters)
(Non-ASCII Group Names, Filling In Threads)
(Selection Groups, Spam Package Configuration Examples)
(Terminology):
* lisp/gnus/gnus-group.el (gnus-useful-groups):
* lisp/gnus/gnus-sum.el (gnus-fetch-old-headers):
* lisp/gnus/spam-report.el (spam-report-gmane-use-article-number)
(spam-report-gmane-internal):
* test/lisp/gnus/gnus-group-tests.el (gnus-short-group-name):
Change news.gmane.org to news.gmane.io.
Ref: https://news.gmane.io/
2023-10-24 00:39:47 +02:00
Lin Sun
3beb5f5e24 ; * doc/misc/gnus.texi: Fix unmatched quote in gnus doc. (Bug#66710) 2023-10-23 21:52:58 +03:00
Michael Albinus
85d08d5788 Minor connection-local variables fixes
* doc/emacs/custom.texi (Connection Variables): Warn about
specifying the same variable twice.

* lisp/files-x.el (connection-local-get-profiles): Normalize criteria.
2023-10-23 17:07:17 +02:00
Mattias Engdegård
9e002ef9c0 Modernise text about using dynamic variables
* doc/lispref/variables.texi (Dynamic Binding Tips):
Give more useful advice.
2023-10-23 14:48:42 +02:00
Mattias Engdegård
dfee22c312 Elaborate Elisp dialect selection in manual
* doc/lispref/variables.texi (Using Lexical Binding): Rename to...
(Selecting Lisp Dialect): ...this.  All references updated.
Add concrete examples of -*- lines.
Move text about special variables from here...
(Dynamic Binding): ...to here.
2023-10-23 14:48:42 +02:00
Mattias Engdegård
7e4a4b762e Describe lexical binding before dynamic
* doc/lispref/variables.texi (Variable Scoping)
(Lexical Binding, Dynamic Binding):
Alter the presentation order from the point of view that lexical
binding is the standard discipline (if not always the default) and
dynamic binding an alternative, which corresponds better to Elisp
today.  Modernise parts of the text.
* doc/lispref/elisp.texi (Top): Update menu.
2023-10-23 14:48:42 +02:00
Mattias Engdegård
48e7f5493e Improved eval documentation
Prompted by Michael Heerdegen.

* src/eval.c (Feval):
* doc/lispref/eval.texi (Eval):
Be more precise about the LEXICAL argument.
2023-10-23 14:48:42 +02:00
Po Lu
baf14aa16a Rewrite Yank Media node in the Emacs Lisp manual
* doc/lispref/frames.texi (Other Selections): Introduce a
reference to Accessing Selections, then rewrite for clarity and
to stop mentioning MIME types by name, for selection data types
are not confined to those.
2023-10-23 11:16:07 +00:00
Po Lu
731dd5f92e ; * doc/lispref/frames.texi (X Selections): Fix typo. 2023-10-23 08:03:49 +00:00
Po Lu
d33a72e8d7 Further improve documentation concerning selections
* doc/lispref/frames.texi (Window System Selections): Replace
incomplete attempts to address selection data types in this node
with references to Accessing Selections.
(Accessing Selections, X Selections): Revise for clarity and
pithiness.
2023-10-23 02:32:09 +00:00
Mauro Aranda
9be8011217 Allow specifying the dir locals file to edit (Bug#66663)
* lisp/files-x.el (modify-dir-local-variable): Take a 5th optional
argument, the filename of the dir locals file to modify.
(read-dir-locals-file): New function.
(add-dir-local-variable, delete-dir-local-variable)
(copy-file-locals-to-dir-locals): Optionally read the filename to
modify, and pass it to modify-dir-local-variable.
* etc/NEWS: Announce the change.
* doc/emacs/custom.texi (Directory Variables): Document the new
functionality.
2023-10-22 20:54:15 +03:00
Po Lu
4ff0c738d0 Further improve selection-related documentation
* doc/lispref/frames.texi (Other Selections): Expand
documentation regarding Haiku selections, and some
non-substantive copy edits elsewhere.  Introduce more indexing.
2023-10-22 19:43:27 +08:00
Eli Zaretskii
27c71979ff ; Another Texinfo fix
* doc/lispintro/emacs-lisp-intro.texi (Counting function
definitions):  Fix Texinfo 7.1 warning.
2023-10-22 14:05:53 +03:00
Eli Zaretskii
889a550ca0 ; Fix Texinfo warnings
* doc/misc/wisent.texi (Grammar format):
* doc/misc/efaq.texi (Not writing files to the current directory):
* doc/misc/ede.texi:
* doc/lispref/errors.texi (Standard Errors): Fix warnings emitted
by makeinfo 7.1.
2023-10-22 12:21:08 +03:00
Po Lu
ae33788410 Revise documentation concerning selections outside X
* doc/lispref/frames.texi (Accessing Selections, X Selections):
Correct markup, averting the recognition of X followed by a
sentence stop as an acronym.
(Other Selections): Relate the nature of the MS-Windows
selection emulation, how it functions, and its deficiencies.
Clarify paragraphs concerning PGTK and Nextstep.

* doc/misc/efaq.texi (Emacs in a Linux console):

* doc/misc/use-package.texi (Conditional loading): Correct
markup, averting the recognition of X followed by a sentence
stop as an acronym.
2023-10-22 07:55:12 +00:00
Yuan Fu
aa6cb41661
Documentation for treesit-font-lock-rules change
* doc/lispref/modes.texi (Parser-based Font Lock): Update manual.
* lisp/treesit.el (treesit-font-lock-rules): Update docstring.
2023-10-21 11:07:30 -07:00
Eli Zaretskii
12c8cdb60c Merge from origin/emacs-29
b99d12c30c ; Fix argument name for function `copy-file'
2023-10-21 08:06:09 -04:00
Eli Zaretskii
52f25b791e Merge from origin/emacs-29
ab9d6482e3 ; Update ChangeLog.4 and etc/AUTHORS.
d9e1605122 Correctly register focus events concomitant with alpha ch...
194e219825 * doc/man/emacsclient.1: Add missing options.
2023-10-21 08:06:07 -04:00
Mattias Engdegård
9c82f48059 Move and edit text about lexical environment representation
It's only relevant for the second argument to `eval`; the actual
internal representation is an implementation matter and usually
different from what was described here.

* doc/lispref/variables.texi (Lexical Binding): Move the relevant
part of the description of the internal representation of
lexical environments from here...
* doc/lispref/eval.texi (Eval): ...to here, where it belongs.
2023-10-21 13:10:56 +02:00
Stefan Monnier
c94b6397bd (buffer-match-p): Replace &optional with &rest (bug#65797)
* lisp/subr.el (buffer-match-p--past-warnings): New var.
(buffer-match-p): Use it.  Replace `&optional arg` with `&rest args`.
(match-buffers): Replace `&optional arg` with `&rest args`.

* lisp/window.el (display-buffer-alist): Fix out of date docstring.

* doc/lispref/buffers.texi (Buffer List): Document new calling convention.
2023-10-20 20:42:04 -04:00
Stefan Monnier
696411ab8a (sleep-for): Make the millisec argument obsolete
* lisp/subr.el (sleep-for): Set new advertized calling convention.
* src/dispnew.c (Fsleep_for): Adjust docstring.
* doc/lispref/commands.texi (Waiting): Adjust doc.
2023-10-20 18:59:51 -04:00
F. Jason Park
a74b5de31f Warn about top-level erc-update-modules calls
* doc/misc/erc.texi (Modules): Describe unfavorable practices enacted
by third-party modules, like running `erc-update-modules' on load.
* lisp/erc/erc.el (erc-modules): Clarify comment in `custom-set'
function.
(erc--warn-about-aberrant-modules): Tweak warning message.
(erc--requiring-module-mode-p): New internal variable.
(erc--find-mode): Guard against recursive `erc-update-module'
invocations.  (Bug#57955)
2023-10-20 14:53:24 -07:00
Jens Schmidt
b99d12c30c ; Fix argument name for function `copy-file'
* doc/lispref/files.texi (Changing Files): Change name of last
argument of function `copy-file' from `preserve-extended-attributes'
to `preserve-permissions', as used in the function's description, its
doc string and the description below in the manual.
2023-10-20 09:04:39 +03:00
Michael Albinus
62920dcb0d Update Tramp version (don't merge with master)
* doc/misc/trampver.texi:
* lisp/net/trampver.el: Change version to "2.6.2.29.2".
(customize-package-emacs-version-alist):
Adapt Tramp version integrated in Emacs 29.2.
2023-10-19 16:28:26 +02:00
F. Jason Park
b4b4b5f431 Improve SOCKS error handling and support version 4a
* doc/misc/url.texi: Mention version 4a in SOCKS portion of "Gateways
in general" node.
* etc/NEWS: Mention version 4a support in new `socks' section.
* lisp/net/socks.el (socks-server): Add new Custom choice `4a' for
version field.  This change does not further overload the field in
terms of expected type because `socks-send-command' and `socks-filter'
already accommodate the symbol `http'.
(socks--errors-4): Add new constant containing error messages for
version 4.  The semantics are faithful to the de facto spec, but the
exact wording is slightly adapted.
(socks-filter): Allow for a null "type" field on error with version 5.
Previously, certain errors would not propagate because a wrong-type
signal would get in the way.
(socks-send-command): Massage existing version 4 protocol parsing to
accommodate 4a, and add error handling for version 4.  Use variable
`socks-username' for v4 variable-length ID field instead of calling
`user-full-name', which has potential privacy implications.
* test/lisp/net/socks-tests.el (socks-tests-v4-basic): Don't mock
`user-full-name' because `socks-send-command' no longer calls it to
determine the ID.
(socks-tests-v4a-basic, socks-tests-v4a-error): Add a couple tests for
SOCKS version 4a.  (Bug#53941)
2023-10-18 06:23:57 -07:00
Gerd Möllmann
40c9e9d2e6 Gud lldb support (bug#66575)
* lisp/progmodes/gud.el (lldb): New command.
* etc/NEWS: Mention M-x lldb.
* src/.lldbinit: Show no souece lines on stop.
* doc/emacs/building.texi: Mention LLDB.
2023-10-17 19:14:59 +02:00
Michael Albinus
194e219825 * doc/man/emacsclient.1: Add missing options. 2023-10-16 12:41:32 +02:00
Michael Albinus
2071904d51 Merge from origin/emacs-29
07c45f20fd Fix test in files-tests
5d3f3288d2 ; * doc/emacs/search.texi (Regexp Backslash): Improve ind...
9525315c11 Add missing :version to two defcustoms
9044d4d94b Fix a defcustom :type in eldoc.el
8141d73ea7 Document 'M-x align' in the Emacs manual
2023-10-16 09:02:39 +02:00
Eli Zaretskii
5d3f3288d2 ; * doc/emacs/search.texi (Regexp Backslash): Improve indexing. 2023-10-15 12:37:25 +03:00
Po Lu
47ddff8ae8 ; Correct typos in android.texi
* doc/emacs/android.texi (Android Environment): Correct typos.
2023-10-15 15:02:43 +08:00
Eshel Yaron
8141d73ea7 Document 'M-x align' in the Emacs manual
* doc/emacs/indent.texi (Alignment): New section.
* doc/emacs/emacs.texi: Update menu. (Bug#66303)
2023-10-14 14:16:13 +03:00
Eli Zaretskii
fe110cb611 Merge from origin/emacs-29
06a8773811 ; * lisp/calendar/time-date.el (days-to-time): Doc fix.
0ea2d6d9e8 Document that time-to-days and days-to-time use different...
2023-10-14 06:55:05 -04:00
Bob Rogers
0ea2d6d9e8 Document that time-to-days and days-to-time use different epochs
* doc/lispref/os.texi (Time Calculations):
* lisp/calendar/time-date.el (days-to-time, time-to-days): Doc fixes.
(Bug#66502)
2023-10-14 11:57:30 +03:00
Stefan Monnier
9ecb595dea (sit-for): Remove support for old calling convention
* lisp/subr.el (sit-for): Remove support for old calling convention

* doc/lispref/functions.texi (Obsolete Functions): Adjust wording now
that we don't support `sit-for`s old convention any more.
* doc/lispref/commands.texi (Waiting): Remove mention of old calling
convention for `sit-for`.
2023-10-13 19:28:30 -04:00
F. Jason Park
d46c016fbd Sort and dedupe when loading modules in erc-open
* doc/misc/erc.texi: Add new subheading "Module Loading" under the
"Modules" chapter.
* lisp/erc/erc.el (erc--sort-modules): New utility function to sort
and dedupe modules.
(erc-modules): In `custom-set' function, factor out collation into
separate utility `erc--sort-modules'.
(erc-update-modules): Call `erc--update-modules' with an argument, the
current value of `erc-modules'.
(erc--aberrant-modules): New variable, a list of symbols whose modules
ERC suspects of being incorrectly defined.
(erc--warn-about-aberrant-modules): New function to print an error
message and emit a warning prior to connecting when
`erc--aberrant-modules' is non-nil.
(erc--find-mode): Make heuristic more robust by always checking for a
mode activation command rather than just a state variable.  This fixes
a compatibility bug, new in 5.6, affecting third-party modules that
autoload module definitions instead of their corresponding
mode-activation commands.
(erc--update-modules): Add new positional argument `modules'.
(erc--setup-buffer-hook): Add new default member,
`erc--warn-about-aberrant-modules'.
(erc-open): Pass sorted `erc-modules' to `erc--update-modules'.
* test/lisp/erc/erc-tests.el (erc--sort-modules): New test.
(erc-tests--update-modules): New fixture.
(erc--update-modules): Remove and rework as three separate tests
dedicated to specific contexts.  The existing one had poor coverage
and was difficult, if not impossible, to follow.
(erc--update-modules/unknown, erc--update-modules/local,
erc--update-modules/realistic): New tests.  (Bug#57955)
2023-10-13 07:47:00 -07:00
Michael Albinus
9f83b46bee Merge from origin/emacs-29
53292c5d81 Fix treesit-query-validate for string input (bug#66400)
81a0c1ed2e ; Improve documentation of VC commands
0590e3e69a Recommend `M-x man` in woman.el docs
809da7fc9a ; * doc/lispref/processes.texi (Process Buffers): More ac...
8f23a02a9e Fix updating process-mark position in 'set-process-buffer'
2023-10-13 16:16:19 +02:00
Po Lu
c6f07e13ee Enable highlighting Gud execution lines without hl-line-mode
* doc/emacs/building.texi (Debugger Operation): Mention two new
options and the relationship between Gud and HL Line Mode.

* etc/NEWS (Editing Changes in Emacs 30.1): Mention the new
option.

* lisp/progmodes/gud.el (gud-highlight-current-line-overlay):
New variable.
(gud-sentinel) <signal, exit>: Delete that overlay if set.
(gud-highlight-current-line, gud-highlight-current-line-face):
New user options.
(gud-display-line): Create and move an overlay without employing
hl-line-mode, if so enjoined by the user.
2023-10-12 21:46:54 +08:00
Alan Mackenzie
cfed3bb395 Document cl-print.el in cl.texi.
* doc/misc/cl.texi: (Printing): New chapter which documents
cl-print.el.

* NEWS (cl-print): Add "+++" markings to all the subitems,
which have now been documented.
2023-10-11 15:03:43 +00:00
Po Lu
41b83e8993 Remedy typo in android.texi
* doc/emacs/android.texi (Android Fonts): Replace @xref with
@pxref.
2023-10-11 18:48:27 +08:00
Michael Albinus
f7185ca29b File notifications report unmount events (bug#66381)
* doc/lispref/os.texi (File Notifications): Unmounting a watched
filesystem is reported now.

* etc/NEWS: File notifications report unmount events now.
Fix typos.

* lisp/filenotify.el (file-notify--callback-inotify)
(file-notify--add-watch-inotify): Handle `unmount'.
(file-notify--callback-kqueue, file-notify--add-watch-kqueue):
Handle `revoke'.
(file-notify--callback-gfilenotify): Handle `unmounted'.
(file-notify-callback): Handle `unmount' and `unmounted'.
(file-notify--add-watch-inotify):

* lisp/net/tramp-gvfs.el (tramp-gvfs-handle-file-notify-add-watch):
Handle `unmounted'.

* lisp/net/tramp-sh.el (tramp-sh-handle-file-notify-add-watch):
Handle `unmount' and `unmounted'.

* src/gfilenotify.c (dir_monitor_callback): Handle Qunmounted.

* src/inotify.c (symbol_to_inotifymask): Handle IN_IGNORED and
IN_UNMOUNT.

* src/kqueue.c (kqueue_callback, Fkqueue_add_watch):
Handle NOTE_REVOKE.
(Fkqueue_add_watch): Adapt docstring.
(syms_of_kqueue): Declare `revoke.
2023-10-10 19:51:22 +02:00
Ulrich Müller
294567d171 ; Fix spelling of my name in all source files 2023-10-10 16:31:53 +02:00
Mattias Engdegård
c34a425d4d Correct temperature names in Calc
* doc/misc/calc.texi (The Units Table, Predefined Units):
* lisp/calc/calc-units.el (math-standard-units):
It's just Kelvin, not degree Kelvin.
2023-10-10 14:28:27 +02:00
Po Lu
36d47f24db * doc/emacs/android.texi (Android Software): Fix typo. 2023-10-10 20:16:27 +08:00
Eli Zaretskii
d51f3165f7 Improve documentation of 'project-mode-line'
* etc/NEWS:
* doc/emacs/maintaining.texi (Projects):
* lisp/progmodes/project.el (project-mode-line): Improve the
documentation of 'project-mode-line'.  (Bug#66317)
2023-10-10 14:46:08 +03:00
Po Lu
60e3071d57 Revise Android documentation
* doc/emacs/android.texi (Android Environment, Android Windowing)
(Android Fonts, Android Troubleshooting, Android Software):
Correct typos and improve wording.
2023-10-10 19:34:56 +08:00
Po Lu
b504faf003 Improve documentation of inhibit-double-buffering
* doc/lispref/frames.texi (Management Parameters): Reword joke
and mention the precise circumstances where
inhibit-double-double-buffering is useful.
2023-10-10 16:58:21 +08:00
Eli Zaretskii
81a0c1ed2e ; Improve documentation of VC commands
* doc/emacs/maintaining.texi (Basic VC Editing)
(VC With A Merging VCS, VC With A Locking VCS, Advanced C-x v v)
(Registering, Pulling / Pushing, Merging): Improve wording,
accuracy, and indexing.

* lisp/vc/vc.el (vc-next-action): Doc fix.
2023-10-08 11:29:29 +03:00
Eli Zaretskii
809da7fc9a ; * doc/lispref/processes.texi (Process Buffers): More accurate wording. 2023-10-07 19:09:58 +03:00
Eli Zaretskii
1c9ddf3948 Merge from origin/emacs-29
e9b88f61cc Fix a defcustom :type
3216cd9695 Fix pulse-flag :type
2065ab5562 Fix defcustoms in timeclock.el
bdd3013249 ; * lisp/image-mode.el (image-mode-to-text, image-mode-as...
5c2d9ae48e ; * lisp/image-mode.el: Fix typos in doc strings (bug#663...
fa0d3f45ae ; Improve wording of last change
3ef259e28a Improve documentation of `ns-use-proxy-icon`
712505a82b Document assigning libraries to packages in make-tarball.txt
6bdc5cfe38 Doc fix; more consistently refer to "text terminals"
d210d761b1 ; Fix doc strings of overlay-arrow variables
4fd00ff1f7 Fix defcustoms in type-break.el (Bug#66210)
47770b0eca Fix term-scroll-to-bottom-on-output :type
f8bdc8dff0 ; Normalize GNU ELPA :core package statements
63ec6d998d ; * doc/emacs/custom.texi (Early Init File): Improve inde...
a4185f87bd ; Silence macOS 14 warning
d9d6e14a69 ; * lisp/vc/vc.el (vc-next-action): Improve commentary.
d558f38fe5 ; * lisp/emacs-lisp/let-alist.el (let-alist): Fix quoting...
71feee7930 Doc fix in let-alist for keys with nil value
72cc9cf2cd ; Fix typos
2023-10-07 03:46:48 -04:00