Standardize possessive apostrophe usage in manuals, docs, and comments

See the note in admin/notes/documentation.
Ref: https://lists.gnu.org/r/emacs-devel/2012-02/msg00649.html

(cherry picked from commit a79966156633ae1e49e3fef17ff7212c8f35a26f)

Don't refer to obsolete finder group "wp"

* lisp/textmodes/rst.el: Don't refer to obsolete finder group "wp".

(cherry picked from commit 67faaead754c0a11bd89fdcde2533bc51b71ef0e)

minibuffer.el: Default to 'regexp' style for 'search' completions

New command 'kubed-explain'

kubed.el: Add optional per-column value-formatting function

New commands 'kubed{-transient}-exec'

; Remove accidentally inserted text from docstring

* lisp/net/kubed.el (cronjob): New resource type

kubed.el: Fix filtering resource definition files by kind

kubed.el: Correctly handle spaces in resource properties

kubed.el: Minor cleanups

New commands 'kubed{-transient}-diff'

New commands 'kubed{-transient}-attach'

(kubed-forward-port-to-pod): Fix prompt

New commands 'kubed-transient', 'kubed-transient-run'

New command 'kubed-run'

Add more default completion styles for 'cobra-command-line'

(kubed-pods-{dired,shell}): Use new Tramp file name syntax

Tramp's method "kubernetes" supports now optional namespace

* doc/misc/tramp.texi (Inline methods): Extend Kubernetes host
name syntax by an optional namespace.
(Kubernetes setup): Mention optional namespace part of the host name.

* etc/NEWS: Tramp's method "kubernetes" supports now optional namespace.
Fix typos.

* lisp/net/tramp-container.el (tramp-kubernetes-namespace):
Initialize with nil.  Adapt docstring.
(tramp-kubernetes--name-regexp): New defconst.
(tramp-kubernetes--host-name-regexp): Change in order to cover
also an optional namespace.  (Bug#59797)
(tramp-kubernetes--namespace): New defun.
(tramp-kubernetes--context-namespace): Use it.
(tramp-skeleton-kubernetes-vector): Add sanity check for
superfluous user name or port number.

(cherry picked from commit d2cb9f2bf6ef9f3fcd8c21455ca1f1e624e61bf4)

Fix cherry-picking of d458664e893cd74f46bf9d00559ff5386c3dbf44

; * doc/emacs/misc.texi (Document View): Improve wording (bug#72241).

(cherry picked from commit ba31c62f815537c0412eb84e8188cc5c3c4948b1)

Fix jumping to page in DocView's text contents (bug#72275)

* lisp/doc-view.el (doc-view-open-text): Set page-delimiter to the form
feed character in the text contents buffer (bug#72275).

(cherry picked from commit c6937ef88b19d46342cefc1493a70f21a8993e08)

Fix process-attributes rss and pmem on GNU/Linux

Problem reported by Rahguzar <https://bugs.gnu.org/72278>.
* src/sysdep.c (system_process_attributes):
[GNU_LINUX || CYGWIN || __ANDROID__]: When computing rss and pmem,
don’t assume pagesize is 4096; it could be greater.

(cherry picked from commit 42cdfe7f60ef7ae3bccb5b1e43349c3a6b54ac4a)

Describe that DocView text contents display is in a separate buffer

* doc/emacs/misc.texi (Document View): Adjust the docs to describe the
new behavior (separate buffer for the text contents) from bug#72241.

(cherry picked from commit 6eb3827f7bf757ef63c3e8e4a9971e18cf36423f)

bug#72241: 31.0.50; [PATCH] Use a dedicated buffer for `doc-view-open-text'

Here is an updated version of this patch.  WDYT?

From 6e32534012cafeda1d7e67aab23a8206bc887c9f Mon Sep 17 00:00:00 2001
From: Manuel Giraud <manuel@ledu-giraud.fr>
Date: Sun, 21 Jul 2024 18:52:52 +0200
Subject: [PATCH] Use a dedicated buffer for `doc-view-open-text'

* lisp/doc-view.el (doc-view-open-text): Create a new "text
contents" buffer and switch to it.
(doc-view-toggle-display): Switch back to the document buffer
and kill the "text contents" one.
* etc/NEWS: Mention the change.

(cherry picked from commit 210b98bc9937a86920716ebdf0b0e00a0c79c8fe)

; * etc/NEWS: Fix header level.

(cherry picked from commit 2f5af5cab3869af426631735f12acf30798136bf)

Delete defgroup "wp" obsolete since Emacs 26

* lisp/cus-edit.el (wp): Delete defgroup obsolete since Emacs 26.
(text): Don't inherit obsolete customization group 'wp'.
* lisp/finder.el (finder-known-keywords): Delete 'wp' keyword.

(cherry picked from commit 0ae70433eabe9cf672a7f0f0803f72ad136b1344)

(error): Remove support for old calling convention

* lisp/subr.el (error): Remove support for the Emacs 22 calling
convention '(error &rest args)'.

(cherry picked from commit a6a4ad13e48c656a530bea37d251a2dc55cc47d8)

Add some basic checking for function type declarations

* lisp/emacs-lisp/byte-run.el (byte-run--anonymize-arg-list): New function.
(byte-run--set-function-type): Add some basic checking for
the function type being declared.

(cherry picked from commit baf9f1210a3e44aa19d9ac90e5a4faca214127a7)

kubed.el: Mention 'kubed-transient'

Integrate 'kubed-kubectl-command' with transient menus

Rename 'kubed-kubectl-executable' to '-program'

Move command line completion code from kubed.el to new file cobra.el

(kubed-command-line-completion-table): Elucidate, optimize

kubed.el: Add some commentary

Adapt Tramp tests

* test/lisp/net/tramp-archive-tests.el (ert-resource-directory-format)
(ert-resource-directory-trim-left-regexp)
(ert-resource-directory-trim-right-regexp, ert-resource-directory)
(ert-resource-file): Don't define.
(tramp-archive--test-emacs28-p): Remove.
(top): Remove unneeded skips.  Use original objects instead of
their `tramp-compat-' counterparts when possible.

* test/lisp/net/tramp-tests.el (seq): Don't require.
(lock-file-name-transforms, process-file-return-signal-string)
(remote-file-name-inhibit-locks, dired-copy-dereference): Don't declare.
(ert-resource-directory-format)
(ert-resource-directory-trim-left-regexp)
(ert-resource-directory-trim-right-regexp, ert-resource-directory)
(ert-resource-file): Don't define.
(tramp--test-emacs28-p): Remove.
(top): Remove unneeded skips.  Use original objects instead of
their `tramp-compat-' counterparts when possible.

(cherry picked from commit d458664e893cd74f46bf9d00559ff5386c3dbf44)

Remove Emacs 27 compatibility from Tramp

* doc/misc/tramp.texi (Frequently Asked Questions):
Adapt supported Emacs versions.

* doc/misc/trampver.texi:
* lisp/net/trampver.el: Change version to "2.8.0-pre".

* lisp/net/tramp-compat.el (tramp-compat-file-modes)
(tramp-compat-set-file-modes, tramp-compat-set-file-times)
(tramp-compat-directory-files)
(tramp-compat-directory-files-and-attributes)
(tramp-compat-directory-empty-p, tramp-compat-null-device)
(tramp-compat-string-replace, tramp-compat-string-search)
(tramp-compat-make-lock-file-name)
(tramp-compat-file-name-concat)
(tramp-compat-replace-regexp-in-region, tramp-compat-length<)
(tramp-compat-length>, tramp-compat-length=)
(tramp-compat-always): Remove.

* lisp/net/tramp-adb.el:
* lisp/net/tramp-androidsu.el:
* lisp/net/tramp-archive.el:
* lisp/net/tramp-cache.el:
* lisp/net/tramp-cmds.el:
* lisp/net/tramp-compat.el:
* lisp/net/tramp-crypt.el:
* lisp/net/tramp-fuse.el:
* lisp/net/tramp-gvfs.el:
* lisp/net/tramp-message.el:
* lisp/net/tramp-sh.el:
* lisp/net/tramp-smb.el:
* lisp/net/tramp-sshfs.el:
* lisp/net/tramp-sudoedit.el:
* lisp/net/tramp.el: Use original objects instead of their
`tramp-compat-' counterparts when possible.

(cherry picked from commit c4e8112f983a2add3253e5607f0c29f70e5b4081)

Fix some function type declaration

* lisp/window.el (get-lru-window, get-largest-window): Fix
function type declaration.
* lisp/subr.el (error): Likewise.

(cherry picked from commit 976416bebe278a7cf65ab58b1918c9c27e3a09bd)

* src/image.c (gui_put_x_image): Avoid memory leak.

(cherry picked from commit 23549d7175108ca632375f9cc4390ff3e53e4d1e)

; * doc/misc/use-package.texi (Getting Started): Fix wording.

(cherry picked from commit cb633820c151c9cf428a88f43b0a62f185c4f587)

Adapt last change to non-NS systems

* src/image.c (xpm_load_image): Also check whether mask_img is
NULL.

(cherry picked from commit 3a76354e092f291037367b65b24c1963fd0fe31f)

Fix NULL pointer dereferences in xpm_load_image

* src/image.c (x_destroy_x_image): Correct test condition.
(xpm_load_image): Do not release image data if it is still to be
created.

(cherry picked from commit b5543c54bf08c4fa4cae6b7f404a37a2aee60cdf)

Fix bug#72255

* src/image.c (struct image_type): Minor grammatical
corrections.
(image_destroy_x_image): [HAVE_NS]: Do not release
Emacs_Pix_Containers, which are identical to Emacs_Pixmaps and
consequently always released with the `struct image'.
(bug#72255)

(cherry picked from commit 1ee8579eb7d7aae9405f33099559ac8205a59be2)

Delete redundant "a.k.a." in use-package.texi

* doc/misc/use-package.texi (Getting Started): Delete redundant
acronym "a.k.a.".  (Bug#66350)

(cherry picked from commit 05629d3af0acc74b197f00504eae544081b32020)

* lisp/isearch.el: Exit Isearch after deleting the frame (bug#41338).

(isearch-mode): Add 'isearch-done' to 'delete-frame-functions'.
(isearch-done): Remove 'isearch-done' from 'delete-frame-functions'.

(cherry picked from commit 19a18e487b8e2f0c1627b9cc98e601327e884eb2)

* lisp/isearch.el: Preserve original value of overriding-terminal-local-map.

(isearch--saved-local-map): New variable (bug#72229).
(isearch-mode): Set isearch--saved-local-map to
overriding-terminal-local-map.
(isearch-done): Set overriding-terminal-local-map back to
isearch--saved-local-map.
(isearch-mouse-2): Let-bind overriding-terminal-local-map to
isearch--saved-local-map.
(isearch-done): Move comment intended to be docstring to docstring.

(cherry picked from commit 6760cedc5e0e8dc2a49d3d13e54f5f153df5a3d0)

Document (use-package 'emacs) declarations

* doc/misc/use-package.texi (The @code{emacs} package): New
node.  (Bug#66350)

(cherry picked from commit c7609464f701775088184bbfc61907cd9276437c)

; Skip commit de9f9add1383c6154805ad4b3738af4c896522e4

; * src/xdisp.c (Fformat_mode_line): Doc fix.

(cherry picked from commit 7588e1f8a9fc95a199a2a32242b5224021a44458)

Fix disappearing bar cursor on Hebrew text (bug#72230)

* src/nsterm.m (ns_draw_window_cursor): Compute the correct bar cursor
rectangle for R2L before setting the clipping.

(cherry picked from commit 2074e94c3b1800b795c11658f35fc30e74ecfb60)

Fix DocView with DVI files

* lisp/doc-view.el (doc-view-pdf/ps->png): Use
`doc-view-pdf->png-converter-function' for DVI files, too, since they
are converted to PDF earlier.

(cherry picked from commit 1aaadc8aec5272d453b996ca4b4761f3da6a17db)

; Fix typo in use-package.texi

* doc/misc/use-package.texi (Getting Started): Fix typo.
Problem reported by GitHub user Paul Jensen (psnj) in:
https://github.com/jwiegley/use-package/pull/1070/

(cherry picked from commit c1382257aa8b46286ddfc85817957543a90958b7)

FIx spurious fontification of variable in Java Mode

This fixes bug#72126.

* lisp/progmodes/cc-engine.el (c-forward-<>-arglist): Remove
tentative type identifier from c-record-type-identifiers should
it turn out not to be a type.

(cherry picked from commit caf7426f0ca280b7cf40736e595cad8f7361152f)

Correctly typeset nil and t in texinfo

* doc/emacs/package.texi (Fetching Package Sources):
* doc/lispref/display.texi (Image Descriptors):
* doc/lispref/windows.texi (Buffer Display Action Alists):
* doc/misc/gnus-faq.texi (FAQ 5-4): Correctly typeset nil and t.

(cherry picked from commit 9b426e15abd320f9c53692bb6f5834967e6e1a37)

Fix Tramp IPv6 handling in tests

* lisp/net/tramp-gvfs.el (tramp-gvfs-maybe-open-connection):
* lisp/net/tramp-sh.el (tramp-maybe-open-connection): Improve message.

* lisp/net/tramp-integration.el (shortdoc): Add further examples of
`file-remote-p'.

* lisp/net/tramp.el (tramp-handle-file-remote-p): Extend docstring.

* test/lisp/net/tramp-tests.el (tramp-test02-file-name-dissect)
(tramp-test02-file-name-dissect-simplified)
(tramp-test02-file-name-dissect-separate): Extend tests.
(tramp-test06-directory-file-name)
(tramp-test26-file-name-completion)
(tramp-test26-interactive-file-name-completion): Better handling
of IPv6 hosts.

(cherry picked from commit f050b9c5033ef92ac299d3da30774bc228fd0e08)

Update to Org 9.7.8-5-gfdf0e0

(cherry picked from commit 46b192c04b162519a5e88bbf0f465a7c5e1171a9)

Fix Ftreesit_parser_create

* src/treesit.c (Ftreesit_parser_create): Use the buffer given by the
caller rather than the current buffer.

(cherry picked from commit 87f41b937bc06a14b3aeb12d5bf1a8b3e2ff74a1)

Improve treesit-node-child-by-field-name docstring

* src/treesit.c (Ftreesit_node_child_by_field_name): Improve docstring.

(cherry picked from commit c66bda1a19afd7d8391765e2ed207e44107d8a50)

Minor copyedits in tree-sitter starting guide

* admin/notes/tree-sitter/starter-guide: Minor copyedits.
Reflow some paragraphs.

(cherry picked from commit 85773ab9771d4a382c6313803d0ffb91d379e86d)

Update tag for prebuilt tree-sitter grammars

* admin/notes/tree-sitter/starter-guide: Update tag for prebuilt
tree-sitter grammars to point to 2.4.

(cherry picked from commit 2dacec1609a2858ad932fb766d2fb77e3bdeb23f)

Fix punctuation and doc style in treesit.c

* src/treesit.c (Ftreesit_parser_included_ranges)
(Ftreesit_query_capture, treesit_traverse_sibling_helper)
(treesit_traverse_match_predicate): Fix punctiation and documentation
style in comments and docstrings.

(cherry picked from commit 68615a386699f8e6108cb294a2cbc5664948af39)

; Fix punctuation in docs

(cherry picked from commit 00adee897ac95912cb9ad6bd8a8d161db71945ac)

Fix DocView with PostScript files

* lisp/doc-view.el (doc-view-set-up-single-converter): Produce PNG
from PS in a file with ".png" extension.  (Bug#72193)

(cherry picked from commit ab29b28d4ba58642f467fc15085ad8f7485fd90d)

(kubed-command-line-completion-table): Also complete file names

New command 'kubed-kubectl-command'

New command 'kubed-transient-create'

kubed.el: Add global prefix keymap

kubed.el: Add per-resource prefix keymap

kubed-transient.el: New file

Specialize 'kubed-create-deployment'

kubed.el: New command 'kubed-namespaces-set'

(kubed-current-namespace): Fix handling of multiple contexts

(kubed-pods-shell): Bind to lowercase "s", use per-pod buffer

kubed.el: Fix quoting in update command

crm.el: Workaround issue with nil completion table

crm.el: Fix addition of input to empty history list

kubed.el: Fix "D" command in resource list buffers

Better reproduce mouse event coalescence during touch event translation

* lisp/touch-screen.el (touch-screen-handle-touch): Save the
confines of the current mouse glyph before initiating simple
translation.

(cherry picked from commit f521235656040dbae8406682976233f771c0c81c)

Don't highlight matches in dired query-replace commands

* lisp/dired-aux.el (dired-do-query-replace-regexp)
(dired-do-replace-regexp-as-diff)
(dired-do-find-regexp-and-replace): Turn off lazy highlighting
when reading the regexp from the user to avoid highlighting
regexp matches in the dired buffer. (bug#72147)

(cherry picked from commit cc6324d9dca662ea0ca9439411f4852b85e18986)

* src/comp.c (obj_to_reloc): Use eassume.

(cherry picked from commit 1519c758a5a62b10f355097b066f4b88d3762bc4)

; * lisp/net/kubed.el (kubed-create): DRY

Slightly simplify 'kubed-define-resource'

; Update ldefs-boot.el

Use SBYTES instead of strlen in treesit.c

* src/treesit.c (treesit_ensure_query_compiled)
(Ftreesit_node_child_by_field_name, treesit_initialize_query):
Use SBYTES instead of strlen.

(cherry picked from commit d995429e7bc2bc5b5d87db45dbbaca121f8118e5)

Prohibit unbinding of built-in variables

* src/data.c (set_internal): Signal error if a BLV with a
redirect or a forwarded symbol is being unbound.

* test/src/data-tests.el (binding-test-makunbound-built-in): New
test.

(cherry picked from commit da0165a01e01dcb4334feee03b462ac09ceb0f8c)

Fix segfault when deleting tree-sitter query (bug#72238)

* src/treesit.c (treesit_delete_query): Only delete query and cursor
when they are non-NULL.

(cherry picked from commit 4868a17396b6796b77285a3608b383aac32aee4f)

Add link to commit compatibility function handles

* lisp/progmodes/typescript-ts-mode.el
(tsx-ts-mode--indent-compatibility-b893426): Add link to GitHub.

(cherry picked from commit ccb856189f483abfaa584f428b09a863f816a040)

Improve one test (bug#71998)

* test/lisp/progmodes/typescript-ts-mode-resources/indent.erts (Name):
Add pre-indent state.

(cherry picked from commit bb0f0c04a3985649f8ef86d9c3cbe68b78bee1aa)

; Minor whitespace fix

*
lisp/progmodes/typescript-ts-mode.el (typescript-ts-mode--font-lock-settings):
Tabs to spaces.

(cherry picked from commit 810be9cf863ecf74d6ca649ce38450a44ae55719)

Signal error on wrong typescript dialect

*
lisp/progmodes/typescript-ts-mode.el (typescript-ts-mode-wrong-dialect-error):
New error.

*
lisp/progmodes/typescript-ts-mode.el (typescript-ts-mode--check-dialect):
Helper function.

*
lisp/progmodes/typescript-ts-mode.el (typescript-ts-mode--indent-rules,
tsx-ts-mode--font-lock-compatibility-bb1f97b,
tsx-ts-mode--font-lock-compatibility-function-expression,
tsx-ts-mode--font-lock-compatibility-function-expression,
typescript-ts-mode--font-lock-settings): Use the new helper.

(cherry picked from commit 7a059ed88a13d660cc5eb20f5fa6a2903ed23247)

; Fix typo

* lisp/treesit.el (treesit-ready-p): Minor typo fix.

(cherry picked from commit cdca1ba2e9dbbe2bb469c91179cdda4fd4585bb0)

* lisp/progmodes/go-ts-mode.el (go-ts-mode-build-tags): Fix :version.

(cherry picked from commit 5c08fd80d27c61512d1f3f5cf9c38e2d5c3a5c18)

Add commands to run unit tests in 'go-ts-mode'

* lisp/progmodes/go-ts-mode.el (go-ts-mode-build-tags): New variable.
(go-ts-mode-map): Add new bindings.
(go-ts-mode--get-build-tags-flag, go-ts-mode--compile-test)
(go-ts-mode--find-defun-at, go-ts-mode--get-function-regexp)
(go-ts-mode--get-functions-in-range)
(go-ts-mode--get-test-regexp-at-point)
(go-ts-mode-test-function-at-point, go-ts-mode-test-this-file)
(go-ts-mode-test-this-package): New functions.

* etc/NEWS: Mention the change.

(Bug#70939)

(cherry picked from commit f249c81f868e8fea9d2a05ce258b3ebefba6620f)

; Fix recent changes in pdumper.c

* src/pdumper.c (dump_treesit_compiled_query, dump_vectorlike):
Minor copyedits.

(cherry picked from commit e63fa29b98f3be18b7c66c9ca289e787b172ec37)

Fix bool vector length overflow

* src/alloc.c (make_clear_bool_vector): It’s now the caller’s
responsibility to make sure the bool vector length is in range.
Add an eassert to double-check this.  This lets some locals be
ptrdiff_t not EMACS_INT.
(Fmake_bool_vector, Fbool_vector):
Check that bool vector lengths are in range.
* src/lisp.h (BOOL_VECTOR_LENGTH_MAX): New macro.
(bool_vector_words, bool_vector_bytes): Avoid undefined
behavior if size == EMACS_INT_MAX - (BITS_PER_BITS_WORD - 1).
This is mostly theoretical but it’s easy to do it right.
* src/lread.c (read_bool_vector): Use EMACS_INT, not just ptrdiff_t.
Check that length doesn’t exceed BOOL_VECTOR_LENGTH_MAX.
This fixes an unlikely integer overflow where the calculated size
went negative.

(cherry picked from commit 515e5ad0de133f0a3d501bd6290ccc51d8462955)

Change list-length intptr_t to ptrdiff_t

* src/fns.c (list_length, Fsafe_length, Fproper_list_p):
Use ptrdiff_t not intptr_t for accumulator, since result is ptrdiff_t.
This fixes a minor glitch in 2019-01-11T05:35:31!eggert@cs.ucla.edu
where I removed unnecessary overflow checks but forgot to change types.
This change should alter generated code only on oddball platforms where
ptrdiff_t is narrower than intptr_t, e.g., CheriBSD.

(cherry picked from commit 76497a01425e19a6c3a02c1e3031061fa0e7885b)

; * lisp/eshell/esh-io.el (eshell-close-handles): Fix version annotation.

(cherry picked from commit 55fefe06ef00cbe3e27a111a229a2622ae487c74)

Support dumping tree-sitter query (bug#69952)

Previous commit allows Emacs to dump tree-sitter queries by simply
dumping the query string and language symbol, and left the query object
and cursor object as NULL.  This commit makes sure Emacs doesn't crash
when loading the dumped query, by make sure Emacs can handle the case
where the cursor is NULL.

* src/treesit.c (make_treesit_query): Initialize query with null cursor.
(treesit_ensure_query_cursor): New function.
(treesit_initialize_query): Ensure cursor is non-null.
* src/treesit.h (Lisp_TS_Query): Update documentation.

(cherry picked from commit 1abf3bdd7edcd405d4ccb4ef4de38068348f4b95)

Support compiled queries in pdump by dumping source (bug#69952)

* src/pdumper.c (dump_vectorlike): Dump compiled queries.
* src/pdumper.c (dump_treesit_compiled_query): New function.

(cherry picked from commit 1eca867e1b60acef7f4343bc5c70340de58f1079)

SAFE_ALLOCA fixes

* src/comp.c (declare_imported_func, emit_simple_limple_call)
(declare_lex_function, compile_function):
* src/emacs-module.c (funcall_module):
* src/fns.c (Fstring_distance):
* src/font.c (font_sort_entities):
* src/haikumenu.c (digest_menu_items, haiku_menu_show):
* src/pgtkselect.c (Fpgtk_register_dnd_targets):
* src/xfns.c (Fx_begin_drag):
* src/xmenu.c (x_menu_show):
* src/xterm.c (x_dnd_compute_toplevels, handle_one_xevent)
(x_term_init):
Prefer SAFE_NALLOCA to doing size multiplication by hand, to catch
unlikely integer overflows.
* src/comp.c (emit_simple_limple_call): Fix bug where
SAFE_FREE was called too early, leading to unlikely
use of freed storage.
* src/xterm.c (handle_one_xevent): Remove side effects
from SAFE_ALLOCA args, as the args are evaluated twice.

(cherry picked from commit 101ec1430128a0b1d9e7d54cbd9c0add8f446f25)