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.

* doc/emacs/macos.texi: Tweak grammar and capitalization.

Distinguish free from non-free OSes

* doc/emacs/misc.texi (Amusements): Avoid non-printing character.

; Hey fellow kids, remember that gag from 2008?  Emacs does.

Fix xrefs in pdf Emacs manual

* doc/emacs/fortran-xtra.texi (ForIndent Cont, ForIndent Num)
(Fortran Columns):
* doc/emacs/picture-xtra.texi (Rectangles in Picture):
Fix recent changes that neglected the splitting of the pdf manuals.

* doc/misc/org.texi (Installation): Fix clone commands.

Update Org to v9.1.9

Please note this is a bugfix release. See etc/ORG-NEWS for details.

; Fix some tiny doc typos

De-obsolete `if-let' and `when-let'

For the following release it is planned to make `if-let*' and
`when-let*' aliases for `if-let' and `when-let'.  For now we revert
declaring `if-let' and `when-let' obsolete and tweak the docstrings.

* lisp/emacs-lisp/subr-x.el (if-let*, when-let*): Make docstrings
refer to those of `if-let' and `when-let'.
(if-let, when-let): De-obsolete.  Rewrite documentation.

* lisp/htmlfontify.el (hfy-begin-span-handler): Doc fix.

* doc/lispref/functions.texi (Defining Functions): Improve indexing.

Fix crash after frame is freed on macOS (bug#30800)

* src/nsterm.m (x_free_frame_resources): Clear represented_frame.
(bug#30800)

More manual editing

* doc/emacs/basic.texi:
* doc/emacs/calendar.texi:
* doc/emacs/display.texi:
* doc/emacs/mini.texi:
* doc/emacs/misc.texi:
* doc/emacs/picture-xtra.texi:
* doc/misc/info.texi: Prefer <PageDown> and <PageUp> over
<next> and <prior>.  Add missing @kindex entries.

* doc/emacs/custom.texi (Function Keys): Fix and add missing
key symbols.

Minor manual changes changes

* doc/emacs/misc.texi (FFAP): Complete commands.
(Amusements): Add some @cindex entries.  Add "M-x butterfly".

* lisp/calculator.el (calculator-paste-decimals): Add version.

; Use GNU not Gnu in docs

More proofreading of the Emacs manual

* doc/emacs/trouble.texi (DEL Does Not Delete): Improve wording.
(Screen Garbled): Mention the command name.
(Bug Criteria): Mention that problems in packages should first be
reported to the respective maintainers.
(Checklist): Fix wording.
(Contributing, Copyright Assignment): Minor copyedits.
* doc/emacs/misc.texi (Amusements): Remove Landmark.
* doc/emacs/picture-xtra.texi (Tabs in Picture): Improve wording.
(Rectangles in Picture): Add a cross-reference to "Registers".
* doc/emacs/misc.texi (Gnus Group Buffer, Gnus Summary Buffer):
Mention command names in parentheses.
(Gnus Summary Buffer): Document "M-r".
(Network Security): Document that current NSM works with TLS
encryption.  Fix markup.
(Document View): Improve wording and fix a typo.
(DocView Conversion): Rephrase description of
doc-view-cache-directory.
(Single Shell): Mention variables that control when shell output
appears in the echo area.
(Shell Mode): Improve wording.
(Shell Prompts): Fix a typo.
(Shell Ring, Term Mode): Mention command names.
(History References): Add a cross-reference to "Rebinding".
(Remote Host): Mention SSH.
(TCP Emacs server): Improve wording.
(emacsclient Options): Minor improvements.
(PostScript): Fix wording.
(PostScript Variables): Mention that ps-font-size could be a cons.
(Sorting): Minor improvements.  Suggested by Michael Albinus
<michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org

* src/lisp.h (struct Lisp_Buffer_Local_Value): Update commentary.

* doc/emacs/trouble.texi: Fix location of `emacs-version' index.

Explain more about (defvar foo) form (Bug#18059)

* doc/lispref/variables.texi (Defining Variables)
(Using Lexical Binding):
* doc/lispref/compile.texi (Compiler Errors): Emphasize that omitting
VALUE for `defvar' marks the variable special only locally.
* doc/lispref/variables.texi (Using Lexical Binding): Add example of
using `defvar' without VALUE.

* doc/lispref/buffers.texi (Buffer List): Fix grammar.

* doc/lispref/anti.texi (Antinews): Fix grammar.

* lisp/org/ob-lisp.el (org-babel-lisp-eval-fn): Tweak type.

Avoids type mismatch when relevant library is not present/loaded.

sql.el defcustom fixes

* lisp/progmodes/sql.el (sql-login-params): Update.
Avoids type mismatch with postgres and sqlite login params.
(sql-postgres-login-params): Bump version.

Document DEFUN attributes

* doc/lispref/internals.texi (Writing Emacs Primitives): Document
specification of function attributes in DEFUN.

* etc/NEWS: Add an entry for auth-source-pass.

Fix the MSDOS build

* msdos/sed2v2.inp (HAVE_SBRK): Define to 1.

Improve warning and error messages

* lisp/emacs-lisp/eieio-base.el (eieio-persistent-read,
  (eieio-persistent-validate/fix-slot-value): Indicate exactly what
  went wrong.

Adjust eieio persistence tests for expected failure

* test/lisp/emacs-lisp/eieio-tests/eieio-test-persist.el
 (eieio-test-persist-hash-and-vector,
  eieio-test-persist-interior-lists): Persistence does not currently
 handle deeply-nested objects. Expect current failures, and mark for
 future fixes.

Let eieio-persistent-read read what object-write has written

* lisp/emacs-lisp/eieio-base.el (eieio-persistent-validate/fix-slot-value):
  `object-write' may quote lists inside hash tables and vectors, so
  unquote those lists here.

This patch allows the eieio-persistent write/restore process to
perform a clean round trip. It only handles a very specific and
limited range of object structures, but at least the write and read
procedures match.

Handle possible classtype values in eieio-persistent-read

* lisp/emacs-lisp/eieio-base.el (eieio-persistent-validate/fix-slot-value):
  The function `eieio-persistent-slot-type-is-class-p' could return
  either a single class, or a list of classes.

Add new tests for eieio persistence

* test/lisp/emacs-lisp/eieio-tests/eieio-test-persist.el:
  (hash-equal): New comparison test for hash-tables.
  (persist-test-save-and-compare): Use test for hash-tables.
  (eieio-test-persist-hash-and-vector,
  eieio-test-persist-interior-lists): New tests.

* lisp/gnus/gnus-cloud.el (gnus-cloud-synced-files): Fix doc & type.

* lisp/ibuf-ext.el (ibuffer-never-search-content-mode): Fix type.

* doc/lispref/windows.texi (Selecting Windows): Fix a typo.

* doc/lispref/internals.texi (Writing Emacs Primitives): Fix grammar.

Firm up documentation of generalized variables

* doc/lispref/variables.texi (Generalized Variables)
(Setting Generalized Variables): Define a generalized variable as something
setf can write to.  Remove the insinuation that hackers have poor memories.
State explicitly that the list of GVs given is complete.  Remove the
suggestion that `setf' has superseded, or is in the process of superseding,
`setq'.  Make minor corrections to the English.

Improve documentation of Auto-Revert mode

* doc/emacs/files.texi (Reverting): Mention that Aut-Revert
applies to Dired buffers as well.  Suggested by Michael Albinus
<michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.