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)

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'.

* Fix `native-compile-target-directory' effectiveness on trampolines

* lisp/emacs-lisp/comp.el (comp-trampoline-compile): Fix
`native-compile-target-directory' effectiveness on trampoline
compilation.

Add missing single quotes in the Emacs manual

* lisp/mwheel.el (mouse-wheel-scroll-amount): Add missing single
quotes.  (Bug#51223)

Copyright-paperwork-exempt: yes.

; * lisp/emacs-lisp/comp.el (comp-trampoline-compile): Fix comment.

* lisp/menu-bar.el (yank-menu-length): Fix docstring (bug#51138).

Accept process-filter t in Tramp

* lisp/net/tramp.el (tramp-handle-make-process):
* lisp/net/tramp-adb.el (tramp-adb-handle-make-process):
* lisp/net/tramp-sh.el (tramp-sh-handle-make-process): Filter can be t.

* test/lisp/net/tramp-tests.el (tramp-test29-start-file-process)
(tramp-test30-make-process): Test filter equal t.

; * doc/lispref/processes.texi (Filter Functions): Fix last change.

Document the t value for set-process-filter in the manual

* doc/lispref/processes.texi (Filter Functions): Mention what t
means (bug#51177).

* doc/misc/tramp.texi (Frequently Asked Questions): Add reference

to ELPA Installation node.

Fix Help functions for clicks on tool bar and tab bar

* lisp/mouse.el (mouse-minibuffer-check): Don't assume posn-window
returns a window.  (Bug#5199)

; * etc/DEBUG: Add a section about debugging native-compilation.

In make_lispy_position fix Bug#50993 in rudimentary fashion

* src/keyboard.c (make_lispy_position): Do not set posn to
tool- or tab-bar when track_mouse is enabled (Bug#50993).

Mark vc-switch-backend as obsolete

* etc/NEWS: Mention the change.

* lisp/vc/vc.el (vc-switch-backend): Mark as obsolete (bug#50344).
(vc-transfer-file): Wrap the calls in 'with-suppressed-warnings'.

Add missing parentheses in the Emacs manual

* doc/emacs/maintaining.texi (Xref Commands): Add missing
parentheses (bug#51195).

Copyright-paperwork-exempt: yes

Improve tooltip of mode-line-position again

* lisp/bindings.el (mode-line-position): Improve tooltip again.
This change was discussed in
https://lists.gnu.org/r/emacs-devel/2021-10/msg00952.html

Use browse-url-button-regexp for rcirc-url-regexp

* rcirc.el (rcirc-url-regexp): Copy improved regexp from browse-url

* lisp/help.el (help--analyze-key): Avoid mouse-set-point for non-mouse events

(bug#51173)

; * etc/charsets/README: Update the format documentation.

Tramp doc cleanup

* doc/misc/tramp.texi (Overview, Bug Reports)
(Frequently Asked Questions): Stylistic changes.
(Bug Reports): Mention tramp buffers appended to bug report.

Make emacs-lisp-byte-compile-and-load load the .elc file again

* lisp/progmodes/elisp-mode.el (emacs-lisp-byte-compile-and-load):
Load the compiled file instead of the source (bug#51180).

Fix point movement in image-dired

* lisp/image-dired.el (image-dired-thumb-file-marked-p): Don't
move point in associated dired buffer.
(image-dired-delete-marked): Revert "Fix deletion of associated image"
because it was wrong and introduced another problem (bug#51152).

Improve shortdoc for vector

* lisp/emacs-lisp/shortdoc.el (vector): Improve shortdoc with titles.
Add mapc.  Fix typo where 'seq-reduce' is incorrectly written as
'reduce'.

Fix test bug when calloc returns null

* test/src/emacs-module-resources/mod-test.c (Fmod_test_userptr_make):
Don’t dump core if calloc returns null and signal_errno returns.

Pacify GCC 11 -fanalyzer on x86-64

* src/buffer.c (fix_overlays_before):
Redo slightly to work around GCC bug 102692
<https://gcc.gnu.org/bugzilla//show_bug.cgi?id=102692>.

Improve handling of non-character events in input methods

* lisp/international/quail.el (quail-add-unread-command-events):
Handle non-vector event arguments.  Fixes bug#51118.

; 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.

; 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.

In Fdelete_other_windows_internal fix new total window sizes (Bug#51007)

* src/window.c (Fdelete_other_windows_internal): Assign the
new total sizes of windows _after_ the new window configuration
is in place (Bug#51007).

* lisp/mh-e/mh-show.el (mh-junk-whitelist): Custom obsolescence message.

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.

* lisp/progmodes/python.el: Bump package version to 0.28.

Fontify "print" and "exec" as functions in python-mode

This change was first made on master, but on closer consideration it
is better to fix this bug already in Emacs 28.1.

* lisp/progmodes/python.el (python-font-lock-keywords-level-2):
Fontify "print" and "exec" as functions, which is the case in
Python 3.  (Bug#43298)  Do not merge to master.

Copy parent face attributes to tab-line-tab-current instead of inheriting face

* lisp/tab-line.el (tab-line-tab-current): Don't inherit face from
'tab-line-tab' to not inherit the face attribute :height from 'tab-line',
because :height of mouse-face is added to the base face.
Copy here most of the parent face attributes (bug#50798).

Another fix for 'ibuffer-shrink-to-fit' (Bug#7218, Bug#51029)

* lisp/ibuffer.el (ibuffer-shrink-to-fit): Fit window only if its
buffer is in 'ibuffer-mode' (Bug#7218, Bug#51029).

Backport: * doc/misc/tramp.texi (Bug Reports): Describe, how to activate ELPA Tramp.

(cherry picked from commit 978e5339e0d4ef98575096bcf3ec2061ad530f27)

Work around GCC bug 102671

This is for --enable-gcc-warnings on GCC 11.2.1.
* src/window.c, src/timefns.c: Disable -Wanalyzer-null-dereference.

Release ERC 5.4

* lisp/erc/erc.el (Version, erc-version): Bump to 5.4.
(customize-package-emacs-version-alist): Add entry for 5.4.

* etc/ERC-NEWS: Announce ERC's addition to GNU ELPA.

* etc/ERC-NEWS: Fix outline level for the recent additions.

Add ERC entries for 'customize-package-emacs-version-alist'

* lisp/erc/erc.el (customize-package-emacs-version-alist): Add entries
for existing ERC versions.

Expand the full file name

* lisp/vc/vc-git.el (vc-git--literal-pathspec):
Expand the full file name, not just the local part (bug#51112).

Obsolete XEmacs compat convention in 'erc-button-press-button'

* lisp/erc/erc-button.el (erc-button-press-button): Advertise new
calling convention without XEmacs compatibility.

Backport: Add ERC version to protocol log

* lisp/erc/erc.el (erc-toggle-debug-irc-protocol): Include the erc
version in the debug logs (bug#51107).

(cherry picked from commit 13411346202f86e950bee076a5d528e98695fbb4)

Adapt the recent 'num_processors' change to MS-Windows

* nt/gnulib-cfg.mk (OMIT_GNULIB_MODULE_nproc): Omit nproc.

* src/w32.c (num_processors): New function.
* src/w32proc.c (Fw32_get_nproc): Remove.

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)

; Pacify recent shorthand unused lexarg warnings.

Make tty-run-terminal-initialization load the .elc file (if any)

* lisp/faces.el (tty-run-terminal-initialization):
`locate-library' may have found the .el.gz file (bug#51116).

Fix ert errors when there's a test that binds `debug-on-error'

* lisp/emacs-lisp/ert.el (ert--run-test-internal): Don't infloop
on errors when signalling errors (bug#51131).

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.

Add symbol property 'save-some-buffers-function' (bug#46374)

* lisp/files.el (save-some-buffers-root): Put non-nil
symbol property 'save-some-buffers-function'.
(save-some-buffers): Check pred for the
symbol property 'save-some-buffers-function'.
(save-some-buffers-default-predicate): Mention
symbol property 'save-some-buffers-function'.

Keep reading when typed RET in read-char-from-minibuffer and y-or-n-p

* lisp/subr.el (read-char-from-minibuffer-map):
Remap exit-minibuffer to read-char-from-minibuffer-insert-other.
(y-or-n-p-map): Remap 'exit' to y-or-n-p-insert-other.
(y-or-n-p): Don't mention RET in docstring.  (Bug#51101)

* lisp/userlock.el (ask-user-about-supersession-threat): Accept 'y' strictly.

(Bug#51101)

Fix point positioning on mouse clicks with non-zero line-height

* src/xdisp.c (move_it_to): After passing a newline, reset
it->override_ascent, like 'display_line' does (in
'append_space_for_newline').  (Bug#51111)

Complete shorthands to longhands for symbol-completing tables

Shorthands aren't symbols, they're text forms that 'read' into
symbols.  As such, shorthands aren't candidates in these tables of
symbols.  But in some situations, if no other candidates match the
pattern, we can e.g. complete "x-foo" to "xavier-foo" if the shorthand

  (("x-" . "xavier-"))

is set up in the buffer of origin.

bug#50959

* lisp/help-fns.el (help--symbol-completion-table): Report
`symbol-help' category.

* lisp/minibuffer.el (completion-styles-alist): New 'shorthand'
style.
(completion-category-defaults): Link 'symbol-help' category with
'shorthand' style.
(minibuffer--original-buffer): New variable.
(completing-read-default): Setup minibuffer--original-buffer.
(completion-shorthand-try-completion)
(completion-shorthand-all-completions): New helpers.

Add new failing test for bug#51089

* test/lisp/progmodes/elisp-mode-tests.el
(elisp-dont-shadow-punctuation-only-symbols): Add new failing test.

; * lisp/emacs-lisp/shortdoc.el: Fix typo.

Avoid mapping file names through 'substring'

* lisp/progmodes/project.el (project--files-in-directory):
Avoid mapping file names through 'substring'.  Reducing the amount
of garbage generated.  Better perf by up to 20%.
Bump the package version.

Update to Org 9.5-46-gb71474

Expanded testing of MH-E with multiple MH variants

* test/lisp/mh-e/mh-utils-tests.el: Environment variable TEST_MH_PATH
controls which installed MH variant to test with.  Moved the commentary
about testing with different MH variants from above 'with-mh-test-env'
definition to "Commentary" section at the top of the file.
* test/lisp/mh-e/test-all-mh-variants.sh: New script to test all
installed MH variants.

Fix Seccomp filter for newer GNU/Linux systems (Bug#51073).

On some systems, process startup calls prctl(PR_CAPBSET_READ) via
'cap_get_bound'.  We can just return EINVAL.

* lib-src/seccomp-filter.c (main): Add a rule for
prctl(PR_CAPBSET_READ, ...).

Tramp code cleanup

* lisp/net/tramp.el (tramp-remote-path): Adapt docstring.
(tramp-action-login, tramp-action-password, tramp-action-yesno)
(tramp-action-yn, tramp-process-actions): Move let-binding of
`enable-recursive-minibuffers' up.
(tramp-handle-make-process, tramp-handle-write-region):
* lisp/net/tramp-adb.el (tramp-adb-handle-write-region)
(tramp-adb-handle-make-process):
* lisp/net/tramp-sh.el (tramp-sh-handle-make-process)
(tramp-sh-handle-write-region):
* lisp/net/tramp-smb.el (tramp-smb-handle-write-region):
* lisp/net/tramp-sshfs.el (tramp-sshfs-handle-write-region):
Use `string-or-null-p'.

; Fix indentation in etc/NEWS

Fix thinko in ls-lisp--insert-directory

* lisp/ls-lisp.el (ls-lisp--insert-directory): Ensure that
SWITCHES is a string.

Mention that RET means "yes" in y-or-n-p

* lisp/subr.el (y-or-n-p): Mention that RET also means yes (bug#51101).

; * src/dispextern.h (struct glyph_string): Comment on NCHARS.  (Bug#51105)

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.

; * etc/NEWS: Rearrange the "incompatible changes" sections.

; * etc/NEWS: Fix a typo.

; * src/Makefile.in (../native-lisp): Add comment.

* lisp/bindings.el (mode-line-position): Improve tooltip.

* lisp/progmodes/xref.el: Bump the version.

Slight simplificaiton

* lisp/progmodes/xref.el (xref--insert-xrefs):
Compute log only once.  Use 'dolist'.

Fix doc strings of 2 categories

* lisp/international/characters.el (?R, ?L): Make the first line
of the categories' doc string shorter, to fit into 15 columns.

(xref--collect-matches-1): Remove some intermediate allocations

* lisp/progmodes/xref.el: (xref--collect-matches-1):
Rewrite to remove some intermediate allocations.
Modest performance improvement.

; Fix two typos where em dash was written as en dash

; Fix spacing in previous commit

Use the correct label in the warning

* lisp/textmodes/reftex-toc.el (reftex-toc-rename-label): Add
missing space in the prompt.  Use the new user defined label in
the warning (bug#36235).

; * admin/make-tarball.txt: Should configure --with-native-compilation.

; * etc/TODO (display): Add entry about Default_Ignorables.

; Fix 'restore-buffer-modified-p' doc string typo

* src/buffer.c (restore-buffer-modified-p): Fix typo in doc string:
"and" for "or" regarding lock/unlock.  Note that 'set-buffer-modified-p'
doc string already uses the correct "or".

Add Emacs 27 compatibility hack

* lisp/progmodes/xref.el: Add Emacs 27 compatibility hack, for the
standalone version of this package.

Pacify GCC 10.3 -Wmaybe-uninitialized

Problem reported by Basil L. Contovounesios (Bug#51075).
* src/term.c (encode_terminal_code):
Add an UNINIT to pacify GCC 10 bug.

* lisp/tab-bar.el (tab-detach, tab-window-detach): New aliases.

(tab-bar-mouse-context-menu, tab-bar-duplicate-tab):
Use word "clone" in help/doc string.

; * src/composite.h (LGSTRING_FONT): Add comment about its role.

Include the refcards in the release tarball

* make-dist (possibly_non_vc_files): Include *.pdf files, to
include the produced refcards in the tarball.  This was lost when
'make-dist' was rewritten for Emacs 27.

; * src/Makefile.in (../native-lisp): Make the long recipe silent.

; * src/keyboard.c (make_lispy_position): Avoid GCC warning.  (Bug#51076)

Backport: * lisp/net/tramp-archive.el (tramp-archive-autoload-file-name-handler): Scope

Fix the scoping of `tramp-archive-enabled`.

(cherry picked from commit 8d53c23f90aab6e527c61137ae43274c7a36eca7)

Improve documentation and customization of 'blink-matching-paren'

* lisp/simple.el (blink-matching-paren): Fix the wording of the
doc string and the descriptions in the value menu.  (Bug#51032)

* lisp/erc/erc.el: Don't error if 'erc-loaddefs' does not exist.

That autoload file is created as part of the Emacs compilation
process, however we would like ERC to be usable if used outside
emacs.git (e.g. if installed from GNU ELPA).

Add 'erc-bug' command for reporting ERC bugs

* etc/ERC-NEWS: Announce the new command, and mention it at the top of
the file along with 'report-emacs-bug'.
* lisp/erc/erc.el (erc-bug): New command for reporting ERC bugs.  It
prompts for a subject, and passes it on to 'report-emacs-bug' along
with the current ERC version, with the ERC mailing list in Cc.

Add 'erc-version' and use it to display ERC version consistently

* lisp/erc/erc.el (erc-version): New constant holding the current ERC
version, now used in the function with the same name to produce a
version string for use across ERC for consistency.  Also, add another
optional argument, 'bold-erc', which when non-nil, marks the "ERC"
portion of the string with the control character for bold display.
(erc-quit/part-reason-default): Use the 'erc-version' function for a
consistent version string.
(erc-cmd-SV): Mention the ERC version number from the 'erc-version'
constant.
(erc-ctcp-query-VERSION): Use the 'erc-version' function for a
consistent version string.

Small tweaks and improvements to etc/ERC-NEWS

* etc/ERC-NEWS: Small tweaks inspired by etc/NEWS, namely to add a
descriptive blurb at the top of the file to explain what it is about
and how to report ERC bugs, add a form feed before the section for
every release, and set the same Local Variables that etc/NEWS does.

Add NEWS items for changes to ERC since 5.3 to etc/ERC-NEWS

* etc/ERC-NEWS: copy ERC NEWS items from etc/NEWS, etc/NEWS.27,
etc/NEWS.26, etc/NEWS.25, and etc/NEWS.24 to here.  Future ERC NEWS
are also to be added here.  This is in motivated by preparation for
addition of ERC to GNU ELPA, along with the ERC manual and NEWS.
* etc/NEWS: remove ERC-related entries, and refer the reader to
ERC-NEWS instead.

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

* lisp/tool-bar.el (tool-bar-position): Doc fix.

; Fix typo in etc/NEWS

* NEWS: Mention rcirc connects to #emacs by default

Refactor mh-utils-tests macro 'with-mh-test-env'

* test/lisp/mh-e/mh-utils-tests.el (with-mh-test-env): Refactor to
reduce the size of the expanded macro.
(mh-test-utils-setup): New helper function.
(mh-ensure-native-trampolines): Absorbed by mh-test-utils-setup.