CC Mode: Fix unstable fontification of doc strings.

Also optimize a loop over several line doc-comments.

* lisp/progmodes/cc-fonts.el (c-font-lock-doc-comments): New variable
comment-mid, used as the starting point for applying c-doc-face-name in a
line comments.  In block comments, apply this face not from `comment-beg' but
from `region-beg', no earlier than the start of the fontification region.

ERC right stamps: also use latest buffer's window's width (Bug#44140)

* lisp/erc/erc-stamp.el (erc-insert-timestamp-right): Use latest
buffer's window's width to position the timestamp, if both
`erc-timestamp-right-column' and `erc-fill-column' are not set (or
`erc-fill-mode' is off).  This is what the documentation says, but was
not implemented.  Also fix the bug of using selected window's width
instead of the (or some) window showing the buffer.  The latest
window's width is saved in `erc-timestamp-last-window-width' and used
when the buffer is no more shown.  In case the buffer was never shown,
which I'm not sure can happen, either use `fill-column' if set, or
give up on aligning and just output the timestamp (modulo the kludge)
right after message text.  While here, fix the off by one calculation
of point start when the reference is the window's width.

Unbreak ERC's Ibuffer filter (Bug#44100)

* lisp/erc/erc-ibuffer.el (erc-modified): Don't use `length' on dotted
lists (and not even to test if there is more than one element, for
that matter).  Use `cdr' instead.

; Auto-commit of loaddefs files.

; One more change in back.texi.

; Yet another last-minute change in Emacs manual for printing

* doc/emacs/book-spine.texi:
* doc/emacs/back.texi: Minor copyedits.

; * src/data.c (Fcar, Fcdr): Doc fix.

One more minor update of the Emacs manual for 19th printing

* doc/emacs/back.texi:
* doc/emacs/book-spine.texi:
* doc/emacs/emacs.texi: Last round of minor copyedits for 19th ed.

; Fix let-alist Texinfo markup

* doc/lispref/lists.texi (Association Lists): Use
@result (bug#34842).

; * doc/emacs/mule.texi (International Chars): Mention 'describe-char'.

Fix overfull hbox in Emacs manual

* doc/emacs/display.texi (Displaying Boundaries): Fix overfull
hbox.

Minor copyedits of Emacs manual

* doc/emacs/book-spine.texi: Fix the author attribution.
(Bug#49405)
* doc/emacs/back.texi: Update text.

Update IRC-related references to point to Libera.Chat

Per GNU and FSF's announcements [0, 1] of moving official IRC channels
to the Libera.Chat IRC network, as well as several Emacs-related
channels following suit [2], update IRC-related references to reflect
the migration.

[0]: https://lists.gnu.org/archive/html/info-gnu/2021-06/msg00005.html
[1]: https://lists.gnu.org/archive/html/info-gnu/2021-06/msg00007.html
[2]: https://lists.gnu.org/archive/html/info-gnu-emacs/2021-06/msg00000.html

Fix typo in c-macro-expand docstring

* lisp/progmodes/cmacexp.el (c-macro-expand): Fix typo.  (Bug#49356)

; Auto-commit of loaddefs files.

; * doc/emacs/back.texi: Fix a typo.

Update doc/emacs/ for a new printing of the Emacs Manual book

* doc/emacs/book-spine.texi: New file: the printed book spine.
* doc/emacs/back.texi: New file: the backcover text for the
printed book.
* doc/emacs/emacs.texi: Update ISBN.

C++ Mode: Handle new keywords static_cast, etc., wrt angle brackets

* lisp/progmodes/cc-langs.el (c-<>-arglist-kwds): Add const_cast,
dynamic_cast, reinterpret_cast and static_cast into this lang const.

* lisp/progmodes/cc-engine.el (c-clear-<-pair-props, c-clear->-pair-props)
(c-clear-<-pair-props-if-match-after, c-clear->-pair-props-if-match-before)
(c-forward-<>-arglist-recur):
Invalidate caches with c-trunctate-lit-pos-cache.
(c-forward-<>-arglist-recur): If in a matching <...> expression, the < has a
syntax-table property, but the > not, remove that property.

Another improvement in documentation of "memory" profiler

* lisp/profiler.el (profiler-start): Fix the doc string to better
explain what is "memory" profiler.

Improve documentation of profiler

* doc/lispref/debugging.texi (Profiling): Stop misleading users
about what "memory" profiling really is.

Document 'ispell-program-name'

* doc/emacs/fixit.texi (Spelling): Document
'ispell-program-name'.  (Bug#49039)

Fix documentation of 'face-extend-p'

* doc/lispref/display.texi (Attribute Functions): Fix description
of 'face-extend-p'.  (Bug#48936)

* src/xdisp.c (Fwindow_text_pixel_size): Plug memory leak.  (Bug#48884)

(cherry picked from commit 69a65212a233333ab0605374b4985ead23f4a541)

; Fix typo in dynamic module functions docs.

; * src/composite.h: Improve comments for LGSTRING and LGLYPH.

; Auto-commit of loaddefs files.

Improve documentation of regexp ranges

* doc/lispref/searching.texi (Regexp Special): Document the effect
of using octal escapes in regexp ranges.  (Bug#17758)

Improve documentation of display tables

* doc/lispref/display.texi (Display Tables): Add a cross-reference
to the next section.

* src/buffer.c (syms_of_buffer) <ctl-arrow>: Doc fix.  (Bug#48539)

Improve documentation of Hexl mode

* doc/emacs/misc.texi (Editing Binary Files): Explain that Hexl can
also be used for editing text, including non-ASCII text.

; * etc/NEWS: Fix decoded-time-set-defaults typo.

This was mistakenly applied to NEWS.27 on the master branch in
2021-05-09 "; Fix decoded-time-set-defaults typo in NEWS.27."
but that has now been reverted (bug#48298).

Fix compilation errors with latest w32 API headers

* src/w32common.h: Rename OS_* to OS_SUBTYPE__*, as w32 API
headers started defining OS_NT, which breaks the use of the
enumeration.  All users changed.  (Bug#48303)

Improve doc strings in log-edit.el

* lisp/vc/log-edit.el (log-edit-new-comment-index)
(log-edit-maximum-comment-ring-size, log-edit-previous-comment)
(log-edit-next-comment, log-edit-comment-search-backward)
(log-edit-comment-search-forward)
(log-edit-comment-to-change-log)
(log-edit-header-contents-regexp, log-edit-font-lock-gnu-style)
(log-edit, log-edit-mode, log-edit-fill-entry, log-edit-done)
(log-edit-kill-buffer, log-edit-insert-message-template)
(log-edit-insert-cvs-template, log-edit-insert-cvs-rcstemplate)
(log-edit-rewrite-fixes, log-edit-add-to-changelog)
(log-edit-generate-changelog-from-diff)
(log-edit-insert-changelog, log-edit-narrow-changelog)
(log-edit-changelog-entry, log-edit-changelog-insert-entries)
(log-edit-extract-headers): Enhance and reword doc strings.

; * etc/TODO (etc/DOC): Update the todo entries.

Fix code for newline-and-indent in skeleton language.

The code for this is the symbol 'n', which is usually spelled as '\n'
here, not the character ?\n.

* doc/misc/autotype.texi (Skeleton Language): Fix item for
newline-and-indent.

* lisp/jka-compr.el (jka-compr-uninstall): Fix function reference.

; Auto-commit of loaddefs files.

Fix GUD overlay arrows in M-x gdb when debugging over Tramp.   Don't merge

* lisp/progmodes/gdb-mi.el (gdb-frame-handler): Use local part of
file name when setting `gud-last-frame'.

Fix setting breakpoints in M-x gdb for remote files.  Don't merge

* lisp/progmodes/gdb-mi.el (gdb-jsonify-buffer): Fix modification
of GDB/MI "fullname" property for remote files

Improve doc string of 'tab-width'.

* src/buffer.c (syms_of_buffer) <tab-width>: Clarify doc string.
(Bug#48058)

* lisp/emacs-lisp/elp.el: Doc fixes.

* lisp/emacs-lisp/pp.el: Doc fixes.

* admin/make-tarball.txt: Note to update more files on web page.

* doc/misc/cl.texi (For Clauses): Minor copyedits.

; * doc/lispref/files.texi (Directory Names): Add missing parenthesis

Minor update for make-tarball.txt

* admin/make-tarball.txt (UPDATING THE EMACS WEB PAGES AFTER A
RELEASE): Update and enhance the section to make it easier to find
the banner and verify the updated pages are in place.

* doc/misc/cl.texi (Iteration Clauses): fix `never' clause typo

This fixes bug#47962.

Copyright-paperwork-exempt: yes

; Fix Texinfo in last change to minibuf.texi.

Improve filling-related documentation

* doc/emacs/text.texi (Auto Fill, Fill Commands): Mention special
line-breaking rules for CJK characters and the kinsoku rules.
(Bug#47856)

* lisp/textmodes/fill.el
(fill-separate-heterogeneous-words-with-space): Doc fix.

; * doc/lispref/keymaps.texi (Easy Menu): Fix typo.

Fix reference to "yanking" in the main Emacs manual

* doc/emacs/emacs.texi (Top): Yanking is alternatively known as
pasting, not copying.  (Bug#47839).

Improve documentation of 'map-y-or-n-p'

* lisp/emacs-lisp/map-ynp.el (map-y-or-n-p): Doc fix.  (Bug#47833)

* doc/lispref/minibuf.texi (Multiple Queries): Fix the wording in
the description of 'map-y-or-n-p'.

Fix typos in manuals

* doc/misc/eshell.texi (Completion):
* doc/lispref/objects.texi (Mutability): Fix typos.  (Bug#47738)

Fix description of momentary message display

* doc/emacs/mini.texi (Basic Minibuffer): Update the description
of momentary message display while minibuffer is active.
(Bug#47689)

Fix broken links in autorevert.el

* lisp/autorevert.el (global-auto-revert-non-file-buffers):
Fix broken links.  (Bug#47621)

* lisp/international/ja-dic-cnv.el (skkdic-convert): Doc fix.

Fix crash when using menus and tramp on NS

; Fixes bug#24472, bug#37557 and bug#37922.

* src/nsterm.m (ns_select): Don't drain outerpool in this function.

(cherry picked from commit f14869cd70e61b1908ec88a5e3d4bf21c7d538a0)

Improve doc strings in replace.el

* lisp/replace.el (occur, list-matching-lines-prefix-face)
(list-matching-lines-jump-to-current-line): Doc fixes.

Fix hang in autorevert-tests.el

* test/lisp/autorevert-tests.el (auto-revert--wait-for-revert):
Apply more robust check, whether file notification is used.

Revert "Clarify dired-do-shell-command doc string"

This reverts commit cf607c262e15c873961fdfcced254e6f8e82f8d7.

The doc string already explains this.

(cherry picked from commit 01cf0eb75786834b7a0ee5be34be53f6e8e14c11)

Clarify dired-do-shell-command doc string

* lisp/dired-aux.el (dired-do-shell-command): Mention what happens
to FILE-LIST (bug#47432).

(cherry picked from commit cf607c262e15c873961fdfcced254e6f8e82f8d7)

Doc fixes for 'face-foreground' and 'face-background'.

* lisp/faces.el (face-foreground, face-background): Clarify how a
face specified in INHERIT arg is used.  (Bug#47437)

; * admin/make-tarball.txt: Minor addition to the Web pages section.

* admin/admin.el (set-version): Handle malformed NEWS markup.

admin.el fix for bug#47394

* admin/admin.el (manual-html-fix-index-2): Handle Texinfo 6.7.

; * etc/NEWS: Fix typo.

; * admin/make-tarball.txt: Another minor addition.

Bump Emacs version past 27.2

* README:
* configure.ac:
* nt/README.W32:
* msdos/sed2v2.inp:
* etc/NEWS: Bump Emacs version to 27.2.50.

* admin/make-tarball.txt: Improve and expand the instructions.

Fix preeditarea reporting wrong spot.

This patch adjust the x position of preeditarea with both left fringe
and left margin, which prevents IME preedit box (such as fcitx) from
placing at the wrong position in GUI emacs.
* src/xfns.c (xic_set_preeditarea): Adjust X for left margin width.
(Bug#47377)

Fix replace-buffer-contents undefined behavior

* src/editfns.c (Freplace_buffer_contents): Avoid undefined
behavior with competing side effects in parallel subexpressions.
Problem reported by Apple clang version 12.0.0 (clang-1200.0.32.29).

Fix filenotify-tests.el for Solaris (bug#47262), do not merge

* test/lisp/filenotify-tests.el (file-notify--test-read-event):
Check also for GFamDirectoryMonitor.
(file-notify--test-timeout): Increase cygwin timeout.
(file-notify--test-monitor): Use `alist-get'.
(file-notify--test-event-actions): New defun.
(file-notify--test-with-actions-explainer): Use it.
(file-notify--test-with-actions-check): Use it.  If
file-notify-debug is non-nil, trace received events instead of
checking them.
(file-notify-test03-events, file-notify-test05-file-validity)
(file-notify-test07-many-events, file-notify-test08-backup)
(file-notify-test09-watched-file-in-watched-dir):
Handle GFamFileMonitor and GFamDirectoryMonitor.

; * ChangeLog.3: Update with the log of the last change.

Fix frame-inner-height in non-GUI builds

Include tab bar in frame's inner height in non-GUI builds that don't
define tab-bar-height.  This is consistent with the inclusion of the
menu bar in the calculated height.  It is also consistent with TTY
frames of GUI builds, for which tab-bar-height is always zero
anyway (bug#47234).  Fix suggested by Eli Zaretskii <eliz@gnu.org>.

* lisp/frame.el (frame-inner-height): Don't assume tab-bar-height is
defined in builds --without-x.

Prepare the Emacs 27.2 release.

* etc/HISTORY: Update for Emacs 27.2.

* README:
* configure.ac:
* nt/README.W32:
* msdos/sed2v2.inp: Set version to 27.2

; * admin/make-tarball.txt: Advise to remove stale subdirectories.

Document that `buffer-string' retains text properties

* doc/lispref/text.texi (Buffer Contents): Mention text properties
in the `buffer-string' documentation.
* src/editfns.c (Fbuffer_string): Mention text properties in the
doc string (bug#47220).

(cherry picked from commit 60af754170f22f5d25510af069ed0ebfec95f992)

Remove duplicate @table item from ELisp manual

* doc/lispref/objects.texi (Special Read Syntax): Remove duplicate
item "#@N" from the table of Special Read Syntax.  (Bug#47200)

Fix reference to 'diff-font-lock-syntax' in diff-mode documentation

* doc/emacs/files.texi (Diff Mode): Add the omitted name of the
variable.  (Bug#47129)

Fix buffer overflow in xbm_scan (bug#47094)

* src/image.c (xbm_scan): Ensure reading a string doesn't overflow the
buffer.

(cherry picked from commit ebc3b25409dd614c1814a0643960452683e37aa3)

Fix typos and omissions for (elisp)Button Buffer Commands

* doc/lispref/display.texi (Button Buffer Commands): Minor
typo and omission fixes `backward-button' and
`forward-button'.  (Bug#47051)

Teach Rmail about NBSP in "Re:"

* lisp/mail/rmail.el (rmail-simplified-subject)
(rmail-reply-regexp): Allow NBSP in "RE:" prefixes.

Revert "* lisp/mouse.el: Fix mouse-1-clock-follows-mouse = double"

This reverts commit 02a5cfce471613f671722b35536d2a78f17b0429.
That commit breaks because of a missing patch to `parse_modifiers_uncached`
in `src/keyboard.c`.  IOW, too risky for `emacs-27`.

Don't merge to `master`.

* lisp/mouse.el: Fix mouse-1-clock-follows-mouse = double

This functionality was broken by commit 3d5e31eceb9dc1fb62b2b2,
the problem being that we end up considering as distinct the events
`down-double-mouse-1` and `double-down-mouse-1`.

Reported by Eyal Soha <eyalsoha@gmail.com>

(mouse--click-1-maybe-follows-link): Make sure the last element of
the list passed to `event-convert-list` is indeed a "basic" event.

* lisp/emacs-lisp/gv.el (edebug-after): Don't run the getter in the setter

This fixes bug#46573 which was introduced by commit
d79cf638f278e50c22feb53d6ba556f5ce9d7853.
The new code is a middle ground, which makes sure the instrumentation
point is used (so the coverage checker won't have ghost unreachable
instrumentation points) yet without artificially running the getter
when we only need to run the setter.

* doc/misc/tramp.texi (Remote shell setup): Fix reference. (Do not merge)

Fix initialization of 'while-no-input-ignore-events'

* src/keyboard.c (syms_of_keyboard_for_pdumper): Don't reset
'while-no-input-ignore-events' after loading the dump file.
(Bug#46940)

Update documentation of reading passwords

* doc/emacs/mini.texi (Passwords): Update to match the modified
implementation.  (Bug#46902)  Add indexing.

Improve the 'dired-do-kill-lines' doc string

* lisp/dired-aux.el (dired-do-kill-lines): Document the FMT
parameter (bug#46867).

(cherry picked from commit b9cb3b904008a80c69ab433f4851377967b100db)

; Auto-commit of loaddefs files.

Avoid crashes in Mew due to corrupted tool-bar label

* src/gtkutil.c (update_frame_tool_bar): Don't keep around a
'char *' pointer to a Lisp string's contents when calling Lisp,
because that could relocate string data; keep the Lisp string
itself instead.  This avoids crashes in Mew.  (Bug#46791)

* lisp/tooltip.el (tooltip): Doc fix for GTK.

* lisp/help.el (help-for-help-internal): Doc fix; use imperative.

More accurate documentation of the "r" interactive spec

* doc/lispref/commands.texi (Interactive Codes): Describe the
effect of 'mark-even-if-inactive'.

Mention the GNU Kind Communications Guidelines in the FAQ

* doc/misc/efaq.texi (Guidelines for newsgroup postings): Mention
the GNU Kind Communications Guidelines.

; * CONTRIBUTE: Another wording change regarding tiny changes.

Allow newlines in password prompts again in comint

* lisp/comint.el (comint-password-prompt-regexp): Match all
whitespace (including newline) at the end of the passphrase, not
just space and \t (bug#46609).
(comint-watch-for-password-prompt): Remove trailing newlines from
the prompt (bug#46609).

Copyright-paperwork-exempt: yes

Avoid point movement when visiting image files

* lisp/image-mode.el (image-toggle-display-image): Preserve point
around the call to exif-parse-buffer, to prevent it from moving
into the image data.  (Bug#46552)

; * CONTRIBUTE: Yet another clarification of significant changes.

Avoid assertion violation in callproc.c

* src/callproc.c (call_process): Avoid assertion violation when
DESTINATION is a cons cell '(:file . "FOO")'.  (Bug#46426)