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

9147 commits

Author SHA1 Message Date
Stefan Kangas
4fd5c8df67 Clarify abnormal hook documentation
* doc/lispref/hooks.texi (Standard Hooks):
* doc/lispref/modes.texi (Hooks): Clarify wording of "abnormal
hook" documentation.  (Bug#34588)
2021-10-23 20:03:34 +02:00
Kyle Meyer
6fa5206770 Update to Org 9.5-59-g52e6f1 2021-10-23 13:46:59 -04:00
Eli Zaretskii
39413a45bf ; * doc/lispref/functions.texi (Calling Functions): Fix last change. 2021-10-23 20:44:26 +03:00
Stefan Kangas
43914ab01f Improve documentation of cl-reduce
* doc/misc/cl.texi (Mapping over Sequences): Change the
explanation of 'cl-reduce' so you don't need to have a major in
mathematics to understand it.  (Bug#24014)
2021-10-23 19:20:56 +02:00
Stefan Kangas
ef37a86cac Improve documentation of apply-partially
* doc/lispref/functions.texi (Calling Functions): Improve
documentation of 'apply-partially' to be slightly more clear with
regards to function arity.  (Bug#17623)
2021-10-23 18:47:00 +02:00
Michael Albinus
1e8be48738 Fix typos
* doc/emacs/cmdargs.texi:
* etc/DEBUG:
* etc/NEWS: Fix typos.
2021-10-23 15:21:33 +02:00
Stefan Kangas
cdbd03345d Fix documentation of posn-at-x-y
* doc/lispref/commands.texi (Accessing Mouse): Fix documentation of
'posn-at-x-y' to match docstring.  (Bug#15783)
2021-10-23 09:45:23 +02:00
Robert Pluim
7fde84e881 Improve documentation of syntax-ppss-context slightly
* doc/lispref/syntax.texi (Parser State): Document all possible return
values from 'syntax-ppss-context'.
2021-10-22 17:54:55 +02:00
Stefan Kangas
2a0a368ddc Fix typo in doc/emacs/anti.texi
* doc/emacs/anti.texi (Antinews): Fix typo.  (Bug#51325)
Reported by Po Lu <luangruo@yahoo.com>.
2021-10-22 05:28:21 +02:00
Stephen Gildea
9529e1d2fb Update doc of Edebug specification for macros
doc/lispref/edebug.texi:  Update documentation of Edebug specification:
- Do not document "0" as a recommended shortcut for non-instrumented
arguments; nobody knows about nor uses this, so don't encourage it.
- Add an example equivalent to (declare (debug (&rest sexp))).
2021-10-21 20:12:49 -07:00
Pedro Mauro
c1cf95a0e1 ; * doc/emacs/windows.texi: Doc fix.
* doc/emacs/windows.texi (Window Choice): Make example a valid
alist (bug#51274).
2021-10-19 05:14:15 +02:00
Stefan Kangas
98eb6d783a Fix a typo in emacs-lisp-intro.texi
* doc/lispintro/emacs-lisp-intro.texi (Lisp Atoms): Fix typo.
Reported by Mor Zahavi <morzahavi@me.com>.  (Bug#51271)
2021-10-19 02:39:00 +02:00
Michael Albinus
fc988a7113 Adapt Tramp manual
* doc/misc/tramp.texi: Use @uref instead of @url.
(Frequently Asked Questions): Adapt ELPA references.
2021-10-18 19:53:34 +02:00
Martin Rudalics
0c241043a8 Further fixes to Elisp manual
* doc/lispref/frames.texi (Frame Layout): Index "tab bar" instead
of "internal tab bar".
(Implied Frame Resizing): Remove irritating hyphens.
* doc/lispref/windows.texi (Windows and Frames): Remove paragraph
relating 'minibuffer-window' to 'window-list'.
2021-10-18 19:18:42 +02:00
Eli Zaretskii
c163fd9260 Minor fixes for recent changes in ELisp manual
* doc/lispref/windows.texi (Basic Windows, Windows and Frames)
(Selecting Windows):
* doc/lispref/objects.texi (Window Type):
* doc/lispref/frames.texi (Input Focus, Frame Layout): Fix
wording, punctuation, and indexing.
2021-10-18 17:13:18 +03:00
Lars Ingebrigtsen
fefada4816 Fix example in calc manual
* doc/misc/calc.texi (Arithmetic Tutorial): Fix sign in the
example (bug#51265).
2021-10-18 15:56:58 +02:00
Martin Rudalics
e74e17c1f0 Rewrites of Elisp manual including tab-bar and tab-line changes
* doc/lispref/buffers.texi (Current Buffer, Buffer List): Update
references to 'selected-window'.
* doc/lispref/elisp.texi (Top): Move up Selecting Windows section
in front of Window Sizes section.
* doc/lispref/frames.texi (Creating Frames): Say window system
instead of windowing system.
(Frame Layout): Add Tab Bar to layout.
(Layout Parameters): Add 'tab-bar-lines'.
(Input Focus): Say window system window instead of window
manager window.  Fix reference to 'selected-window'.
* doc/lispref/objects.texi (Window Type): Minor rewrite.
* doc/lispref/windows.texi (Basic Windows): Rewrite.  Settle on
term 'window system window' for disambiguation with our windows.
Move 'selected-window' description to Selecting Windows section.
Move schematic of window structure here.  Use 'decorations' for
objects outside the window body.  Say that the areas reserved
for continuation and truncation glyphs, vertical dividers and
line numbers are part of the window body.
(Windows and Frames): Minor rewrite, adding and fixing some
cross references.  Move live window schematic to 'Basic Windows'
section.
(Selecting Windows): Move section in front of Window Sizes
section.  Move description of 'selected-window' here.  Move up
description of 'frame-selected-window' and
'set-frame-selected-window'.  Update and move description of
'window-bump-use-time' here.
(Window Sizes): Throughout use the term 'decorations' instead of
enumerating them individually.  Add 'window-tab-line-height'
description.
(Resizing Windows): Again use the term 'decorations' instead of
enumerating them individually.
(Splitting Windows): Minor fix.
(Cyclic Window Ordering): Improve descriptions of 'get-lru-window'
and 'get-mru-window'.  Move 'window-bump-use-time' to Selecting
Windows section.
(Coordinates and Windows, Window Configurations): Once more use
the term 'decorations' instead of enumerating them individually.
* src/window.c (Fwindow_bump_use_time): Move after
'window-use-time'.  Make it work for live windows only.  Make
WINDOW argument optional.  Update doc-string.
2021-10-18 09:58:48 +02:00
Stefan Kangas
b5a0eda978 Prefer "graphical displays" to "X terminals" in documentation
* doc/lispref/objects.texi (Ctl-Char Syntax): Fix incorrect remark;
some text terminals can generate ASCII control characters.
(Other Char Bits):
* lisp/bindings.el:
* lisp/gnus/gnus-undo.el (gnus-undo-mode-map): Say "graphical display"
and "GUI display" instead of "X terminal"; the latter term is
archaic.  (Bug#51217)
2021-10-15 20:22:11 +02:00
Michael Albinus
4ad0fc0dd0 Precise documentation of file-notify-add-watch
* doc/lispref/os.texi (File Notifications):
* lisp/filenotify.el (file-notify-add-watch): Precise, that
watching a directory includes reports on file changes for some
backends.  (Bug#51146)
2021-10-15 16:29:11 +02:00
Martin Rudalics
f5b8df14c6 Fixes to account for windows' tab lines
* doc/lispref/display.texi (Size of Displayed Text): Fix entry
on 'window-text-pixel-size'.
* lisp/window.el (window--dump-window): Dump tab-line-height and
scroll-bar-height too.
(window--min-size-1): Take 'window-tab-line-height' into account.
* src/xdisp.c (Fwindow_text_pixel_size): Fix doc-string of
'window-text-pixel-size'.  Rename last argument to 'MODE-LINES'.
2021-10-15 10:21:05 +02:00
Eli Zaretskii
cf95962092 ; * doc/lispref/processes.texi (Filter Functions): Fix last change. 2021-10-14 14:51:04 +03:00
Lars Ingebrigtsen
1ad4ad0c11 Document the t value for set-process-filter in the manual
* doc/lispref/processes.texi (Filter Functions): Mention what t
means (bug#51177).
2021-10-14 13:10:05 +02:00
Michael Albinus
b014efa1e5 * doc/misc/tramp.texi (Frequently Asked Questions): Add reference
to ELPA Installation node.
2021-10-14 11:50:47 +02:00
Yan
568e479c59 Add missing parentheses in the Emacs manual
* doc/emacs/maintaining.texi (Xref Commands): Add missing
parentheses (bug#51195).

Copyright-paperwork-exempt: yes
2021-10-14 01:28:47 +02:00
Michael Albinus
cc796b7409 Tramp doc cleanup
* doc/misc/tramp.texi (Overview, Bug Reports)
(Frequently Asked Questions): Stylistic changes.
(Bug Reports): Mention tramp buffers appended to bug report.
2021-10-13 18:59:10 +02:00
João Távora
3fbe6fd367 ; Fix mistakes in last doc rewording about shorthands
bug#51089

1. The 'punctuation' syntax class is actually empty in Emacs Lisp.
   The class used in the implementation is 'symbol constituents';

2) The prefix to escape shorthands is '#_' together, not '#' or '_'.

* doc/lispref/symbols.texi (Shorthands): Fix exception.
2021-10-12 16:58:01 +01:00
Eli Zaretskii
66b8dfd060 ; Fix last change related to shorthands
* src/lread.c (read1): Minor stylistic fixes of the last change,
including the wording of the comment.

* doc/lispref/symbols.texi (Shorthands): Fix wording and typos.
2021-10-12 16:20:47 +03:00
João Távora
cf1409db71 Don't apply shorthands to punctuation-only symbols (bug#51089)
This includes symbols used for arithmetic functions such as -, /=,
etc.  Using "-" or "/=" is still possible but doing so won't shadow
those functions.

* doc/lispref/symbols.texi (Shorthand, Exceptions): New
subsubsection.

* src/lread.c (read1): Exempt punctionation-only symbols from
oblookup_considering_shorthand.

* test/lisp/progmodes/elisp-mode-tests.el
(elisp-dont-shadow-punctuation-only-symbols): Tweak test.
2021-10-11 22:29:16 +01:00
Michael Albinus
665a184f87 Backport: * doc/misc/tramp.texi (Bug Reports): Describe, how to activate ELPA Tramp.
(cherry picked from commit 978e5339e0)
2021-10-11 18:42:56 +02:00
Stefan Kangas
7cb4637923 Minor fix to clarify a sentence in emacs-lisp-intro
* doc/lispintro/emacs-lisp-intro.texi (Simple Extension): Add the word
"that" for clarity.  (Bug#43965)
2021-10-11 14:44:13 +02:00
Paul Eggert
96278de8ac New function num-processors
This addresses a FIXME comment in lisp/emacs-lisp/comp.el,
relating to the number of subsidiary processes used by
comp-run-async-workers in native compilation.
* admin/merge-gnulib (GNULIB_MODULES): Add nproc.
* doc/lispref/processes.texi (Process Information), etc/NEWS:
Document num-processors.
* lib/gnulib.mk.in, m4/gnulib-comp.m4: Regenerate.
* lib/nproc.c, lib/nproc.h, m4/nproc.m4:
New files, copied from Gnulib by admin/merge-gnulib.
* lisp/emacs-lisp/comp.el (w32-get-nproc): Remove decl.
(comp-effective-async-max-jobs): Use num-processors.
* src/process.c: Include nproc.h.
(Fnum_processors): New function.
(syms_of_process): Define ‘all’, ‘current’, ‘num-processors’.
* src/w32proc.c (Fw32_get_nproc): Add FIXME comment.
* test/src/process-tests.el (process-num-processors): New test.
2021-10-10 14:00:26 -07:00
Kyle Meyer
bcce93f04c Update to Org 9.5-46-gb71474 2021-10-09 16:34:12 -04:00
Eli Zaretskii
20eb3644ba Rewrite Antinews for Emacs 28
* doc/lispref/anti.texi (Antinews):
* doc/emacs/anti.texi (Antinews): Rewrite for Emacs 28.
* doc/lispref/elisp.texi (Top):
* doc/emacs/emacs.texi (Top): Update menu accordingly.
2021-10-09 14:32:28 +03:00
Stefan Kangas
1c7d056f4d ; Fix two typos where em dash was written as en dash 2021-10-08 16:51:24 +02:00
Juri Linkov
f7e6c199bf Clone the frame window configuration in 'clone-frame'
* doc/emacs/frames.texi (Creating Frames): Mention the cloned
window configuration for clone-frame.

* lisp/frame.el (clone-frame): Change second arg to 'no-windows'
and clone window configuration when it's nil.

* lisp/tab-bar.el (tab-bar-mouse-context-menu)
(tab-bar-detach-tab): Replace "Detach" with "Move" in help/doc strings.

https://lists.gnu.org/archive/html/emacs-devel/2021-10/msg00408.html
2021-10-06 19:38:09 +03:00
Stefan Kangas
d2a34cabcf ; Very minor touch-up to a recent change
* doc/lispintro/emacs-lisp-intro.texi (Design @value{COUNT-WORDS}):
Remove an unnecessary and potentially confusing "now".
2021-10-05 21:36:30 +02:00
Stefan Kangas
36a7ce4393 ; * doc/emacs/trouble.texi (After a Crash): Fix typo. 2021-10-05 21:11:19 +02:00
Stefan Kangas
1cd1b2835b * doc/misc/gnus.texi (Loose Threads): Use regexp-opt in example. 2021-10-05 19:32:32 +02:00
Stephen Gildea
d86b2e59c7 native-comp-available-p is the definitive test
* doc/lispref/compile.texi (Native Compilation): Document
native-comp-available-p as the way to test for native compilation.
* lisp/emacs-lisp/package.el (package--native-compile-async):
* test/lisp/mh-e/mh-utils-tests.el (mh-ensure-native-trampolines):
Test for native compilation with native-comp-available-p.

Thank you to Andrea Corallo for reviewing this patch.
2021-10-05 09:24:11 -07:00
Eli Zaretskii
1b383ac424 Minor fix of a recently installed documentation change
* doc/emacs/search.texi (Lax Search): Don't use ".." inside @samp,
it looks confusing, especially in print.  (Bug#51020)
2021-10-05 19:20:51 +03:00
Stefan Kangas
63abe976ce Document minibuffer-default-prompt-format in manual
* doc/emacs/mini.texi (Basic Minibuffer): Mention
minibuffer-default-prompt-format.  (Bug#50935)
2021-10-05 16:35:40 +02:00
Daniel Martín
fd7bb31412 Update documentation of search-whitespace-regexp
* doc/emacs/search.texi (Lax Search): Update the documentation about
the default value of search-whitespace-regexp, as it is now
independent of the major mode's syntax table (bug#51020).
2021-10-05 09:37:56 +02:00
Tak Kunihiro
b431f54c1b Mention seq-uniq' in delete-dups' documentation
* doc/lispref/lists.texi (Sets And Lists): Mention `seq-uniq'
(bug#50928).

* lisp/subr.el (delete-dups): Link to `seq-uniq' in doc string.
2021-10-05 09:11:33 +02:00
Paul Eggert
68a256c892 Update from Gnulib
Make the following changes by hand, and run 'admin/merge-gnulib'.
* .gitignore: Add lib/malloc/*.gl.h.
* admin/merge-gnulib: Copy lib/af_alg.h and lib/save-cwd.h
directly from Gnulib, without worrying about Gnulib modules,
as these files are special cases.
(AVOIDED_MODULES): Remove malloc-posix.
* lib/malloc.c, lib/realloc.c, m4/malloc.m4, m4/realloc.m4:
* m4/year2038.m4: New files, copied from Gnulib.
* lib/malloca.c, lib/malloca.h:
* m4/close-stream.m4, m4/glibc21.m4, m4/malloca.m4:
Remove.  These are either no longer present in Gnulib, or are no
longer needed by modules that Emacs uses.
* oldXMenu/AddPane.c, oldXmenu/Addsel.c: Include XmenuInt.h first;
needed for new Gnulib.
* src/xmenu.c: Call emacs_abort, not abort.
2021-10-04 15:21:31 -07:00
Stefan Kangas
c0793cd9de Don't use some obsolete names in documentation
* admin/notes/bugtracker: Use non-obsolete name
'mail-dont-reply-to-names'.
* admin/notes/multi-tty: Mention new variable name
'x-selection-value'.
* doc/lispintro/emacs-lisp-intro.texi (Point and mark)
(Point and mark, Design @value{COUNT-WORDS}): Avoid using obsolete
name 'count-lines-region'.
* doc/lispref/hooks.texi (Standard Hooks): Remove reference to
obsolete abnormal hook 'completion-annotate-function'.
* doc/misc/efaq.texi (SPC no longer completes file names): Remove
reference to obsolete 'minibuffer-local-filename-must-match-map';
setting it has no effect.
* doc/misc/gnus.texi (NNTP): Remove reference to obsolete variable
'nntp-authinfo-file'.
* doc/misc/reftex.texi (Table of Contents, Creating Citations)
(Options - Table of Contents, Options - Referencing Labels)
(Options - Creating Citations, Options - Index Support)
(Options - Index Support, Changes): Don't use obsolete names.
* doc/misc/speedbar.texi (Minor Display Modes)
(Major Display Modes): Make variable name suggestions more in line
with existing non-obsolete variable.
* lisp/textmodes/reftex-cite.el (reftex-select-bib-mode-map):
* lisp/textmodes/reftex-ref.el (reftex-offer-label-menu): Don't use
obsolete variable names.
* lisp/progmodes/which-func.el (which-func-mode): Doc fix.
2021-10-04 03:26:11 +02:00
Eli Zaretskii
fc32a3bd95 ; * doc/lispref/files.texi (Reading from Files): Fix wording. 2021-10-03 21:30:34 +03:00
Alan Mackenzie
3cc77aa976 Clarify (elisp) insert-file-contents with BEG or END not on character boundary
* doc/lispref/files.texi (Reading from files): When the argument BEG or END to
insert-file-contents are at a byte position not at a character boundary,
clarify that raw bytes get inserted, and how to handle this awkwardness in
Lisp.  Also clarify that insert-file-contents-literally is intended to insert
raw bytes into the buffer.  Fix the outdated example that states it inserts
500 characters, when it actually inserts 500 bytes.
2021-10-03 18:13:23 +00:00
Michael Albinus
3863919a00 Fix unmounting in Tramp
* doc/misc/tramp.texi (FUSE setup): Add tramp-fuse-unmount-on-cleanup.

* lisp/net/tramp.el (tramp-file-name-unify): New defun.
(tramp-file-name-equal-p):
* lisp/net/tramp-cache.el (tramp-get-connection-property)
(tramp-set-connection-property, tramp-flush-connection-property)
(tramp-flush-connection-properties): Use it.

* lisp/net/tramp-fuse.el (tramp-fuse-get-fusermount): New defun.
(tramp-fuse-mount-points): New defvar.
(tramp-fuse-unmount): Use it.  Delete VEC from
`tramp-fuse-mount-points'.  Delete mount point.
(tramp-fuse-unmount-on-cleanup): New user option.
(tramp-fuse-cleanup, tramp-fuse-cleanup-all): New defuns.
(top): Adapt `tramp-fuse-unload-hook',
`tramp-cleanup-connection-hook',
`tramp-cleanup-all-connections-hook' and `kill-emacs-hook'.

* lisp/net/tramp-rclone.el (tramp-rclone-maybe-open-connection):
* lisp/net/tramp-sshfs.el (tramp-sshfs-maybe-open-connection):
Add VEC to `tramp-fuse-mount-points'.

* test/lisp/net/tramp-tests.el (tramp-fuse-unmount-on-cleanup): Declare.
(tramp-test39-make-lock-file-name): Use it.
2021-10-03 18:55:35 +02:00
João Távora
137fa2d716 Rename elisp-shorthands to read-symbol-shorthands
The new name fits better in the family of variables that affect
the Lisp reader.

Suggested-by: Po Lu <luangruo@yahoo.com>

* doc/lispref/symbols.texi (Shorthands): Mention read-symbol-shorthands

* lisp/shorthands.el (hack-read-symbol-shorthands)
(hack-read-symbol-shorthands)
(shorthands-font-lock-shorthands): Use read-symbol-shorthands

* lisp/progmodes/elisp-mode.el (elisp--completion-local-symbols)
(elisp--completion-local-symbols)
(elisp-shorthands): Use read-symbol-shorthands

* src/lread.c:
(syms_of_lread): Define Vread_symbol_shorthands
(oblookup_considering_shorthand): Use Vread_symbol_shorthands.

* test/lisp/progmodes/elisp-mode-tests.el (elisp-shorthand-read-buffer):
(elisp-shorthand-read-from-string): Use read-symbol-shorthands

* test/lisp/progmodes/elisp-mode-resources/simple-shorthand-test.el
Use new symbol name read-symbol-shorthands.
2021-10-03 16:18:40 +01:00
Eli Zaretskii
a9052248da Improve documentation of 'shift-select-mode'
* doc/emacs/mark.texi (Shift Selection): Document the 'permanent'
value of 'shift-select-mode'.  Add index entry for that variable.
(Bug#50954)

* etc/NEWS: Update the entry for 'shift-select-mode'.
2021-10-02 09:40:44 +03:00