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

Improvements in dired.texi

* doc/emacs/dired.texi (Dired): Mention that Dired works with
remote directories.
(Dired Enter): ls-lisp is used on some remote systems as well.
(Dired Navigation): Mention and index the command names.
(Dired Deletion): Document the 'always' value of
dired-recursive-deletes.  Mention the alternative deletion method.
(Marks vs Flags): Fix spelling of Auto-Revert mode.  Document what
marking does on a subdirectory header line.
(Operating on Files): Document that 'Z' uses gzip or compress.
(Comparison in Dired): Mention ediff-files.
(Misc Dired Features): Fix a typo.  Suggested by Michael Albinus
<michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.

Revert "Support all perl variable declarators and prefixes"

It highlights normal variable names in perl programs (Bug#30812).
* lisp/progmodes/perl-mode.el (perl-imenu-generic-expression)
(perl-font-lock-keywords-2): Restore values prior to Bug#27613 fix.

Don't merge to master, we will fix Bug#27613 properly there (it's too
close to release to do that on emacs-26).

Port to 32-bit sparc64

Backport from master.
Problem reported by Ulrich Mueller; fix suggested by Eli Zaretskii
and Andreas Schwab (Bug#30855).
* src/alloc.c (mark_memory): Call mark_maybe_object only on
pointers that are properly aligned for Lisp_Object.

; Rewrap doc string

Correct Info link markup

* lisp/gnus/gnus-agent.el (gnus-agent-auto-agentize-methods):
Correct markup for Info link.
* src/minibuf.c (Fcompleting_read): Likewise.

Improve documentation of 'with-help-window'

* doc/lispref/help.texi (Help Functions): Change variable name
to 'buffer-or-name'.

* lisp/help.el (with-help-window): Change variable name to
'buffer-or-name' and rewrite the doc string, adding reference
to 'help-window-setup'.  (Bug#30792)

Minor improvements in building.texi

* doc/emacs/building.texi (Compilation Shell): Mention that this
section is for local compilation buffers.
(Compilation, Compilation Mode): Mention that 'g' is bound to
'recompile' in compilation buffers.
(Grep Searching): Add a cross-reference to "Compilation Mode".
Suggested by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.

* lisp/textmodes/bibtex.el (bibtex-mark-entry): activate mark

; Spelling fix

* doc/emacs/building.texi (Starting GUD): Mention 'guiler'.

Yet more proofreading of the Emacs manual

* doc/emacs/building.texi (Compilation, Grep Searching)
(Debuggers, GUD Customization, Source Buffers)
(Breakpoints Buffer, Threads Buffer): Minor fixes and updates.
Suggested by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.

* doc/emacs/rmail.texi: Fix broken link.

; Spelling fix

Fix recently-added POP doc glitch

* doc/emacs/rmail.texi (Remote Mailboxes):
POP3 → POP, when talking about POP in general.

More proofreading of the Emacs manual

* doc/emacs/macos.texi (Mac / GNUstep Basics): Fix typos.  Improve
indexing.
(Mac / GNUstep Basics, Mac / GNUstep Customization)
(Mac / GNUstep Events): Improve indexing.

* doc/emacs/rmail.texi (Rmail): Mention Gnus.
(Rmail Basics, Rmail Scrolling): Improve cross-references and
indexing.
(Rmail Motion): Minor improvements.
(Rmail Inbox): Remove outdated text about Babyl format.
(Rmail Files): Formatting changes.  Comment out
set-rmail-inbox-list in the table of commands, as it is commented
out in the text that follows.
(Rmail Output, Rmail Labels, Rmail Reply, Rmail Make Summary):
Minor copyedits.
(Rmail Summary Edit): Document
rmail-summary-scroll-between-messages.
(Rmail Editing): Improve indexing.
(Movemail): Fix typos.
(Remote Mailboxes): Use "POP3" rather than "POP".

Fix typo in the Emacs manual's VC chapter

* doc/emacs/maintaining.texi (VC Directory Buffer): Fix a typo.

Pass json-readtable-error data as a list (bug#30489)

* lisp/json.el (json-readtable-dispatch): Fix error data.
* test/lisp/json-tests.el (test-json-read): Check error data is a
list.

Improve word motion docs (Bug#30815)

* doc/lispref/positions.texi (Word Motion): Fix reference to
`char-script-table'.
* lisp/simple.el (backward-word):
* src/syntax.c (forward-word): Mention `char-script-table' and add
link to the 'Word Motion' manual section.

Replace "carriage-return" by "carriage return" in manuals

* doc/emacs/msdos.texi:
* doc/emacs/mule.texi:
* doc/emacs/screen.texi:
* doc/lispref/nonascii.texi:
* doc/misc/calc.texi: Replace "carriage-return" by "carriage
return".  Suggested by Richard Stallman <rms@gnu.org> in
emacs-manual-bugs@gnu.org.

Minor copyedits in mule.texi

* doc/emacs/mule.texi (Recognize Coding, Fontsets): Minor changes
in wording.  Suggested by Richard Stallman <rms@gnu.org> in
emacs-manual-bugs@gnu.org.

Fix problems caused by fontconfig-2.13.0

* src/xterm.c (x_term_init): Call fixup_locale after
xg_initialize, to countermand the call to setlocale in some
versions of fontconfig.  (Bug#30788)

Fix some allout.el aliases

* lisp/allout.el (allout-passphrase-verifier-string)
(allout-passphrase-hint-string): Fix alias.

* lisp/progmodes/ada-mode.el (ada-clean-buffer-before-saving): Doc fix.

Doc fixes re obsolete items

* doc/emacs/mini.texi (Completion Commands): Small update re mouse.
* doc/misc/htmlfontify.texi (Customization): Replace obsolete alias.

Replace an obsolete alias in tpu-mapper

* lisp/obsolete/tpu-mapper.el (tpu-map-key, tpu-mapper):
Replace obsolete alias.

Doc fixes re obsolete items

* doc/emacs/maintaining.texi (VC Undo):
* doc/misc/efaq-w32.texi (Font names): Replace obsolete aliases.
* doc/misc/url.texi (Customization):
Don't mention url-temporary-directory, it essentially does nothing.
* lisp/hilit-chg.el
(highlight-changes-global-changes-existing-buffers): Doc fix.
; * lisp/w32-fns.el: Comment.
; * etc/TODO: Remove obsolete ffap mention.

Minor changes in mule.texi

* doc/emacs/mule.texi (International, Coding Systems)
(Bidirectional Editing): Minor wording changes and typo fixes.
Suggested by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.

Avoid assertion violation under visual-order-cursor-movement

* src/xdisp.c (Fmove_point_visually): Don't let point exceed the
BEGV..ZV range.  Signal Beginning of buffer error when there's a
before-string at BEGV.  (Bug#30787)

Stop mentioning options.el in doc

* doc/misc/calc.texi (Customizing Embedded Mode):
Remove mentions of the obsolete (since 22.1) options.el.
* lisp/progmodes/meta-mode.el: Comment fix.

; * lisp/minibuffer.el (completion-cycle-threshold): Fix last change.

* lisp/vc/vc-dir.el (vc-dir-unmark): Fix documentation.

* lisp/minibuffer.el (completion-cycle-threshold): Doc fix.

Fix last change in Xref documentation

* doc/emacs/maintaining.texi (Looking Up Identifiers): More
accurate wording for the description of xref-etags-mode.

More changes in the Emacs manual

* doc/emacs/text.texi (Words, Foldout, Table Conversion): Clarify
text.  Reported by Gijs Hillenius <gijs@hillenius.net> in
emacs-manual-bugs@gnu.org.

* doc/emacs/msdos.texi (Windows Keyboard):
* doc/emacs/msdos-xtra.texi (MS-DOS Keyboard):
* doc/emacs/macos.texi (Mac / GNUstep Basics):
* doc/emacs/glossary.texi (Glossary):
* doc/emacs/custom.texi (Function Keys, Init Syntax):
* doc/emacs/commands.texi (User Input):
* doc/emacs/basic.texi (Arguments): Fix capitalization of "Meta".
* doc/emacs/msdos.texi (Windows Keyboard):
* doc/emacs/dired.texi (Dired Updating):
* doc/emacs/custom.texi (Init Rebinding): Fix misuses of @key.
Suggested by Richard Stallman <rms@gnu.org>.

Improve documentation of Xref

* doc/emacs/maintaining.texi (Looking Up Identifiers): Document
xref-etags-mode.

Fix create_process bug breaking eudc-expand-inline

Problem reported by Thomas Fitzsimmons (Bug#30762).
* src/process.c (create_process) [HAVE_PTYS]:
Call setsid even if !PTY_FLAG.

Clarify that nil doesn't match itself as a cl-case clause (Bug#30749)

* lisp/emacs-lisp/cl-macs.el (cl-case): Mention that the ATOM
=> (ATOM) short form is only for non-nil ATOMs.

Improve SVG documentation

* doc/lispref/display.texi (ImageMagick Images): Remove an
outdated comment that references a fixed bug.
(SVG Images): Fix grammar, and call functions functions (there are
no commands in lisp/svg.el).

Document the "URL" keyword in library headers

* doc/lispref/tips.texi (Library Headers): "URL" is an alias for
"Homepage".  Suggested by Peter Oliver <p.d.oliver@mavit.org.uk>.
(Bug#30571)

* test/lisp/international/mule-tests.el:
Avoid local variables confusion.

; * lisp/org/org-table.el: Replace obsolete alias in comment.

Add missing findex entries for recently removed kindex entries

* doc/misc/mh-e.texi:

(cherry picked from commit a56a3fc6849b89a71c9a00afcb088021ccbe94e5)

Replace the obsolete process-kill-without-query in documentation

* lisp/comint.el (comint-exec-hook):
* lisp/term.el (term-exec-hook):
* lisp/eshell/esh-proc.el (eshell-exec-hook):
Doc fixes re the obsolete process-kill-without-query.
; * lisp/net/ange-ftp.el: Comment.

; Tiny fix for recent doc change

Minor change in the manual

* doc/emacs/display.texi (Useless Whitespace):
Don't upcase "TAB" and "SPC" when alluding to characters.

More minor changes in the manual

* doc/emacs/display.texi (Useless Whitespace): Don't upcase "TAB"
and "SPC" when alluding to characters.  Suggested by Richard
Stallman <rms@gnu.org>.

* doc/emacs/buffers.texi (Misc Buffer): Clarify what "read-only"
means for buffers.
(Buffers): Define and describe "buffer contents".  Suggested by
Richard Stallman <rms@gnu.org>.  (Bug#30685)

Replace some obsolete aliases in code

* lisp/net/eudc-bob.el (eudc-bob-mail-keymap):
* lisp/textmodes/reftex-toc.el (reftex-make-separate-toc-frame):
Replace obsolete aliases.

Replace some obsolete aliases in documentation

* doc/misc/efaq-w32.texi (Incoming mail with Rmail):
* doc/misc/speedbar.texi (Major Display Modes):
* lisp/mh-e/mh-folder.el (mh-restore-desktop-buffer):
Doc fixes re obsolete aliases.
; * lisp/autoinsert.el (auto-insert):
; * lisp/ffap.el (ffap-newfile-prompt):
; * lisp/woman.el (woman-insert-file-contents): Comment fixes.

Minor improvements in manuals

* doc/lispref/variables.texi (Local Variables): Make more clear
that local bindings of 'let' are in effect only within the body.
Suggested by Marcin Borkowski <mbork@mbork.pl>, see
http://lists.gnu.org/archive/html/emacs-devel/2018-03/msg00217.html
for the details.

* doc/emacs/programs.texi (Matching): Fix a typo.  Reported by
Alex Branham <alex.branham@gmail.com> in emacs-manual-bugs@gnu.org.
Improve indexing.

Minor copyedits in display.texi

* doc/emacs/display.texi (Highlight Interactively)
(Useless Whitespace, Line Truncation, Visual Line Mode): Minor
changes of wording and typo corrections.  Suggested by Michael
Albinus <michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.

Remove some unused spam.el variables

* lisp/gnus/spam.el (spam-ifile-path, spam-ifile-database-path)
(spam-bogofilter-path, spam-bsfilter-path)
(spam-spamassassin-path, spam-sa-learn-path):
Remove variables that are described as obsolete, but are
really completely unused, and have been for years.