* 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)

; * CONTRIBUTE: Clarify the "15-lines" rule a bit more.

Clarify "changes" in CONTRIBUTE

* CONTRIBUTE: Clarify that "changes" doesn't include removing code
(bug#44834).

(cherry picked from commit 33c9556c9db9b8c62dcd80dd3cc665e669ea66d4)

Clarify when activate-mark-hook is run

* doc/lispref/markers.texi (The Mark):
* lisp/simple.el (activate-mark-hook): Clarify when the hook is
run (bug#23444).

Fix language-environment and font selection on MS-Windows

These changes improve setting the language-environment and font
selection when MS-Windows returns useless "ZZZ" as the "language
name", which then disrupts all the setup of the locale-dependent
stuff, and in particular font selection.
* lisp/w32-fns.el (w32-charset-info-alist): Add an element for
"iso8859-5", in case LANG is set to something unusable, like
"ZZZ".  This allows fonts capable of displaying Cyrillic
characters to be used even when language preferences are screwed.

* src/w32.c (init_environment): If GetLocaleInfo returns "ZZZ" as
the "language name" for LOCALE_USER_DEFAULT, try again with locale
ID based on what GetUserDefaultUILanguage returns.  (Bug#39286)

Fix example in Sequence Functions node in the manual

* doc/lispref/sequences.texi (Sequence Functions): Fix the result
from the example.

Improve doc string of 'text-scale-adjust'

* lisp/face-remap.el (text-scale-adjust): Clarify that "default
face height" refers to the 'default' face.  (Bug#25168)

Clarify the indent-rigidly doc string

* lisp/indent.el (indent-rigidly): Clarify exiting the transient
mode (bug#46296).

Fix two small tab bar issues

* lisp/cus-start.el (frame-inhibit-implied-resize): Update version tag.
* lisp/frame.el (frame-inner-height): Do not count in tab bar.

Fix last change in syntax.texi

* doc/lispref/syntax.texi (Syntax Properties): Fix wording in last
change.  (Bug#46274)

Correct the lispref manual about flushing ppss info

* doc/lispref/syntax.texi (Syntax Properties): Correct the
information about flushing the state by copying the text from the
doc string (bug#46274).

(cherry picked from commit ff701ce2b261acce1dfcd1fe137268d87d5eab35)

Clarify how transient indentation modes are exited in the manual

* doc/emacs/indent.texi (Indentation Commands): Clarify that the
other keys don't just exit the transient mode, but are also
handled as normally (bug#46296).

Fix the previous change

* lisp/progmodes/project.el (project-find-regexp):
Fix the previous change (project-root is not defined in this version).
(project-or-external-find-regexp): Same.

Bind default-directory to the project root

* lisp/progmodes/project.el (project-find-regexp):
Bind default-directory to the project root, to save this value
in the resulting buffer (esp. if the project selector was used,
(https://lists.gnu.org/archive/html/emacs-devel/2021-02/msg00140.html).
(project-or-external-find-regexp): Same.

(cherry picked from commit c07ebfcbe084e8219d8c2588f23f77ba4ef39087)

Make sure default-directory relates to the originating buffer

* lisp/progmodes/xref.el (xref--show-xref-buffer):
Pick up default-directory value from the caller
(https://lists.gnu.org/archive/html/emacs-devel/2021-01/msg00551.html).
(xref-show-definitions-buffer-at-bottom): Same.

(cherry picked from commit 6e73e07a6f5cbdd1c5ae6e0f3fbd0f8f56813f1a)

Initialize signal descriptions after pdumping

* src/sysdep.c (init_signals) [!HAVE_DECL_SYS_SIGLIST]: Reinit
sys_siglist also after pdumping.  (Bug#46284)

Clarify the "Sentinels" node in the lispref manual

* doc/lispref/processes.texi (Sentinels): Mention "run" and that
the strings can be anything (bug#30461).

(cherry picked from commit 859a4cb6b22f75a3456e29d08fcfe9b8940fbe8b)

Fix problem with non-ASCII characters in nnmaildir

* lisp/gnus/nnmaildir.el (nnmaildir-request-article): Enable
multipart 8bit-content-transfer-encoded files to be displayed
correctly by reading as `raw-text' instead of having Emacs
(incorrectly) decode the files (bug#44307).

Copyright-paperwork-exempt: yes

* lisp/window.el (recenter-top-bottom): Clarify doc string.

url-http.el: Special-case NTLM authentication

* lisp/url/url-http.el (url-http-handle-authentication): Do not
signal an error on NTLM authorization strings.  (Bug#43566)

* lisp/isearch.el (isearch-lazy-highlight): Fix defcustom type (bug#46208)

Sync latest SKK-JISYO.L

* leim/SKK-DIC/SKK-JISYO.L: Sync to current upstream version.

; emacs-26 → emacs-27

Fix build failure on macOS 10.7 (bug#46036)

* src/nsfns.m (ns_set_represented_filename): Define the NSNumber in a
more compatible manner.

Improve documentation of auto-resize-tool/tab-bars

* src/xdisp.c (syms_of_xdisp) <auto-resize-tool-bars>
<auto-resize-tab-bars>: Doc fix.  (Bug#46178)

(xref-revert-buffer): Also 'erase-buffer' when handling a user-error

* lisp/progmodes/xref.el (xref-revert-buffer):
Also 'erase-buffer' when handling a user-error (bug#46042).

(cherry picked from commit e86b30d6fd04070b86560774ec82392dbe24ca1e)

Update files for 27.1.91 pretest

* ChangeLog.3:
* etc/AUTHORS
* lisp/ldefs-boot.el: Update.

Bump Emacs version to 27.1.91

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

Improve documentation of 'read-regexp' and friends

* doc/emacs/glossary.texi (Glossary): Add "Tag" to the Glossary.
* doc/emacs/maintaining.texi (Xref): Mention that identifiers are
also known as "tags".

* lisp/replace.el (read-regexp, read-regexp-suggestions): Improve
wording of doc strings.  (Bug#46088)  (Bug#46089)

(cherry picked from commit 49eb03d6c8a181fd46adbbcf1f0a976d0a9efa87)

read-regexp-suggestions doc string improvement

* lisp/replace.el (read-regexp-suggestions): Add a link to the
manual to explain what a tag is (bug#46089).

(cherry picked from commit f9cc2d48246fe8370e9286866e6115ba8e2acf44)

Try to improve the read-regexp doc string

* lisp/replace.el (read-regexp): Attempt to clarify the semantics
(bug#46088).

(cherry picked from commit eded2a7ad7d456a417354a2797c18e9a578414d7)

; xref-revert-buffer: Drop the (goto-char) at the end

(cherry picked from commit cc98d0bf5225c281f91152aa838c4cb093df52e9)

Erase the buffer only after fetching the new contents

* lisp/progmodes/xref.el (xref-revert-buffer):
Erase the buffer only after fetching the new contents (bug#46042).

(cherry picked from commit 5821dee0949b2913c07970d6e4b8bb8e8a35f036)

Fix last change

* doc/lispref/text.texi (Undo): Add a cross-reference to the
description of 'undo-amalgamate-change-group'.
(Atomic Changes): Expand and improve the description of
'undo-amalgamate-change-group'.  (Bug#42303)

Mention undo-amalgamate-change-group in the lispref manual

* doc/lispref/text.texi (Atomic Changes): Mention
undo-amalgamate-change-group (bug#42303).

(cherry picked from commit ba25a82855a2c03c25fec83f3056c166b692e94f)

Avoid sending systemd shutdown notifications if non-daemon

* src/emacs.c (Fkill_emacs): Send the shutdown notification only
in daemon mode.  (Bug#46022)

* src/cmds.c (Fforward_line): Doc fix.  (Bug#46027)

Improve documentation of sendmail.el defcustom's

* lisp/mail/sendmail.el (mail-archive-file-name)
(mail-default-reply-to, mail-self-blind, mail-default-headers):
Say in the doc string that 'message-default-mail-headers' shall be
customized when using 'message-mode' for email composition.
(Bug#46029)

Don't let `maybe_quit` prevent resetting `consing_until_gc` (bug#43389)

* src/alloc.c (garbage_collect): Postpone `unblock_input` a bit.
* src/window.c (window_parameter): Avoid `maybe_quit`.

cherry picked from commit 420661af07448857f0a17e15dc27bceeb6aff541

; * lisp/language/cham.el: Fix copy-paste mistake in comment.

Remove one of recently added warnings abound binding keys in Isearch maps

* lisp/isearch.el (minibuffer-local-isearch-map): Remove comments
which warn against wantonly rebinding unbound keys from
irrelevant keymap.
https://lists.gnu.org/archive/html/emacs-devel/2021-01/msg00259.html