mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-11-21 06:55:39 +00:00
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
This commit is contained in:
parent
67faaead75
commit
a799661566
@ -589,7 +589,7 @@ The @dfn{external border} is part of the decorations supplied by the
|
||||
window manager. It is typically used for resizing the frame with the
|
||||
mouse and is therefore not shown on ``fullboth'' and maximized frames
|
||||
(@pxref{Size Parameters}). Its width is determined by the window
|
||||
manager and cannot be changed by Emacs' functions.
|
||||
manager and cannot be changed by Emacs's functions.
|
||||
|
||||
External borders don't exist on text terminal frames. For graphical
|
||||
frames, their display can be suppressed by setting the
|
||||
@ -2283,7 +2283,7 @@ it on an undecorated frame.
|
||||
If non-@code{nil}, this means that this is an @dfn{override redirect}
|
||||
frame---a frame not handled by window managers under X@. Override
|
||||
redirect frames have no window manager decorations, can be positioned
|
||||
and resized only via Emacs' positioning and resizing functions and are
|
||||
and resized only via Emacs's positioning and resizing functions and are
|
||||
usually drawn on top of all other frames. Setting this parameter has
|
||||
no effect on MS-Windows.
|
||||
|
||||
@ -2780,7 +2780,7 @@ visible, even though only the selected one is actually displayed.
|
||||
@end defun
|
||||
|
||||
@defun frame-list-z-order &optional display
|
||||
This function returns a list of Emacs' frames, in Z (stacking) order
|
||||
This function returns a list of Emacs's frames, in Z (stacking) order
|
||||
(@pxref{Raising and Lowering}). The optional argument @var{display}
|
||||
specifies which display to poll. @var{display} should be either a frame
|
||||
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
|
||||
usual manner. If it is iconified, its contents are not displayed, but
|
||||
there is a little icon somewhere to bring the frame back into view (some
|
||||
window managers refer to this state as @dfn{minimized} rather than
|
||||
@dfn{iconified}, but from Emacs' point of view they are the same thing).
|
||||
@dfn{iconified}, but from Emacs's point of view they are the same thing).
|
||||
If a frame is invisible, it is not displayed at all.
|
||||
|
||||
@cindex mapped frame
|
||||
|
@ -2059,7 +2059,7 @@ is the better way to modify a named function because it keeps track of
|
||||
the modifications, so they can be listed and undone.
|
||||
|
||||
Modifying a named function should be reserved for
|
||||
the cases where you cannot modify Emacs' behavior in any other way.
|
||||
the cases where you cannot modify Emacs's behavior in any other way.
|
||||
If it is possible to do the same thing via a hook, that is preferable
|
||||
(@pxref{Hooks}). If you simply want to change what a particular key
|
||||
does, it may be better to write a new command, and remap the old
|
||||
|
@ -732,7 +732,7 @@ character, a symbol whose name is the script to which the character
|
||||
belongs, according to the Unicode Standard classification of the
|
||||
Unicode code space into script-specific blocks. This char-table has a
|
||||
single extra slot whose value is the list of all script symbols. Note
|
||||
that Emacs' classification of characters into scripts is not a 1-for-1
|
||||
that Emacs's classification of characters into scripts is not a 1-for-1
|
||||
reflection of the Unicode standard, e.g. there is no @samp{symbol}
|
||||
script in Unicode.
|
||||
@end defvar
|
||||
|
@ -133,7 +133,7 @@ file (@pxref{Init File,,, emacs, The GNU Emacs Manual}).
|
||||
@end defun
|
||||
|
||||
@deffn Command package-initialize &optional no-activate
|
||||
This function initializes Emacs' internal record of which packages are
|
||||
This function initializes Emacs's internal record of which packages are
|
||||
installed, and then calls @code{package-activate-all}.
|
||||
|
||||
The optional argument @var{no-activate}, if non-@code{nil}, causes
|
||||
|
@ -2159,7 +2159,7 @@ node is a defun node but doesn't have a name, or the node is
|
||||
@node Tree-sitter C API
|
||||
@section Tree-sitter C API Correspondence
|
||||
|
||||
Emacs' tree-sitter integration doesn't expose every feature
|
||||
Emacs's tree-sitter integration doesn't expose every feature
|
||||
provided by tree-sitter's C API@. Missing features include:
|
||||
|
||||
@itemize
|
||||
|
@ -1977,7 +1977,7 @@ To help diagnose problems in your regexps or in the regexp engine
|
||||
itself, this function returns a string describing the compiled
|
||||
form of @var{regexp}. To make sense of it, it can be necessary
|
||||
to read at least the description of the @code{re_opcode_t} type in the
|
||||
@code{src/regex-emacs.c} file in Emacs' source code.
|
||||
@code{src/regex-emacs.c} file in Emacs's source code.
|
||||
|
||||
It is currently able to give a meaningful description only if Emacs
|
||||
was compiled with @code{--enable-checking}.
|
||||
|
@ -2218,7 +2218,7 @@ outdated. Tools available here that are useful for Emacs include:
|
||||
@item OpenSSL - used by @code{gnus} to talk to servers over SSL.
|
||||
@item Patch - used by @code{ediff-patch-file} and others to apply patches.
|
||||
@item Tar - used by @code{tar-mode} to edit tar files.
|
||||
@item TexInfo - used to build Emacs' manuals.
|
||||
@item TexInfo - used to build Emacs's manuals.
|
||||
@item Unzip - used by @code{archive-mode} for extracting zip files.
|
||||
@item Xpm - library to support XPM images (bundled with Emacs binaries)
|
||||
@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
|
||||
@findex man
|
||||
|
||||
Man pages for Emacs and other ported programs that you have can be
|
||||
read using Emacs' built-in manual reader @code{woman}. This
|
||||
read using Emacs's built-in manual reader @code{woman}. This
|
||||
requires no external programs, but if you do have a port of
|
||||
@command{man}, there is also an Emacs wrapper @code{man} that
|
||||
which may be slightly faster. A Windows version of @command{man} is
|
||||
|
@ -2127,7 +2127,7 @@ to IRC, and don't forget that you can roll back to the previous
|
||||
version by running @kbd{M-x package-delete @key{RET}}.
|
||||
@xref{Packages,,,emacs, The Emacs Editor}, for more information.
|
||||
|
||||
Note that a bug affecting Emacs' packaging machinery may prevent the
|
||||
Note that a bug affecting Emacs's packaging machinery may prevent the
|
||||
above method from working on Emacs versions 29 and below. Users on 29
|
||||
can try running @kbd{C-u M-x package-install @key{RET}} instead.
|
||||
Users on 28 and below can click on the @emph{installed} @samp{erc}
|
||||
|
@ -12075,7 +12075,7 @@ article buffer. There are many methods for doing that, but two of
|
||||
them are kind of default methods.
|
||||
|
||||
If your Emacs copy has been built with libxml2 support, then Gnus uses
|
||||
Emacs' built-in, plain elisp Simple HTML Renderer @code{shr}
|
||||
Emacs's built-in, plain elisp Simple HTML Renderer @code{shr}
|
||||
@footnote{@code{shr} displays colors as declared in the @acronym{HTML}
|
||||
article but tries to adjust them in order to be readable. If you
|
||||
prefer more contrast, @xref{FAQ 4-16}.} which is also used by Emacs'
|
||||
|
@ -144,7 +144,7 @@ and covers everything that goes into every tagged release of the themes.
|
||||
:end:
|
||||
|
||||
The Modus themes are distributed with Emacs starting with version 28.1.
|
||||
On older versions of Emacs, they can be installed using Emacs' package
|
||||
On older versions of Emacs, they can be installed using Emacs's package
|
||||
manager or manually from their code repository. There also exist
|
||||
packages for distributions of GNU/Linux.
|
||||
|
||||
@ -4769,7 +4769,7 @@ and/or mode line setup.
|
||||
:custom_id: h:4cc767dc-ffef-4c5c-9f10-82eb7b8921bf
|
||||
:end:
|
||||
|
||||
Emacs' HTML rendering library ({{{file(shr.el)}}}) may need explicit
|
||||
Emacs's HTML rendering library ({{{file(shr.el)}}}) may need explicit
|
||||
configuration to respect the theme's colors instead of whatever
|
||||
specifications the webpage provides.
|
||||
|
||||
|
@ -3359,7 +3359,7 @@ Here is the full set of built-in link types:
|
||||
|
||||
- =gnus=, =rmail=, =mhe= ::
|
||||
|
||||
Link to messages or folders from a given Emacs' MUA.
|
||||
Link to messages or folders from a given Emacs MUA.
|
||||
|
||||
- =help= ::
|
||||
|
||||
@ -23201,7 +23201,7 @@ than 30 stars. This is a hard-coded limitation of ~lmax~ in
|
||||
2003, not the beginning of time.
|
||||
|
||||
[fn:29] On computers using macOS, idleness is based on actual user
|
||||
idleness, not just Emacs' idle time. For X11, you can install a
|
||||
idleness, not just Emacs's idle time. For X11, you can install a
|
||||
utility program =x11idle.c=, available in the =org-contrib/=
|
||||
repository, or install the xprintidle package and set it to the
|
||||
variable ~org-clock-x11idle-program-name~ if you are running Debian,
|
||||
|
@ -1458,7 +1458,7 @@ When returning to the command-loop after calling the suffix command,
|
||||
the arguments are reset to @code{nil} (which causes the function to return
|
||||
@code{nil} too).
|
||||
|
||||
Like for Emacs' prefix arguments, it is advisable, but not mandatory,
|
||||
Like for Emacs's prefix arguments, it is advisable, but not mandatory,
|
||||
to access the infix arguments inside the command's @code{interactive} form.
|
||||
The preferred way of doing that is to call the @code{transient-args}
|
||||
function, which for infix arguments serves about the same purpose as
|
||||
|
@ -575,7 +575,7 @@ add @code{:demand t} to those declarations.
|
||||
Some users want to put all their customizations in use-package
|
||||
declarations, even for variables, hooks, and options that are always
|
||||
available, without loading any package.@footnote{In other words, they
|
||||
are either preloaded in Emacs or defined in Emacs' C sources.}
|
||||
are either preloaded in Emacs or defined in Emacs's C sources.}
|
||||
|
||||
For that purpose, you can use the no-op @samp{emacs} package:
|
||||
|
||||
@ -640,7 +640,7 @@ simply use @code{:if} and the appropriate Lisp expression.
|
||||
@node Manual installation
|
||||
@section Manually installed package
|
||||
|
||||
When installing packages manually, without Emacs' built-in package
|
||||
When installing packages manually, without Emacs's built-in package
|
||||
manager (@file{package.el}), it will obviously not help you set up
|
||||
autoloads or add it to your @code{load-path}. You must do it
|
||||
yourself. However, use-package makes this more convenient.
|
||||
|
@ -1800,7 +1800,7 @@ But @samp{rules} part is parsed in Bison style! Why?
|
||||
Rule delimiters are the colon (@code{:}), that follows the nonterminal
|
||||
name, and a final semicolon (@code{;}). Unfortunately these
|
||||
delimiters are not @code{open-paren}/@code{close-paren} type, and the
|
||||
Emacs' syntactic analyzer can't easily isolate data between them to
|
||||
Emacs syntactic analyzer can't easily isolate data between them to
|
||||
produce a @samp{RULES_PART} parenthesis-block-like lexical token.
|
||||
Consequently it is not possible to use @code{EXPANDFULL} to iterate in
|
||||
@samp{RULES_PART}, like this:
|
||||
|
@ -693,8 +693,8 @@ Org-Org (=ox-org=) export. The default value is ~t~.
|
||||
|
||||
*** New option ~org-babel-comint-fallback-regexp-threshold~
|
||||
|
||||
Org babel is often using Emacs' interactive REPL feature to implement
|
||||
:session functionality in code blocks. However, Emacs' REPLs use
|
||||
Org babel is often using Emacs's interactive REPL feature to implement
|
||||
:session functionality in code blocks. However, Emacs's REPLs use
|
||||
heuristics to detect which lines in the REPL buffer correspond to
|
||||
output and which lines are user prompts.
|
||||
|
||||
@ -1990,7 +1990,7 @@ When ~org-latex-src-block-backend~ is set to ~engraved~,
|
||||
=engrave-faces-latex= from [[http://elpa.gnu.org/packages/engrave-faces.html][engrave-faces]] is used to transcode source
|
||||
blocks to LaTeX. This requires the =fvextra=, =float=, and (by
|
||||
default, but not necessarily) =tcolorbox= LaTeX packages be
|
||||
installed. It uses Emacs' font-lock information, and so tends to
|
||||
installed. It uses Emacs's font-lock information, and so tends to
|
||||
produce results superior to Minted or Listings.
|
||||
*** Support for =#+include=-ing URLs
|
||||
|
||||
@ -8181,7 +8181,7 @@ that Calc formulas can operate on them.
|
||||
|
||||
**** org-ctags.el (Paul Sexton)
|
||||
|
||||
Targets like =<<my target>>= can now be found by Emacs' etag
|
||||
Targets like =<<my target>>= can now be found by Emacs's etag
|
||||
functionality, and Org-mode links can be used to link to
|
||||
etags, also in non-Org-mode files. For details, see the file
|
||||
/org-ctags.el/.
|
||||
|
@ -1103,7 +1103,7 @@ The manual also describes many other Emacs features.
|
||||
---------------------
|
||||
|
||||
There's a rich set of packages for Emacs written by the community,
|
||||
which extend Emacs' capabilities. These packages include support for
|
||||
which extend Emacs's capabilities. These packages include support for
|
||||
new languages, additional themes, plugins for integrating with
|
||||
external applications, and much, much more.
|
||||
|
||||
|
@ -518,7 +518,7 @@ Menu items are appended to the common grammar menu.")
|
||||
(delete-trailing-whitespace))))))
|
||||
|
||||
(defun wisent-make-parsers ()
|
||||
"Generate Emacs' built-in Wisent-based parser files."
|
||||
"Generate Emacs's built-in Wisent-based parser files."
|
||||
(interactive)
|
||||
(semantic-mode 1)
|
||||
;; Loop through each .wy file in current directory, and run
|
||||
|
@ -39,7 +39,7 @@
|
||||
;; C-v -> paste
|
||||
;;
|
||||
;; The tricky part is the handling of the C-x and C-c keys which
|
||||
;; are normally used as prefix keys for most of Emacs' built-in
|
||||
;; are normally used as prefix keys for most of Emacs's built-in
|
||||
;; commands. With CUA they still do!!!
|
||||
;;
|
||||
;; Only when the region is currently active (and highlighted since
|
||||
@ -138,7 +138,7 @@
|
||||
;; cua-mode's superior rectangle support uses a true visual
|
||||
;; representation of the selected rectangle, i.e. it highlights the
|
||||
;; actual part of the buffer that is currently selected as part of the
|
||||
;; rectangle. Unlike Emacs' traditional rectangle commands, the
|
||||
;; rectangle. Unlike Emacs's traditional rectangle commands, the
|
||||
;; selected rectangle always as straight left and right edges, even
|
||||
;; when those are in the middle of a TAB character or beyond the end
|
||||
;; of the current line. And it does this without actually modifying
|
||||
|
@ -40,7 +40,7 @@
|
||||
;; other in `completion-styles' are ignored.
|
||||
;;
|
||||
;; This compromise is for speed: all other styles need the full data
|
||||
;; set to be available in Emacs' addressing space, which is often slow
|
||||
;; set to be available in Emacs's addressing space, which is often slow
|
||||
;; if not completely unfeasible.
|
||||
;;
|
||||
;; To make use of the `external' style the function
|
||||
|
@ -2021,7 +2021,7 @@ workarea attribute."
|
||||
(declare-function android-frame-list-z-order "androidfns.c" (&optional display))
|
||||
|
||||
(defun frame-list-z-order (&optional display)
|
||||
"Return list of Emacs' frames, in Z (stacking) order.
|
||||
"Return list of Emacs's frames, in Z (stacking) order.
|
||||
The optional argument DISPLAY specifies which display to poll.
|
||||
DISPLAY should be either a frame or a display name (a string).
|
||||
If omitted or nil, that stands for the selected frame's display.
|
||||
|
@ -179,7 +179,7 @@ Properties can be set with
|
||||
|
||||
;; What's the deal with these "filter alists"?
|
||||
;;
|
||||
;; Let's say that Emacs' frame parameters were never designed as a tool to
|
||||
;; Let's say that Emacs's frame parameters were never designed as a tool to
|
||||
;; precisely record (or restore) a frame's state. They grew organically,
|
||||
;; and their uses and behaviors reflect their history. In using them to
|
||||
;; implement framesets, the unwary implementer, or the prospective package
|
||||
@ -277,7 +277,7 @@ Properties can be set with
|
||||
;; display they do no harm, but they clutter the parameter alist.
|
||||
;;
|
||||
;; - `minibuffer': It can contain a reference to a live window, which cannot
|
||||
;; be serialized. Because of Emacs' idiosyncratic treatment of this
|
||||
;; be serialized. Because of Emacs's idiosyncratic treatment of this
|
||||
;; parameter, frames created with (minibuffer . t) have a parameter
|
||||
;; (minibuffer . #<window...>), while frames created with
|
||||
;; (minibuffer . #<window...>) have (minibuffer . nil), which is madness
|
||||
|
@ -22,7 +22,7 @@
|
||||
|
||||
;;; Commentary:
|
||||
|
||||
;; The kmacro package provides the user interface to Emacs' basic
|
||||
;; The kmacro package provides the user interface to Emacs's basic
|
||||
;; keyboard macro functionality. With kmacro, two function keys are
|
||||
;; dedicated to keyboard macros, by default F3 and F4.
|
||||
|
||||
|
@ -220,7 +220,7 @@ which apply for this feed only, overriding the value of
|
||||
(defcustom newsticker-retrieval-method
|
||||
'intern
|
||||
"Method for retrieving news from the web, either `intern' or `extern'.
|
||||
Default value `intern' uses Emacs' built-in asynchronous download
|
||||
Default value `intern' uses Emacs's built-in asynchronous download
|
||||
capabilities (`url-retrieve'). If set to `extern' the external
|
||||
program wget is used, see `newsticker-wget-name'."
|
||||
:type '(choice :tag "Method"
|
||||
|
@ -208,7 +208,7 @@ Pass nil to omit that arg."
|
||||
"Convert FILE to OS standard file name.
|
||||
If in Cygwin environment, uses Cygwin specific function to
|
||||
convert the file name. In a Windows-NT environment, do nothing.
|
||||
Otherwise, use Emacs' standard conversion function."
|
||||
Otherwise, use Emacs's standard conversion function."
|
||||
(cond ((fboundp 'cygwin-convert-file-name-to-windows)
|
||||
(format "%S" (cygwin-convert-file-name-to-windows file)))
|
||||
((string= "windows-nt" system-type) file)
|
||||
|
@ -542,7 +542,7 @@ original string length.")
|
||||
(defvar-local org-target-link-regexps nil
|
||||
"List of regular expressions matching radio targets in plain text.
|
||||
This list is non-nil, when a single regexp would be too long to match
|
||||
all the possible targets, exceeding Emacs' regexp length limit.")
|
||||
all the possible targets, exceeding Emacs's regexp length limit.")
|
||||
|
||||
(defvar org-link-types-re nil
|
||||
"Matches a link that has a url-like prefix like \"http:\".")
|
||||
|
@ -459,7 +459,7 @@ FORMAT and ARGS are passed to `message'."
|
||||
;; With all this in mind, we ensure `write-region-inhibit-fsync' is
|
||||
;; set.
|
||||
;;
|
||||
;; To read more about this, see the comments in Emacs' fileio.c, in
|
||||
;; To read more about this, see the comments in Emacs's fileio.c, in
|
||||
;; particular the large comment block in init_fileio.
|
||||
(let ((write-region-inhibit-fsync t)
|
||||
;; We set UTF-8 here and in `org-persist--read-elisp-file'
|
||||
|
@ -663,7 +663,7 @@ Leave point in edit buffer."
|
||||
(defvar org-src-fontify-natively) ; Defined in org.el
|
||||
(defun org-src-font-lock-fontify-block (lang start end)
|
||||
"Fontify code block between START and END using LANG's syntax.
|
||||
This function is called by Emacs' automatic fontification, as long
|
||||
This function is called by Emacs's automatic fontification, as long
|
||||
as `org-src-fontify-natively' is non-nil."
|
||||
(let ((modified (buffer-modified-p)) native-tab-width)
|
||||
(remove-text-properties start end '(face nil))
|
||||
|
@ -993,7 +993,7 @@ The most comprehensive option can be set with,
|
||||
|
||||
which causes source code to be run through
|
||||
`engrave-faces-latex-buffer', which generates colorings using
|
||||
Emacs' font-lock information. This requires the Emacs package
|
||||
Emacs's font-lock information. This requires the Emacs package
|
||||
engrave-faces (available from GNU ELPA), and the LaTeX package
|
||||
fvextra be installed.
|
||||
|
||||
|
@ -535,7 +535,7 @@ From, and Cc against HEADER-REGEXP in
|
||||
"An alist for setting up `bug-reference-mode' in IRC modes.
|
||||
|
||||
This takes action if `bug-reference-mode' is enabled in IRC
|
||||
channels using one of Emacs' IRC clients. Currently, rcirc and
|
||||
channels using one of Emacs's IRC clients. Currently, rcirc and
|
||||
ERC are supported.
|
||||
|
||||
Each element has the form
|
||||
|
@ -32,7 +32,7 @@
|
||||
;; `less-css-compile-at-save' to t. To install "lessc" using the
|
||||
;; Node.js package manager, run "npm install less".
|
||||
;;
|
||||
;; Also make sure the "lessc" executable is in Emacs' PATH, example:
|
||||
;; Also make sure the "lessc" executable is in Emacs's PATH, example:
|
||||
;; (push (expand-file-name "~/.gem/ruby/1.8/bin") exec-path)
|
||||
;; or customize `less-css-lessc-command' to point to your "lessc"
|
||||
;; executable.
|
||||
|
@ -45,7 +45,7 @@
|
||||
(unless (fboundp 'seq-keep)
|
||||
(display-warning 'transient (substitute-command-keys "\
|
||||
Transient requires `seq' >= 2.24,
|
||||
but due to bad defaults, Emacs' package manager, refuses to
|
||||
but due to bad defaults, Emacs's package manager, refuses to
|
||||
upgrade this and other built-in packages to higher releases
|
||||
from GNU Elpa, when a package specifies that this is needed.
|
||||
|
||||
|
@ -703,7 +703,7 @@ update_one_menu_entry (widget_instance* instance,
|
||||
ac = 0;
|
||||
XtSetArg (al [ac], XmNsubMenuId, menu); ac++;
|
||||
/* Non-zero values don't work reliably in
|
||||
conjunction with Emacs' event loop */
|
||||
conjunction with Emacs's event loop */
|
||||
XtSetArg (al [ac], XmNmappingDelay, 0); ac++;
|
||||
#ifdef XmNpositionIndex /* This is undefined on SCO ODT 2.0. */
|
||||
/* Tell Motif to put it in the right place */
|
||||
|
@ -192,7 +192,7 @@ and if all went well, you will have a new 64-bit version of Emacs.
|
||||
|
||||
When running Emacs from outside the mingw64 shell, you will need to
|
||||
add c:\msys64\mingw64\bin to your Windows PATH, or copy the needed
|
||||
DLLs into Emacs' bin/ directory. Otherwise features such as TLS which
|
||||
DLLs into Emacs's bin/ directory. Otherwise features such as TLS which
|
||||
depend on those DLLs will be missing.
|
||||
|
||||
You can do this through Control Panel / System and Security / System /
|
||||
|
@ -233,7 +233,7 @@ See the end of the file for license conditions.
|
||||
|
||||
Virus scanners
|
||||
|
||||
Some virus scanners interfere with Emacs' use of subprocesses. If you
|
||||
Some virus scanners interfere with Emacs's use of subprocesses. If you
|
||||
are unable to use subprocesses and you use Dr. Solomon's WinGuard or
|
||||
McAfee's Vshield, turn off "Scan all files" (WinGuard) or "boot sector
|
||||
scanning" (McAfee exclusion properties).
|
||||
|
@ -603,7 +603,7 @@ typedef unsigned int EMACS_UINT;
|
||||
|
||||
Starting with MSVC 5.0, we must also place the uninitialized data
|
||||
into its own section. VC5 intermingles uninitialized data from the CRT
|
||||
between Emacs' static uninitialized data and its public uninitialized
|
||||
between Emacs's static uninitialized data and its public uninitialized
|
||||
data. A separate .bss section for Emacs groups both static and
|
||||
public uninitialized together.
|
||||
|
||||
|
@ -1740,7 +1740,7 @@ android_frame_list_z_order (struct android_display_info *dpyinfo,
|
||||
|
||||
DEFUN ("android-frame-list-z-order", Fandroid_frame_list_z_order,
|
||||
Sandroid_frame_list_z_order, 0, 1, 0,
|
||||
doc: /* Return list of Emacs' frames, in Z (stacking) order.
|
||||
doc: /* Return list of Emacs's frames, in Z (stacking) order.
|
||||
The optional argument TERMINAL specifies which display to ask about.
|
||||
TERMINAL should be either a frame or a display name (a string). If
|
||||
omitted or nil, that stands for the selected frame's display. Return
|
||||
|
@ -1721,7 +1721,7 @@ getenv_internal (const char *var, ptrdiff_t varlen, char **value,
|
||||
Vprocess_environment))
|
||||
return *value ? 1 : 0;
|
||||
|
||||
/* On Windows we make some modifications to Emacs' environment
|
||||
/* On Windows we make some modifications to Emacs's environment
|
||||
without recording them in Vprocess_environment. */
|
||||
#ifdef WINDOWSNT
|
||||
{
|
||||
|
@ -101,7 +101,7 @@ Lisp_Object Vemacs_mule_charset_list;
|
||||
int emacs_mule_charset[256];
|
||||
|
||||
/* Mapping table from ISO2022's charset (specified by DIMENSION,
|
||||
CHARS, and FINAL-CHAR) to Emacs' charset. */
|
||||
CHARS, and FINAL-CHAR) to Emacs's charset. */
|
||||
int iso_charset_table[ISO_MAX_DIMENSION][ISO_MAX_CHARS][ISO_MAX_FINAL];
|
||||
|
||||
#define CODE_POINT_TO_INDEX(charset, code) \
|
||||
|
@ -467,7 +467,7 @@ extern bool charset_map_loaded;
|
||||
#define ISO_MAX_FINAL 0x80 /* only 0x30..0xFF are used */
|
||||
|
||||
/* Mapping table from ISO2022's charset (specified by DIMENSION,
|
||||
CHARS, and FINAL_CHAR) to Emacs' charset ID. Should be accessed by
|
||||
CHARS, and FINAL_CHAR) to Emacs's charset ID. Should be accessed by
|
||||
macro ISO_CHARSET_TABLE (DIMENSION, CHARS, FINAL_CHAR). */
|
||||
extern int iso_charset_table[ISO_MAX_DIMENSION][ISO_MAX_CHARS][ISO_MAX_FINAL];
|
||||
|
||||
|
22
src/coding.c
22
src/coding.c
@ -27,11 +27,11 @@ along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>. */
|
||||
|
||||
0. General comments
|
||||
1. Preamble
|
||||
2. Emacs' internal format (emacs-utf-8) handlers
|
||||
2. Emacs's internal format (emacs-utf-8) handlers
|
||||
3. UTF-8 handlers
|
||||
4. UTF-16 handlers
|
||||
5. Charset-base coding systems handlers
|
||||
6. emacs-mule (old Emacs' internal format) handlers
|
||||
6. emacs-mule (old Emacs's internal format) handlers
|
||||
7. ISO2022 handlers
|
||||
8. Shift-JIS and BIG5 handlers
|
||||
9. CCL handlers
|
||||
@ -50,7 +50,7 @@ CODING SYSTEM
|
||||
information about how to convert byte sequences to character
|
||||
sequences and vice versa. When we say "decode", it means converting
|
||||
a byte sequence of a specific coding system into a character
|
||||
sequence that is represented by Emacs' internal coding system
|
||||
sequence that is represented by Emacs's internal coding system
|
||||
`emacs-utf-8', and when we say "encode", it means converting a
|
||||
character sequence of emacs-utf-8 to a byte sequence of a specific
|
||||
coding system.
|
||||
@ -1104,7 +1104,7 @@ alloc_destination (struct coding_system *coding, ptrdiff_t nbytes,
|
||||
#define EOL_SEEN_CRLF 4
|
||||
|
||||
|
||||
/*** 2. Emacs' internal format (emacs-utf-8) ***/
|
||||
/*** 2. Emacs's internal format (emacs-utf-8) ***/
|
||||
|
||||
|
||||
|
||||
@ -1757,9 +1757,9 @@ encode_coding_utf_16 (struct coding_system *coding)
|
||||
}
|
||||
|
||||
|
||||
/*** 6. Old Emacs' internal format (emacs-mule) ***/
|
||||
/*** 6. Old Emacs's internal format (emacs-mule) ***/
|
||||
|
||||
/* Emacs' internal format for representation of multiple character
|
||||
/* Emacs's internal format for representation of multiple character
|
||||
sets is a kind of multi-byte encoding, i.e. characters are
|
||||
represented by variable-length sequences of one-byte codes.
|
||||
|
||||
@ -1782,7 +1782,7 @@ encode_coding_utf_16 (struct coding_system *coding)
|
||||
through 0xFF. See `charset.h' for more details about leading-code
|
||||
and position-code.
|
||||
|
||||
--- CODE RANGE of Emacs' internal format ---
|
||||
--- CODE RANGE of Emacs's internal format ---
|
||||
character set range
|
||||
------------- -----
|
||||
ascii 0x00..0x7F
|
||||
@ -2812,7 +2812,7 @@ encode_coding_emacs_mule (struct coding_system *coding)
|
||||
localized platforms), and all of these are variants of ISO2022.
|
||||
|
||||
In addition to the above, Emacs handles two more kinds of escape
|
||||
sequences: ISO6429's direction specification and Emacs' private
|
||||
sequences: ISO6429's direction specification and Emacs's private
|
||||
sequence for specifying character composition.
|
||||
|
||||
ISO6429's direction specification takes the following form:
|
||||
@ -6045,7 +6045,7 @@ complement_process_encoding_system (Lisp_Object coding_system)
|
||||
|
||||
|
||||
/* Emacs has a mechanism to automatically detect a coding system if it
|
||||
is one of Emacs' internal format, ISO2022, SJIS, and BIG5. But,
|
||||
is one of Emacs's internal format, ISO2022, SJIS, and BIG5. But,
|
||||
it's impossible to distinguish some coding systems accurately
|
||||
because they use the same range of codes. So, at first, coding
|
||||
systems are categorized into 7, those are:
|
||||
@ -6053,7 +6053,7 @@ complement_process_encoding_system (Lisp_Object coding_system)
|
||||
o coding-category-emacs-mule
|
||||
|
||||
The category for a coding system which has the same code range
|
||||
as Emacs' internal format. Assigned the coding-system (Lisp
|
||||
as Emacs's internal format. Assigned the coding-system (Lisp
|
||||
symbol) `emacs-mule' by default.
|
||||
|
||||
o coding-category-sjis
|
||||
@ -10052,7 +10052,7 @@ encode_string_utf_8 (Lisp_Object string, Lisp_Object buffer,
|
||||
Emacs decoding does.
|
||||
|
||||
If HANDLE-OVER-UNI is Qt, decode a 4 or 5-byte overlong sequence
|
||||
that follows Emacs' internal representation for a character beyond
|
||||
that follows Emacs's internal representation for a character beyond
|
||||
Unicode range into the corresponding character, like the usual
|
||||
Emacs decoding does.
|
||||
|
||||
|
@ -73,7 +73,7 @@ along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>. */
|
||||
theoretically be updated by daemons running separately -- but this
|
||||
whole idea is unimplemented; in practice, at least in our
|
||||
environment, it seems such stale locks arise fairly infrequently, and
|
||||
Emacs' standard methods of dealing with clashes suffice.
|
||||
Emacs's standard methods of dealing with clashes suffice.
|
||||
|
||||
We use symlinks instead of normal files because (1) they can be
|
||||
stored more efficiently on the filesystem, since the kernel knows
|
||||
|
@ -2943,7 +2943,7 @@ It can later be retrieved with `x-get-resource'. */)
|
||||
|
||||
DEFUN ("haiku-frame-list-z-order", Fhaiku_frame_list_z_order,
|
||||
Shaiku_frame_list_z_order, 0, 1, 0,
|
||||
doc: /* Return list of Emacs' frames, in Z (stacking) order.
|
||||
doc: /* Return list of Emacs's frames, in Z (stacking) order.
|
||||
If TERMINAL is non-nil and specifies a live frame, return the child
|
||||
frames of that frame in Z (stacking) order.
|
||||
|
||||
|
@ -5436,7 +5436,7 @@ static const struct image_keyword xpm_format[XPM_LAST] =
|
||||
|
||||
#if defined HAVE_X_WINDOWS && !defined USE_CAIRO
|
||||
|
||||
/* Define ALLOC_XPM_COLORS if we can use Emacs' own color allocation
|
||||
/* Define ALLOC_XPM_COLORS if we can use Emacs's own color allocation
|
||||
functions for allocating image colors. Our own functions handle
|
||||
color allocation failures more gracefully than the ones on the XPM
|
||||
lib. */
|
||||
|
@ -64,7 +64,7 @@ along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>. */
|
||||
|
||||
==== FIXME: bug#58342 some important operations remain slow ===
|
||||
|
||||
The amortized costs of Emacs' previous-overlay-change and
|
||||
The amortized costs of Emacs's previous-overlay-change and
|
||||
next-overlay-change functions are O(N) with this data structure.
|
||||
The root problem is that we only have an order for the BEG field,
|
||||
but not the END. The previous/next overlay change operations need
|
||||
|
@ -599,7 +599,7 @@ dos_set_window_size (int *rows, int *cols)
|
||||
*rows = ScreenRows ();
|
||||
*cols = ScreenCols ();
|
||||
|
||||
/* Update Emacs' notion of screen dimensions. */
|
||||
/* Update Emacs's notion of screen dimensions. */
|
||||
screen_size_X = *cols;
|
||||
screen_size_Y = *rows;
|
||||
screen_size = *cols * *rows;
|
||||
|
@ -1628,7 +1628,7 @@ Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side.
|
||||
|
||||
DEFUN ("ns-frame-list-z-order", Fns_frame_list_z_order,
|
||||
Sns_frame_list_z_order, 0, 1, 0,
|
||||
doc: /* Return list of Emacs' frames, in Z (stacking) order.
|
||||
doc: /* Return list of Emacs's frames, in Z (stacking) order.
|
||||
If TERMINAL is non-nil and specifies a live frame, return the child
|
||||
frames of that frame in Z (stacking) order.
|
||||
|
||||
|
@ -577,7 +577,7 @@ - (unsigned long)unsignedLong
|
||||
}
|
||||
|
||||
/* Check if LANG can be used for initializing the locale. If not,
|
||||
use a default setting. Note that Emacs' main will undo the
|
||||
use a default setting. Note that Emacs's main will undo the
|
||||
setlocale below, initializing the locale from the
|
||||
environment. */
|
||||
if (setlocale (LC_ALL, lang) == NULL)
|
||||
|
@ -700,7 +700,7 @@ MODULE should be the name of an SQlite module's file, a
|
||||
shared library in the system-dependent format and having a
|
||||
system-dependent file-name extension.
|
||||
|
||||
Only modules on Emacs' list of allowed modules can be loaded. */)
|
||||
Only modules on Emacs's list of allowed modules can be loaded. */)
|
||||
(Lisp_Object db, Lisp_Object module)
|
||||
{
|
||||
check_sqlite (db, false);
|
||||
|
@ -3901,7 +3901,7 @@ deliver_wm_chars (int do_translate, HWND hwnd, UINT msg, UINT wParam,
|
||||
most probably, not needed -- and harms a lot).
|
||||
|
||||
So, with the usual message pump, the following call to TranslateMessage()
|
||||
is not needed (and is going to be VERY harmful). With Emacs' message
|
||||
is not needed (and is going to be VERY harmful). With Emacs's message
|
||||
pump, the call is needed. */
|
||||
if (do_translate)
|
||||
{
|
||||
@ -9321,7 +9321,7 @@ w32_frame_list_z_order (struct w32_display_info *dpyinfo, HWND window)
|
||||
|
||||
DEFUN ("w32-frame-list-z-order", Fw32_frame_list_z_order,
|
||||
Sw32_frame_list_z_order, 0, 1, 0,
|
||||
doc: /* Return list of Emacs' frames, in Z (stacking) order.
|
||||
doc: /* Return list of Emacs's frames, in Z (stacking) order.
|
||||
The optional argument DISPLAY specifies which display to ask about.
|
||||
DISPLAY should be either a frame or a display name (a string). If
|
||||
omitted or nil, that stands for the selected frame's display.
|
||||
|
@ -7060,7 +7060,7 @@ x_frame_list_z_order (struct x_display_info *dpyinfo, Window window)
|
||||
|
||||
DEFUN ("x-frame-list-z-order", Fx_frame_list_z_order,
|
||||
Sx_frame_list_z_order, 0, 1, 0,
|
||||
doc: /* Return list of Emacs' frames, in Z (stacking) order.
|
||||
doc: /* Return list of Emacs's frames, in Z (stacking) order.
|
||||
The optional argument TERMINAL specifies which display to ask about.
|
||||
TERMINAL should be either a frame or a display name (a string). If
|
||||
omitted or nil, that stands for the selected frame's display. Return
|
||||
|
@ -32245,7 +32245,7 @@ x_initialize (void)
|
||||
Xt_app_con = XtCreateApplicationContext ();
|
||||
|
||||
/* Register a converter from strings to pixels, which uses
|
||||
Emacs' color allocation infrastructure. */
|
||||
Emacs's color allocation infrastructure. */
|
||||
XtAppSetTypeConverter (Xt_app_con,
|
||||
XtRString, XtRPixel, cvt_string_to_pixel,
|
||||
cvt_string_to_pixel_args,
|
||||
|
@ -308,7 +308,7 @@ desired effect."
|
||||
(cl-loop for i below 3 do
|
||||
(message "%s" i)))
|
||||
;; Uses the implicit messages buffer truncation implemented
|
||||
;; in Emacs' C core.
|
||||
;; in Emacs's C core.
|
||||
(c (x)
|
||||
(ert-with-buffer-renamed ("*Messages*")
|
||||
(let ((message-log-max x))
|
||||
|
@ -1720,7 +1720,7 @@ This test works best when Emacs is configured with
|
||||
--enable-checking=yes. This is a little bit like fuzz testing,
|
||||
except this test has no way to reduce to a minimal failing test
|
||||
case. Regardless, by exercising many corner cases bugs can be
|
||||
found using Emacs' internal consistency assertions."
|
||||
found using Emacs's internal consistency assertions."
|
||||
(let* (
|
||||
;; The size and slack for the test buffer size.
|
||||
(buffer-size-target 1000)
|
||||
|
@ -59,7 +59,7 @@
|
||||
;; On MS-Windows, "nul.FOO" resolves to the null
|
||||
;; device, and thus acts like an always-empty
|
||||
;; file, for any FOO, in any directory. So
|
||||
;; c:/null.exe passes Emacs' test for the file's
|
||||
;; c:/null.exe passes Emacs's test for the file's
|
||||
;; existence, and ensures we hit an error in the
|
||||
;; w32 process spawn code.
|
||||
(call-process "c:/nul.exe")
|
||||
|
@ -68,7 +68,7 @@ unavailable to Lisp."
|
||||
"Spoil the lock file for FILE-NAME.
|
||||
Cause Emacs to report errors for various file locking operations
|
||||
on FILE-NAME going forward. Create a file that is incompatible
|
||||
with Emacs' file locking protocol, but uses the same name as
|
||||
with Emacs's file locking protocol, but uses the same name as
|
||||
FILE-NAME's lock file. A directory file is used, which is
|
||||
portable in practice."
|
||||
(make-directory (filelock-tests--make-lock-name file-name)))
|
||||
|
Loading…
Reference in New Issue
Block a user