diff options
| author | Stefan Kangas | 2024-07-25 03:35:04 +0200 |
|---|---|---|
| committer | Stefan Kangas | 2024-07-25 03:35:18 +0200 |
| commit | a79966156633ae1e49e3fef17ff7212c8f35a26f (patch) | |
| tree | 3395389467c1effba572a2db7efb9d39def72425 /doc | |
| parent | 67faaead754c0a11bd89fdcde2533bc51b71ef0e (diff) | |
| download | emacs-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.texi | 8 | ||||
| -rw-r--r-- | doc/lispref/functions.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/nonascii.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/package.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/parsing.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/searching.texi | 2 | ||||
| -rw-r--r-- | doc/misc/efaq-w32.texi | 4 | ||||
| -rw-r--r-- | doc/misc/erc.texi | 2 | ||||
| -rw-r--r-- | doc/misc/gnus.texi | 2 | ||||
| -rw-r--r-- | doc/misc/modus-themes.org | 4 | ||||
| -rw-r--r-- | doc/misc/org.org | 4 | ||||
| -rw-r--r-- | doc/misc/transient.texi | 2 | ||||
| -rw-r--r-- | doc/misc/use-package.texi | 4 | ||||
| -rw-r--r-- | doc/misc/wisent.texi | 2 |
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 | |||
| 589 | window manager. It is typically used for resizing the frame with the | 589 | window manager. It is typically used for resizing the frame with the |
| 590 | mouse and is therefore not shown on ``fullboth'' and maximized frames | 590 | mouse 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 |
| 592 | manager and cannot be changed by Emacs' functions. | 592 | manager and cannot be changed by Emacs's functions. |
| 593 | 593 | ||
| 594 | External borders don't exist on text terminal frames. For graphical | 594 | External borders don't exist on text terminal frames. For graphical |
| 595 | frames, their display can be suppressed by setting the | 595 | frames, their display can be suppressed by setting the |
| @@ -2283,7 +2283,7 @@ it on an undecorated frame. | |||
| 2283 | If non-@code{nil}, this means that this is an @dfn{override redirect} | 2283 | If non-@code{nil}, this means that this is an @dfn{override redirect} |
| 2284 | frame---a frame not handled by window managers under X@. Override | 2284 | frame---a frame not handled by window managers under X@. Override |
| 2285 | redirect frames have no window manager decorations, can be positioned | 2285 | redirect frames have no window manager decorations, can be positioned |
| 2286 | and resized only via Emacs' positioning and resizing functions and are | 2286 | and resized only via Emacs's positioning and resizing functions and are |
| 2287 | usually drawn on top of all other frames. Setting this parameter has | 2287 | usually drawn on top of all other frames. Setting this parameter has |
| 2288 | no effect on MS-Windows. | 2288 | no 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 |
| 2783 | This function returns a list of Emacs' frames, in Z (stacking) order | 2783 | This 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} |
| 2785 | specifies which display to poll. @var{display} should be either a frame | 2785 | specifies which display to poll. @var{display} should be either a frame |
| 2786 | or a display name (a string). If omitted or @code{nil}, that stands for | 2786 | or 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 | |||
| 3157 | usual manner. If it is iconified, its contents are not displayed, but | 3157 | usual manner. If it is iconified, its contents are not displayed, but |
| 3158 | there is a little icon somewhere to bring the frame back into view (some | 3158 | there is a little icon somewhere to bring the frame back into view (some |
| 3159 | window managers refer to this state as @dfn{minimized} rather than | 3159 | window 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). |
| 3161 | If a frame is invisible, it is not displayed at all. | 3161 | If 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 | |||
| 2059 | the modifications, so they can be listed and undone. | 2059 | the 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 |
| 2062 | the cases where you cannot modify Emacs' behavior in any other way. | 2062 | the cases where you cannot modify Emacs's behavior in any other way. |
| 2063 | If it is possible to do the same thing via a hook, that is preferable | 2063 | If 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 |
| 2065 | does, it may be better to write a new command, and remap the old | 2065 | does, 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 | |||
| 732 | belongs, according to the Unicode Standard classification of the | 732 | belongs, according to the Unicode Standard classification of the |
| 733 | Unicode code space into script-specific blocks. This char-table has a | 733 | Unicode code space into script-specific blocks. This char-table has a |
| 734 | single extra slot whose value is the list of all script symbols. Note | 734 | single extra slot whose value is the list of all script symbols. Note |
| 735 | that Emacs' classification of characters into scripts is not a 1-for-1 | 735 | that Emacs's classification of characters into scripts is not a 1-for-1 |
| 736 | reflection of the Unicode standard, e.g. there is no @samp{symbol} | 736 | reflection of the Unicode standard, e.g. there is no @samp{symbol} |
| 737 | script in Unicode. | 737 | script 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 |
| 136 | This function initializes Emacs' internal record of which packages are | 136 | This function initializes Emacs's internal record of which packages are |
| 137 | installed, and then calls @code{package-activate-all}. | 137 | installed, and then calls @code{package-activate-all}. |
| 138 | 138 | ||
| 139 | The optional argument @var{no-activate}, if non-@code{nil}, causes | 139 | The 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 | ||
| 2162 | Emacs' tree-sitter integration doesn't expose every feature | 2162 | Emacs's tree-sitter integration doesn't expose every feature |
| 2163 | provided by tree-sitter's C API@. Missing features include: | 2163 | provided 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 | |||
| 1977 | itself, this function returns a string describing the compiled | 1977 | itself, this function returns a string describing the compiled |
| 1978 | form of @var{regexp}. To make sense of it, it can be necessary | 1978 | form of @var{regexp}. To make sense of it, it can be necessary |
| 1979 | to read at least the description of the @code{re_opcode_t} type in the | 1979 | to 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 | ||
| 1982 | It is currently able to give a meaningful description only if Emacs | 1982 | It is currently able to give a meaningful description only if Emacs |
| 1983 | was compiled with @code{--enable-checking}. | 1983 | was 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 | ||
| 2247 | Man pages for Emacs and other ported programs that you have can be | 2247 | Man pages for Emacs and other ported programs that you have can be |
| 2248 | read using Emacs' built-in manual reader @code{woman}. This | 2248 | read using Emacs's built-in manual reader @code{woman}. This |
| 2249 | requires no external programs, but if you do have a port of | 2249 | requires 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 |
| 2251 | which may be slightly faster. A Windows version of @command{man} is | 2251 | which 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 | |||
| 2127 | version by running @kbd{M-x package-delete @key{RET}}. | 2127 | version 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 | ||
| 2130 | Note that a bug affecting Emacs' packaging machinery may prevent the | 2130 | Note that a bug affecting Emacs's packaging machinery may prevent the |
| 2131 | above method from working on Emacs versions 29 and below. Users on 29 | 2131 | above method from working on Emacs versions 29 and below. Users on 29 |
| 2132 | can try running @kbd{C-u M-x package-install @key{RET}} instead. | 2132 | can try running @kbd{C-u M-x package-install @key{RET}} instead. |
| 2133 | Users on 28 and below can click on the @emph{installed} @samp{erc} | 2133 | Users 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 | |||
| 12075 | them are kind of default methods. | 12075 | them are kind of default methods. |
| 12076 | 12076 | ||
| 12077 | If your Emacs copy has been built with libxml2 support, then Gnus uses | 12077 | If your Emacs copy has been built with libxml2 support, then Gnus uses |
| 12078 | Emacs' built-in, plain elisp Simple HTML Renderer @code{shr} | 12078 | Emacs'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} |
| 12080 | article but tries to adjust them in order to be readable. If you | 12080 | article but tries to adjust them in order to be readable. If you |
| 12081 | prefer more contrast, @xref{FAQ 4-16}.} which is also used by Emacs' | 12081 | prefer 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 | ||
| 146 | The Modus themes are distributed with Emacs starting with version 28.1. | 146 | The Modus themes are distributed with Emacs starting with version 28.1. |
| 147 | On older versions of Emacs, they can be installed using Emacs' package | 147 | On older versions of Emacs, they can be installed using Emacs's package |
| 148 | manager or manually from their code repository. There also exist | 148 | manager or manually from their code repository. There also exist |
| 149 | packages for distributions of GNU/Linux. | 149 | packages 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 | ||
| 4772 | Emacs' HTML rendering library ({{{file(shr.el)}}}) may need explicit | 4772 | Emacs's HTML rendering library ({{{file(shr.el)}}}) may need explicit |
| 4773 | configuration to respect the theme's colors instead of whatever | 4773 | configuration to respect the theme's colors instead of whatever |
| 4774 | specifications the webpage provides. | 4774 | specifications 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 | |||
| 23201 | 2003, not the beginning of time. | 23201 | 2003, 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 |
| 23204 | idleness, not just Emacs' idle time. For X11, you can install a | 23204 | idleness, not just Emacs's idle time. For X11, you can install a |
| 23205 | utility program =x11idle.c=, available in the =org-contrib/= | 23205 | utility program =x11idle.c=, available in the =org-contrib/= |
| 23206 | repository, or install the xprintidle package and set it to the | 23206 | repository, or install the xprintidle package and set it to the |
| 23207 | variable ~org-clock-x11idle-program-name~ if you are running Debian, | 23207 | variable ~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, | |||
| 1458 | the arguments are reset to @code{nil} (which causes the function to return | 1458 | the arguments are reset to @code{nil} (which causes the function to return |
| 1459 | @code{nil} too). | 1459 | @code{nil} too). |
| 1460 | 1460 | ||
| 1461 | Like for Emacs' prefix arguments, it is advisable, but not mandatory, | 1461 | Like for Emacs's prefix arguments, it is advisable, but not mandatory, |
| 1462 | to access the infix arguments inside the command's @code{interactive} form. | 1462 | to access the infix arguments inside the command's @code{interactive} form. |
| 1463 | The preferred way of doing that is to call the @code{transient-args} | 1463 | The preferred way of doing that is to call the @code{transient-args} |
| 1464 | function, which for infix arguments serves about the same purpose as | 1464 | function, 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. | |||
| 575 | Some users want to put all their customizations in use-package | 575 | Some users want to put all their customizations in use-package |
| 576 | declarations, even for variables, hooks, and options that are always | 576 | declarations, even for variables, hooks, and options that are always |
| 577 | available, without loading any package.@footnote{In other words, they | 577 | available, without loading any package.@footnote{In other words, they |
| 578 | are either preloaded in Emacs or defined in Emacs' C sources.} | 578 | are either preloaded in Emacs or defined in Emacs's C sources.} |
| 579 | 579 | ||
| 580 | For that purpose, you can use the no-op @samp{emacs} package: | 580 | For 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 | ||
| 643 | When installing packages manually, without Emacs' built-in package | 643 | When installing packages manually, without Emacs's built-in package |
| 644 | manager (@file{package.el}), it will obviously not help you set up | 644 | manager (@file{package.el}), it will obviously not help you set up |
| 645 | autoloads or add it to your @code{load-path}. You must do it | 645 | autoloads or add it to your @code{load-path}. You must do it |
| 646 | yourself. However, use-package makes this more convenient. | 646 | yourself. 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? | |||
| 1800 | Rule delimiters are the colon (@code{:}), that follows the nonterminal | 1800 | Rule delimiters are the colon (@code{:}), that follows the nonterminal |
| 1801 | name, and a final semicolon (@code{;}). Unfortunately these | 1801 | name, and a final semicolon (@code{;}). Unfortunately these |
| 1802 | delimiters are not @code{open-paren}/@code{close-paren} type, and the | 1802 | delimiters are not @code{open-paren}/@code{close-paren} type, and the |
| 1803 | Emacs' syntactic analyzer can't easily isolate data between them to | 1803 | Emacs syntactic analyzer can't easily isolate data between them to |
| 1804 | produce a @samp{RULES_PART} parenthesis-block-like lexical token. | 1804 | produce a @samp{RULES_PART} parenthesis-block-like lexical token. |
| 1805 | Consequently it is not possible to use @code{EXPANDFULL} to iterate in | 1805 | Consequently it is not possible to use @code{EXPANDFULL} to iterate in |
| 1806 | @samp{RULES_PART}, like this: | 1806 | @samp{RULES_PART}, like this: |