aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorStefan Kangas2024-07-25 03:35:04 +0200
committerStefan Kangas2024-07-25 03:35:18 +0200
commita79966156633ae1e49e3fef17ff7212c8f35a26f (patch)
tree3395389467c1effba572a2db7efb9d39def72425 /doc
parent67faaead754c0a11bd89fdcde2533bc51b71ef0e (diff)
downloademacs-a79966156633ae1e49e3fef17ff7212c8f35a26f.tar.gz
emacs-a79966156633ae1e49e3fef17ff7212c8f35a26f.zip
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
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/frames.texi8
-rw-r--r--doc/lispref/functions.texi2
-rw-r--r--doc/lispref/nonascii.texi2
-rw-r--r--doc/lispref/package.texi2
-rw-r--r--doc/lispref/parsing.texi2
-rw-r--r--doc/lispref/searching.texi2
-rw-r--r--doc/misc/efaq-w32.texi4
-rw-r--r--doc/misc/erc.texi2
-rw-r--r--doc/misc/gnus.texi2
-rw-r--r--doc/misc/modus-themes.org4
-rw-r--r--doc/misc/org.org4
-rw-r--r--doc/misc/transient.texi2
-rw-r--r--doc/misc/use-package.texi4
-rw-r--r--doc/misc/wisent.texi2
14 files changed, 21 insertions, 21 deletions
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index c56b37ce9b7..8744687a531 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -589,7 +589,7 @@ The @dfn{external border} is part of the decorations supplied by the
589window manager. It is typically used for resizing the frame with the 589window manager. It is typically used for resizing the frame with the
590mouse and is therefore not shown on ``fullboth'' and maximized frames 590mouse and is therefore not shown on ``fullboth'' and maximized frames
591(@pxref{Size Parameters}). Its width is determined by the window 591(@pxref{Size Parameters}). Its width is determined by the window
592manager and cannot be changed by Emacs' functions. 592manager and cannot be changed by Emacs's functions.
593 593
594External borders don't exist on text terminal frames. For graphical 594External borders don't exist on text terminal frames. For graphical
595frames, their display can be suppressed by setting the 595frames, their display can be suppressed by setting the
@@ -2283,7 +2283,7 @@ it on an undecorated frame.
2283If non-@code{nil}, this means that this is an @dfn{override redirect} 2283If non-@code{nil}, this means that this is an @dfn{override redirect}
2284frame---a frame not handled by window managers under X@. Override 2284frame---a frame not handled by window managers under X@. Override
2285redirect frames have no window manager decorations, can be positioned 2285redirect frames have no window manager decorations, can be positioned
2286and resized only via Emacs' positioning and resizing functions and are 2286and resized only via Emacs's positioning and resizing functions and are
2287usually drawn on top of all other frames. Setting this parameter has 2287usually drawn on top of all other frames. Setting this parameter has
2288no effect on MS-Windows. 2288no effect on MS-Windows.
2289 2289
@@ -2780,7 +2780,7 @@ visible, even though only the selected one is actually displayed.
2780@end defun 2780@end defun
2781 2781
2782@defun frame-list-z-order &optional display 2782@defun frame-list-z-order &optional display
2783This function returns a list of Emacs' frames, in Z (stacking) order 2783This function returns a list of Emacs's frames, in Z (stacking) order
2784(@pxref{Raising and Lowering}). The optional argument @var{display} 2784(@pxref{Raising and Lowering}). The optional argument @var{display}
2785specifies which display to poll. @var{display} should be either a frame 2785specifies which display to poll. @var{display} should be either a frame
2786or a display name (a string). If omitted or @code{nil}, that stands for 2786or a display name (a string). If omitted or @code{nil}, that stands for
@@ -3157,7 +3157,7 @@ A frame on a graphical display may be @dfn{visible}, @dfn{invisible}, or
3157usual manner. If it is iconified, its contents are not displayed, but 3157usual manner. If it is iconified, its contents are not displayed, but
3158there is a little icon somewhere to bring the frame back into view (some 3158there is a little icon somewhere to bring the frame back into view (some
3159window managers refer to this state as @dfn{minimized} rather than 3159window managers refer to this state as @dfn{minimized} rather than
3160@dfn{iconified}, but from Emacs' point of view they are the same thing). 3160@dfn{iconified}, but from Emacs's point of view they are the same thing).
3161If a frame is invisible, it is not displayed at all. 3161If a frame is invisible, it is not displayed at all.
3162 3162
3163@cindex mapped frame 3163@cindex mapped frame
diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi
index 0cf41072ec3..0131305525c 100644
--- a/doc/lispref/functions.texi
+++ b/doc/lispref/functions.texi
@@ -2059,7 +2059,7 @@ is the better way to modify a named function because it keeps track of
2059the modifications, so they can be listed and undone. 2059the modifications, so they can be listed and undone.
2060 2060
2061 Modifying a named function should be reserved for 2061 Modifying a named function should be reserved for
2062the cases where you cannot modify Emacs' behavior in any other way. 2062the cases where you cannot modify Emacs's behavior in any other way.
2063If it is possible to do the same thing via a hook, that is preferable 2063If it is possible to do the same thing via a hook, that is preferable
2064(@pxref{Hooks}). If you simply want to change what a particular key 2064(@pxref{Hooks}). If you simply want to change what a particular key
2065does, it may be better to write a new command, and remap the old 2065does, it may be better to write a new command, and remap the old
diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi
index 1c5cc0e20b4..e5d552815e0 100644
--- a/doc/lispref/nonascii.texi
+++ b/doc/lispref/nonascii.texi
@@ -732,7 +732,7 @@ character, a symbol whose name is the script to which the character
732belongs, according to the Unicode Standard classification of the 732belongs, according to the Unicode Standard classification of the
733Unicode code space into script-specific blocks. This char-table has a 733Unicode code space into script-specific blocks. This char-table has a
734single extra slot whose value is the list of all script symbols. Note 734single extra slot whose value is the list of all script symbols. Note
735that Emacs' classification of characters into scripts is not a 1-for-1 735that Emacs's classification of characters into scripts is not a 1-for-1
736reflection of the Unicode standard, e.g. there is no @samp{symbol} 736reflection of the Unicode standard, e.g. there is no @samp{symbol}
737script in Unicode. 737script in Unicode.
738@end defvar 738@end defvar
diff --git a/doc/lispref/package.texi b/doc/lispref/package.texi
index eb0b4ca213c..6f7b7af12dd 100644
--- a/doc/lispref/package.texi
+++ b/doc/lispref/package.texi
@@ -133,7 +133,7 @@ file (@pxref{Init File,,, emacs, The GNU Emacs Manual}).
133@end defun 133@end defun
134 134
135@deffn Command package-initialize &optional no-activate 135@deffn Command package-initialize &optional no-activate
136This function initializes Emacs' internal record of which packages are 136This function initializes Emacs's internal record of which packages are
137installed, and then calls @code{package-activate-all}. 137installed, and then calls @code{package-activate-all}.
138 138
139The optional argument @var{no-activate}, if non-@code{nil}, causes 139The optional argument @var{no-activate}, if non-@code{nil}, causes
diff --git a/doc/lispref/parsing.texi b/doc/lispref/parsing.texi
index 21e14b4632c..8f3c2b4a366 100644
--- a/doc/lispref/parsing.texi
+++ b/doc/lispref/parsing.texi
@@ -2159,7 +2159,7 @@ node is a defun node but doesn't have a name, or the node is
2159@node Tree-sitter C API 2159@node Tree-sitter C API
2160@section Tree-sitter C API Correspondence 2160@section Tree-sitter C API Correspondence
2161 2161
2162Emacs' tree-sitter integration doesn't expose every feature 2162Emacs's tree-sitter integration doesn't expose every feature
2163provided by tree-sitter's C API@. Missing features include: 2163provided by tree-sitter's C API@. Missing features include:
2164 2164
2165@itemize 2165@itemize
diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi
index 7cefd581afb..7b4a9100e77 100644
--- a/doc/lispref/searching.texi
+++ b/doc/lispref/searching.texi
@@ -1977,7 +1977,7 @@ To help diagnose problems in your regexps or in the regexp engine
1977itself, this function returns a string describing the compiled 1977itself, this function returns a string describing the compiled
1978form of @var{regexp}. To make sense of it, it can be necessary 1978form of @var{regexp}. To make sense of it, it can be necessary
1979to read at least the description of the @code{re_opcode_t} type in the 1979to read at least the description of the @code{re_opcode_t} type in the
1980@code{src/regex-emacs.c} file in Emacs' source code. 1980@code{src/regex-emacs.c} file in Emacs's source code.
1981 1981
1982It is currently able to give a meaningful description only if Emacs 1982It is currently able to give a meaningful description only if Emacs
1983was compiled with @code{--enable-checking}. 1983was compiled with @code{--enable-checking}.
diff --git a/doc/misc/efaq-w32.texi b/doc/misc/efaq-w32.texi
index 411450cdc42..9ee5b679fed 100644
--- a/doc/misc/efaq-w32.texi
+++ b/doc/misc/efaq-w32.texi
@@ -2218,7 +2218,7 @@ outdated. Tools available here that are useful for Emacs include:
2218@item OpenSSL - used by @code{gnus} to talk to servers over SSL. 2218@item OpenSSL - used by @code{gnus} to talk to servers over SSL.
2219@item Patch - used by @code{ediff-patch-file} and others to apply patches. 2219@item Patch - used by @code{ediff-patch-file} and others to apply patches.
2220@item Tar - used by @code{tar-mode} to edit tar files. 2220@item Tar - used by @code{tar-mode} to edit tar files.
2221@item TexInfo - used to build Emacs' manuals. 2221@item TexInfo - used to build Emacs's manuals.
2222@item Unzip - used by @code{archive-mode} for extracting zip files. 2222@item Unzip - used by @code{archive-mode} for extracting zip files.
2223@item Xpm - library to support XPM images (bundled with Emacs binaries) 2223@item Xpm - library to support XPM images (bundled with Emacs binaries)
2224@item Zip - used by @code{archive-mode} for editing zip files. 2224@item Zip - used by @code{archive-mode} for editing zip files.
@@ -2245,7 +2245,7 @@ image libraries that it provides, even if they are not on the
2245@findex man 2245@findex man
2246 2246
2247Man pages for Emacs and other ported programs that you have can be 2247Man pages for Emacs and other ported programs that you have can be
2248read using Emacs' built-in manual reader @code{woman}. This 2248read using Emacs's built-in manual reader @code{woman}. This
2249requires no external programs, but if you do have a port of 2249requires no external programs, but if you do have a port of
2250@command{man}, there is also an Emacs wrapper @code{man} that 2250@command{man}, there is also an Emacs wrapper @code{man} that
2251which may be slightly faster. A Windows version of @command{man} is 2251which may be slightly faster. A Windows version of @command{man} is
diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi
index 858e1ba34dc..33f35d9b5c6 100644
--- a/doc/misc/erc.texi
+++ b/doc/misc/erc.texi
@@ -2127,7 +2127,7 @@ to IRC, and don't forget that you can roll back to the previous
2127version by running @kbd{M-x package-delete @key{RET}}. 2127version by running @kbd{M-x package-delete @key{RET}}.
2128@xref{Packages,,,emacs, The Emacs Editor}, for more information. 2128@xref{Packages,,,emacs, The Emacs Editor}, for more information.
2129 2129
2130Note that a bug affecting Emacs' packaging machinery may prevent the 2130Note that a bug affecting Emacs's packaging machinery may prevent the
2131above method from working on Emacs versions 29 and below. Users on 29 2131above method from working on Emacs versions 29 and below. Users on 29
2132can try running @kbd{C-u M-x package-install @key{RET}} instead. 2132can try running @kbd{C-u M-x package-install @key{RET}} instead.
2133Users on 28 and below can click on the @emph{installed} @samp{erc} 2133Users on 28 and below can click on the @emph{installed} @samp{erc}
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index f4c87bd64dd..dbe4da29d54 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -12075,7 +12075,7 @@ article buffer. There are many methods for doing that, but two of
12075them are kind of default methods. 12075them are kind of default methods.
12076 12076
12077If your Emacs copy has been built with libxml2 support, then Gnus uses 12077If your Emacs copy has been built with libxml2 support, then Gnus uses
12078Emacs' built-in, plain elisp Simple HTML Renderer @code{shr} 12078Emacs's built-in, plain elisp Simple HTML Renderer @code{shr}
12079@footnote{@code{shr} displays colors as declared in the @acronym{HTML} 12079@footnote{@code{shr} displays colors as declared in the @acronym{HTML}
12080article but tries to adjust them in order to be readable. If you 12080article but tries to adjust them in order to be readable. If you
12081prefer more contrast, @xref{FAQ 4-16}.} which is also used by Emacs' 12081prefer more contrast, @xref{FAQ 4-16}.} which is also used by Emacs'
diff --git a/doc/misc/modus-themes.org b/doc/misc/modus-themes.org
index 20fa93c6dbc..70ba8cdc02f 100644
--- a/doc/misc/modus-themes.org
+++ b/doc/misc/modus-themes.org
@@ -144,7 +144,7 @@ and covers everything that goes into every tagged release of the themes.
144:end: 144:end:
145 145
146The Modus themes are distributed with Emacs starting with version 28.1. 146The Modus themes are distributed with Emacs starting with version 28.1.
147On older versions of Emacs, they can be installed using Emacs' package 147On older versions of Emacs, they can be installed using Emacs's package
148manager or manually from their code repository. There also exist 148manager or manually from their code repository. There also exist
149packages for distributions of GNU/Linux. 149packages for distributions of GNU/Linux.
150 150
@@ -4769,7 +4769,7 @@ and/or mode line setup.
4769:custom_id: h:4cc767dc-ffef-4c5c-9f10-82eb7b8921bf 4769:custom_id: h:4cc767dc-ffef-4c5c-9f10-82eb7b8921bf
4770:end: 4770:end:
4771 4771
4772Emacs' HTML rendering library ({{{file(shr.el)}}}) may need explicit 4772Emacs's HTML rendering library ({{{file(shr.el)}}}) may need explicit
4773configuration to respect the theme's colors instead of whatever 4773configuration to respect the theme's colors instead of whatever
4774specifications the webpage provides. 4774specifications the webpage provides.
4775 4775
diff --git a/doc/misc/org.org b/doc/misc/org.org
index dc7d8ef166f..dcc1ddc7f44 100644
--- a/doc/misc/org.org
+++ b/doc/misc/org.org
@@ -3359,7 +3359,7 @@ Here is the full set of built-in link types:
3359 3359
3360- =gnus=, =rmail=, =mhe= :: 3360- =gnus=, =rmail=, =mhe= ::
3361 3361
3362 Link to messages or folders from a given Emacs' MUA. 3362 Link to messages or folders from a given Emacs MUA.
3363 3363
3364- =help= :: 3364- =help= ::
3365 3365
@@ -23201,7 +23201,7 @@ than 30 stars. This is a hard-coded limitation of ~lmax~ in
232012003, not the beginning of time. 232012003, not the beginning of time.
23202 23202
23203[fn:29] On computers using macOS, idleness is based on actual user 23203[fn:29] On computers using macOS, idleness is based on actual user
23204idleness, not just Emacs' idle time. For X11, you can install a 23204idleness, not just Emacs's idle time. For X11, you can install a
23205utility program =x11idle.c=, available in the =org-contrib/= 23205utility program =x11idle.c=, available in the =org-contrib/=
23206repository, or install the xprintidle package and set it to the 23206repository, or install the xprintidle package and set it to the
23207variable ~org-clock-x11idle-program-name~ if you are running Debian, 23207variable ~org-clock-x11idle-program-name~ if you are running Debian,
diff --git a/doc/misc/transient.texi b/doc/misc/transient.texi
index 7419ce39206..10e4c9deef1 100644
--- a/doc/misc/transient.texi
+++ b/doc/misc/transient.texi
@@ -1458,7 +1458,7 @@ When returning to the command-loop after calling the suffix command,
1458the arguments are reset to @code{nil} (which causes the function to return 1458the arguments are reset to @code{nil} (which causes the function to return
1459@code{nil} too). 1459@code{nil} too).
1460 1460
1461Like for Emacs' prefix arguments, it is advisable, but not mandatory, 1461Like for Emacs's prefix arguments, it is advisable, but not mandatory,
1462to access the infix arguments inside the command's @code{interactive} form. 1462to access the infix arguments inside the command's @code{interactive} form.
1463The preferred way of doing that is to call the @code{transient-args} 1463The preferred way of doing that is to call the @code{transient-args}
1464function, which for infix arguments serves about the same purpose as 1464function, which for infix arguments serves about the same purpose as
diff --git a/doc/misc/use-package.texi b/doc/misc/use-package.texi
index 9e11b349f20..da3deb081d9 100644
--- a/doc/misc/use-package.texi
+++ b/doc/misc/use-package.texi
@@ -575,7 +575,7 @@ add @code{:demand t} to those declarations.
575Some users want to put all their customizations in use-package 575Some users want to put all their customizations in use-package
576declarations, even for variables, hooks, and options that are always 576declarations, even for variables, hooks, and options that are always
577available, without loading any package.@footnote{In other words, they 577available, without loading any package.@footnote{In other words, they
578are either preloaded in Emacs or defined in Emacs' C sources.} 578are either preloaded in Emacs or defined in Emacs's C sources.}
579 579
580For that purpose, you can use the no-op @samp{emacs} package: 580For that purpose, you can use the no-op @samp{emacs} package:
581 581
@@ -640,7 +640,7 @@ simply use @code{:if} and the appropriate Lisp expression.
640@node Manual installation 640@node Manual installation
641@section Manually installed package 641@section Manually installed package
642 642
643When installing packages manually, without Emacs' built-in package 643When installing packages manually, without Emacs's built-in package
644manager (@file{package.el}), it will obviously not help you set up 644manager (@file{package.el}), it will obviously not help you set up
645autoloads or add it to your @code{load-path}. You must do it 645autoloads or add it to your @code{load-path}. You must do it
646yourself. However, use-package makes this more convenient. 646yourself. However, use-package makes this more convenient.
diff --git a/doc/misc/wisent.texi b/doc/misc/wisent.texi
index d42fe09240a..ad59ce03a4a 100644
--- a/doc/misc/wisent.texi
+++ b/doc/misc/wisent.texi
@@ -1800,7 +1800,7 @@ But @samp{rules} part is parsed in Bison style! Why?
1800Rule delimiters are the colon (@code{:}), that follows the nonterminal 1800Rule delimiters are the colon (@code{:}), that follows the nonterminal
1801name, and a final semicolon (@code{;}). Unfortunately these 1801name, and a final semicolon (@code{;}). Unfortunately these
1802delimiters are not @code{open-paren}/@code{close-paren} type, and the 1802delimiters are not @code{open-paren}/@code{close-paren} type, and the
1803Emacs' syntactic analyzer can't easily isolate data between them to 1803Emacs syntactic analyzer can't easily isolate data between them to
1804produce a @samp{RULES_PART} parenthesis-block-like lexical token. 1804produce a @samp{RULES_PART} parenthesis-block-like lexical token.
1805Consequently it is not possible to use @code{EXPANDFULL} to iterate in 1805Consequently it is not possible to use @code{EXPANDFULL} to iterate in
1806@samp{RULES_PART}, like this: 1806@samp{RULES_PART}, like this: