Clarify when to use advice-add vs add-function

* lisp/emacs-lisp/nadvice.el (add-function): Note in docstring that
advice-add should be used for named functions.

Minor formatting tweak in the Emacs manual

* doc/emacs/custom.texi (Directory Variables): Don't have 2
footnotes back to back, it looks bad in HTML.  (Bug#31555)

Update comments in Intro to Emacs Lisp

* doc/lispintro/emacs-lisp-intro.texi: Explain in the comments
what are roman page numbers in Preface about.  (Bug#31541)

; * doc/os.texi (Batch Mode): use = after --eval

* etc/NEWS: Mention change in `edebug-prin1-to-string'.

; * doc/lispref/hash.texi (Defining Hash): Fix typos.

Another attempt to fix sql.el

* lisp/progmodes/sql.el (sql-product-interactive): Fix calculation
of the SQL buffer name.  (Bug#31446)

Update binding of 'M-.' in Intro to Emacs Lisp

* doc/lispintro/emacs-lisp-intro.texi (On Reading this Text)
(Finding More, Buffer Related Review, Buffer Exercises)
(Find a File, Conclusion): 'M-.' is now bound to
'xref-find-definitions'.  (Bug#31542)

Fix a typo in last change in sql.el

* lisp/progmodes/sql.el (sql-product-interactive): Use 'null',
not 'zerop'.  (Bug#31446)

Fix capitalization of mail headers

* doc/emacs/sending.texi (Mail Format, Mail Headers)
(Mail Aliases, Header Editing): Use consistent capitalization of
CC, BCC, and FCC.  (Bug#31532)

Fix buffer names in sql.el

* lisp/progmodes/sql.el (sql-product-interactive): Fix the way the
buffer name is determined by prefix arg.  (Bug#31446)

Minor fixes in the Emacs manual

* doc/emacs/misc.texi (Gnus Group Buffer): Fix a typo.  (Bug#31534)
(Single Shell): Rephrase an unclear sentence.  (Bug#31535)
(Remote Host): Use @command where appropriate.  (Bug#31536)

Fix a typo in rmail.texi

* doc/emacs/rmail.texi (Rmail Summary Edit): Add markup to 'nil'.
(Bug#31533)

* etc/PROBLEMS: Document Bug#31305.

(gnus-blocked-images): Clarify privacy implications

* lisp/gnus/gnus-art.el (gnus-blocked-images): Clarify the privacy
implication of altering the value of this variable.

(cherry picked from commit f4d9fd3dd45f767eca33fbf1beee40da790fa74e)

Fix a typo in describing input methods

* lisp/help-mode.el (help-make-xrefs): Fix a typo.  (Bug#31448)

; Add a comment to emacs-lisp-intro.texi

* doc/lispintro/emacs-lisp-intro.texi: Add a comment with the
rationale for the manual's seemingly too large size.

Clarify the mode-line indicators in CC Mode

* doc/emacs/programs.texi (Electric C): Explain '*' and '/' in the
CC Mode mode-line.  (Bug31445)

Fix filesystem littering by Flymake's legacy backend

The Flymake legacy "proc" backend, which is active by default will try
to syntax-check foo.c/foo.cpp and many other types of files, but on
failing to find a suitable Makefile target, will fail.  There's
nothing wrong with that except that it used to leave behind the
foo_flymake.c and foo_flymake.cpp auxiliary files behind, littering
the filesystem.

* lisp/progmodes/flymake-proc.el (flymake-proc-legacy-flymake):
Call init-function inside of the unwind-protect.

; Fix a typo in the Emacs manual

* doc/emacs/fixit.texi (Transpose): Fix a typo.  Reported by
Takesi Ayanokoji <ayanokoji.takesi@gmail.com>.

* doc/emacs/help.texi: Fix paren typo.

More minor changes in shell-related nodes of Emacs manual

* doc/emacs/misc.texi (Interactive Shell): Clarify how the window
that displays "*shell*" is selected.
(Shell Prompts): Fix a typo.  Reported by Jorge
<jorge+list@disroot.org> in emacs-manual-bugs.

Fix inaccuracies in "Shell Ring" node of Emacs manual

* doc/emacs/misc.texi (Shell Ring): Don't mention 'M-s' and don't
insist on Shell history commands being "jsut like" similar
commands that operate on minibuffer history.  Reported by Jorge
<jorge+list@disroot.org> in emacs-manual-bugs.

Improve documentation of kmacro commands and variables.

* lisp/kmacro.el (kmacro-start-macro-or-insert-counter)
(kmacro-counter, kmacro-set-format, kmacro-set-counter)
(kmacro-add-counter, kmacro-counter-format)
(kmacro-insert-counter): Clarify and improve the doc strings.
(Bug#31243)

* doc/man/emacs.1.in: Document --fg-daemon and --bg-daemon.

Don't check non-X frames for z order (Bug#31373)

* src/xfns.c (x_frame_list_z_order): Only use frames with
`output_method' set to `output_x_window'.

Check NSWindow is actually a frame

* src/nsfns.m (Fns_frame_list_z_order): Check NSWindow is an instance
of EmacsView before treating it as one.

Fix gud-statement for pdb

* lisp/progmodes/gud.el (pdb): Fix the gud-print implementation.
(Bug#31363)

; * msdos/INSTALL: Add info about GCC versions.

Document 'custom-group'

* doc/lispref/customize.texi (Group Definitions): Document the
'custom-group' property.

A minor addition to etc/DEBUG

* etc/DEBUG: Add a note for macOS users who get error messages
when trying to run GDB.

Avoid errors in ispell.el when Enchant returns empty extra chars

* lisp/textmodes/ispell.el (ispell--get-extra-word-characters):
Handle the case of empty extra characters returned by the
Enchant '-lsmod' command. (Bug#31344)

Copyright-paperwork-exempt: yes

Make 'ispell-initialize-spellchecker-hook' work again

* lisp/textmodes/ispell.el (ispell-base-dicts-override-alist):
Defvar it to allow dynamic binding.  (Bug#31341)

Handle selected_window change in prepare_menu_bars (Bug#31312)

* src/xdisp.c (redisplay_internal): Check selected_window after
calling prepare_menu_bars, since it can call lisp hooks.

; * INSTALL: Fix Emacs version number.  (Bug#31358)

Fix report-emacs-bug via mailclient on MS-Windows

* lisp/net/browse-url.el (browse-url-default-windows-browser):
On MS-Windows, call url-unhex-string only for file:// URLs.
(Bug#31351)

Port collation tests to glibc 2.27

* test/src/fns-tests.el (fns-tests-collate-strings)
(fns-tests-collate-sort): Don’t make unportable assumptions
about how en_US.UTF-8 collation works.  These assumptions
are not true on Fedora 28, which ships with glibc 2.27.

Port --enable-gcc-warnings to GCC 8

Backport from master.
* lib-src/emacsclient.c (fail):
Do not dereference a null pointer.
* src/frame.c (delete_frame):
Add a decl with UNINIT to work around GCC bug 85563.
* src/menu.h (finish_menu_items):
Do not use attribute const.
* src/regex.c (analyze_first): Use FALLTHROUGH, not a comment.

Advise CFLAGS= operand, not in environment, when configuring

Backport from master.

; * etc/DEBUG: Minor clarification.

Update the Emacs FAQ

* doc/misc/efaq.texi (Latest version of Emacs): Update versions.
(New in Emacs 26): New node.

* admin/release-process: Mention the FAQ update as part of the
release.

* etc/DEBUG: Minor copyedits.

Clarify wording of NS drag n drop documentation

* doc/emacs/macos.texi (Mac / GNUstep Events): Clarify wording of
ns-drag-n-drop description.

Improve kill-related documentation (bug#31209)

* doc/lispref/text.texi (Low-Level Kill Ring): Fix typo under
current-kill.  Mention interprogram-paste-function under kill-new
and kill-append.
* lisp/simple.el (save-interprogram-paste-before-kill, kill-new)
(kill-append-merge-undo, kill-append): Touch-up docstrings.

* lisp/simple.el (region-extract-function): Don't hide the 'nil' case.

Fix pre- and post-command-hook errors in term.el

Before this patch, after the terminal process dies the command
hooks added in term-mode's char mode would produce errors.
This fix removes these hooks when the process dies.
* lisp/term.el (term-handle-exit): Remove pre-command-hook and
post-command-hook because the process is dead.  (Bug#31236)

Copyright-paperwork-exempt: yes

* doc/lispref/display.texi (Glyphless Chars): Fix grammar.

Fix macOS drag n drop event documentation

* doc/emacs/macos.texi (Mac / GNUstep Customization): Remove
references to color panel.
(Mac / GNUstep Events): Remove ns-drag-file, and add ns-drag-n-drop.

Update the documentation of 'perform-replace'

* doc/lispref/searching.texi (Search and Replace): Update the
documentation of 'perform-replace'.

* etc/NEWS: Another fix for the last change (noted by Juri Linkov)

Fix use of @key in Texinfo manuals

* doc/misc/efaq-w32.texi (Location of init file):
* doc/misc/org.texi (Editing source code, Export settings)
(Closing items, Drawers, Structure editing):
* doc/misc/gnus.texi (Spam and Ham Processors, Terminology):
* doc/misc/calc.texi (Keypad Functions Menu, Keypad Binary Menu)
(Keypad Vectors Menu, Keypad Main Menu, Basic Arithmetic)
(Symbolic Mode):
* doc/misc/sc.texi (Electric References):
* doc/misc/info.texi (Help-^L):
* doc/misc/reftex.texi (Reference Styles):
* doc/misc/idlwave.texi (Troubleshooting, Examining Variables)
(Lesson III---User Catalog, Using the Shell):
* doc/misc/eshell.texi (Bugs and ideas):
* doc/misc/ada-mode.texi (Automatic Casing):
* doc/misc/ediff.texi (Selective Browsing):
* doc/misc/vip.texi (Customizing Constants):
* doc/misc/pcl-cvs.texi (Selected files):
* doc/misc/efaq.texi (Replying to the sender of a message)
(Basic keys, No Meta key, Matching parentheses)
(Origin of the term Emacs, Installing Texinfo documentation)
(Learning how to do something, Emacs manual, Extended commands):
* doc/misc/viper.texi (Rudimentary Changes):
* doc/misc/tramp.texi (Frequently Asked Questions):
* doc/emacs/kmacro.texi (Basic Keyboard Macro):
* doc/emacs/frames.texi (Frame Commands):
* doc/emacs/msdos.texi (Windows Keyboard):
* doc/emacs/search.texi (Query Replace):
* doc/lispintro/emacs-lisp-intro.texi (Keybindings)
(Note for Novices):
* doc/lispref/tips.texi (Key Binding Conventions): Fix use of
@key.  For the details, see
http://lists.gnu.org/archive/html/emacs-devel/2018-04/msg00390.html.

Improve documentation of actual arglist

* doc/lispref/functions.texi (Function Documentation): Advise
against using '(fn ARGLIST)' method of advertising a calling
convention when the old calling convention is deprecated.
(Bug#31191)

; * etc/NEWS: Improve last change as proposed by Phil Sainty

Don't assume term-current-row cache is valid (Bug#31193)

* lisp/term.el (term-down): Call `term-current-row' instead of
directly accessing the variable `term-current-row.  Following a resize
of the terminal's window, `term-current-row' is reset to nil, so it is
not safe to assume it is a number.

; * etc/NEWS: Mention 'display-buffer-in-major-side-window' change (Bug#31194)

Fix flyspell-auto-correct-previous-word broken by recent change

* lisp/textmodes/flyspell.el (flyspell-auto-correct-word): Keep
flyspell-auto-correct-region also when repeatedly invoking
flyspell-auto-correct-previous-word.  (Bug#31188)

* test/src/lread-tests.el (lread-test-bug-31186): New test.

Fix undefined behaviour while looking for lexical-binding file variable (bug 31186)

* src/lread.c (lisp_file_lexically_bound_p): Reset
beg_end_state before reading variable or value.

Minor wording improvement in "Bookmarks"

* doc/emacs/regs.texi (Bookmarks): Improve wording.  Suggested by
"Siraphob (Ben) Phipathananunth" <siraben@disroot.org>.

Fix building etc/DOC in the MSDOS port

* msdos/sed1v2.inp (lisp.mk): Fix escaping in Sed commands.

* lisp/select.el (gui-get-selection): Doc fix.

; * doc/lispref/display.texi (Temporary Displays): Fix typos.

Complete documentation of syntax flags by adding `c'

* doc/lispref/syntax.texi ("Syntax Table Internals"): Add entry for `c'
as `(1 lsh 23)'.

Fix typos and minor wording issues in ELisp manual

* doc/lispref/internals.texi (Writing Emacs Primitives):
* doc/lispref/display.texi (Temporary Displays): Fix typos.
* doc/lispref/text.texi (Filling, Changing Properties)
(Transposition): Clarify and fix typos.
* doc/lispref/positions.texi (Screen Lines): Improve wording.
* doc/lispref/modes.texi (Minor Mode Conventions)
(Font Lock Multiline): Fix typos.
* doc/lispref/variables.texi (Dynamic Binding Tips): Fix a
cross-reference.  Fix a typo.
* doc/lispref/sequences.texi (Sequence Functions): Fix typos.
(Bug#31143)

Merge branch 'emacs-26' of git.savannah.gnu.org:/srv/git/emacs into emacs-26

Avoid segfault in processes of type 'pipe'

* src/process.c (Fmake_pipe_process): Set up the decoding and
encoding buffers.  For the details, see
http://lists.gnu.org/archive/html/emacs-devel/2018-04/msg00295.html.

Remove repetitions in documentation strings

* lisp/bindings.el (right-word): Remove repetition
(left-word): Likewise.

* lisp/image-mode.el (image-mode-as-hex): Likewise.

* lisp/cedet/semantic/tag-ls.el (semantic-tag-similar-p): Likewise.

* lisp/textmodes/reftex-vars.el (reftex-view-crossref-extra): Likewise

* lisp/image.el (image-load-path): Doc fix.

; * etc/NEWS: Remove a FIXME.  (Bug#31122)

; * ChangeLog.3: Update.

* etc/AUTHORS: Regenerate.

* lisp/files.el (kept-new-versions): Improve documentation string.

Fix a minor mistake in the ELisp manual

* doc/lispref/files.texi (Reading from Files): Fix copy/paste
mistake.  (Bug#31107)

; * src/dispextern.h (struct it): Fix a typo in a comment.

* lisp/files.el (find-file-literally): Doc fix.

Fix typos in doc strings

* lisp/simple.el (undo-auto--boundary-timer)
(undo-auto--boundary-ensure-timer): Fix typos in doc strings.

Bump Emacs version to 26.1

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

; * ChangeLog.3: Update.

* lisp/emacs-lisp/inline.el: Clarify apparent typos

; * lisp/auth-source.el (auth-sources): Update the :version tag.

Allow sexp customization type in auth-sources

* lisp/auth-source.el (auth-sources): Allow sexp customization type.
Update the :version tag.

(cherry picked from commit 447da5b0d49b7aa14fa5d6969015770fdf9b9f92)

; * lisp/ldefs-boot.el: Update.

* etc/NEWS: Remove temporary markup.

* Update etc/AUTHORS

* ChangeLog.3: Update

Fix Bug#31022

* lisp/cus-start.el (temporary-file-directory): Suppress file name
handlers when calling `shell-command-to-string'.  (Bug#31022)

Update "Calendrical Calculations" cites

* lisp/calendar/calendar.el: Update citations to the book
"Calendrical Calculations" and its predecessors.

; * doc/lispref/compile.texi (Compilation Functions): Fix wording.

; * doc/lispref/compile.texi (Compilation Functions): Fix typo

Fix term.el rendering following a window resize (Bug#30544)

* lisp/term.el (term-reset-size): Reset cached row and column values
before changing point.

* files.el (auto-save-visited-mode): Don't prompt for filenames.

; * etc/NEWS: Improve the entry about pinentry.el removal.

Quote a few backticks in docstrings.

* lisp/emacs-lisp/macroexp.el (macroexp-progn, macroexp-let*)
(macroexp-if): Quote backtick in docstrings.

; Auto-commit of loaddefs files.

Minor copyedits of completion-at-point-functions documentation

* lisp/minibuffer.el (completion-at-point-functions):
* doc/lispref/minibuf.texi (Completion in Buffers): Fix wording
and filling.

(cherry picked from commit a8ddd05d7d32946b892b9faaba6c9736ed2ad847)

(completion-at-point-functions): Improve doc

(cherry picked from commit b56c56f203f8b066dd71e6ae6a254121b3ac3f08)

* lisp/net/shr.el (shr-browse-url): Doc fix.  (Bug#30957)

; * doc/emacs/msdos.texi: Fix wording of last change.

Mention `key-description' as inverse of `kbd' (Bug#30942)

* lisp/subr.el (kbd): Add `key-description' as inverse of `kbd' in the
doc.

Document return value of pcase (Bug#30425)

* doc/lispref/control.texi (Pattern matching case statement):
* lisp/emacs-lisp/pcase.el (pcase): State that pcase returns nil if no
patterns match.
(pcase-exhaustive): State that an error is signaled if no patterns
match.