#
# Written by Jim Meyering
-# This is a prologue that allows to run a perl script as an executable
+# This is a prologue that allows running a perl script as an executable
# on systems that are compliant to a POSIX version before POSIX:2017.
# On such systems, the usual invocation of an executable through execlp()
# or execvp() fails with ENOEXEC if it is a script that does not start
# 5. Set UPDATE_COPYRIGHT_HOLDER if the copyright holder is other
# than "Free Software Foundation, Inc.".
-# This is a prologue that allows to run a perl script as an executable
+# This is a prologue that allows running a perl script as an executable
# on systems that are compliant to a POSIX version before POSIX:2017.
# On such systems, the usual invocation of an executable through execlp()
# or execvp() fails with ENOEXEC if it is a script that does not start
Yank the last kill into the buffer, at point (@code{yank}).
@item M-y
Either replace the text just yanked with an earlier batch of killed
-text (@code{yank-pop}), or allow to select from the list of
+text (@code{yank-pop}), or allow selecting from the list of
previously-killed batches of text. @xref{Earlier Kills}.
@item C-M-w
Cause the following command, if it is a kill command, to append to the
@vindex vc-directory-exclusion-list
The command @kbd{C-x p f} (@code{project-find-file}) is a convenient
way of visiting files (@pxref{Visiting}) that belong to the current
-project. Unlike @kbd{C-x C-f}, this command doesn't require to type
+project. Unlike @kbd{C-x C-f}, this command doesn't require typing
the full file name of the file to visit, you can type only the file's
base name (i.e., omit the leading directories). In addition, the
completion candidates considered by the command include only the files
Lisp function definitions into a true compiled code, known as
@dfn{native code}. This feature uses the @file{libgccjit} library,
which is part of the GCC distribution, and requires that Emacs be
-built with support for using that library. It also requires to have
-GCC and Binutils (the assembler and linker) available on your system
-for you to be able to native-compile Lisp code.
+built with support for using that library. It also requires GCC and
+Binutils (the assembler and linker) to be available on your system for
+you to be able to native-compile Lisp code.
@vindex native-compile@r{, a Lisp feature}
To determine whether the current Emacs process can produce and load
consistent with the requirements of the Unicode Standard v9.0. Note,
however, that the way Emacs displays continuation lines when text
direction is opposite to the base paragraph direction deviates from
-the UBA, which requires to perform line wrapping before reordering
+the UBA, which requires performing line wrapping before reordering
text for display.
@defvar bidi-display-reordering
Outer borders are never shown on text terminal frames and on frames
generated by GTK+ routines. On MS-Windows, the outer border is emulated
with the help of a one pixel wide external border. Non-toolkit builds
-on X allow to change the color of the outer border by setting the
+on X allow changing the color of the outer border by setting the
@code{border-color} frame parameter (@pxref{Layout Parameters}).
@item Title Bar
frame's native rectangle) and the bottom edge by @var{-y} pixels up from
the bottom edge of the screen (or the parent frame's native rectangle).
-Note that negative values do not permit to align the right or bottom
+Note that negative values do not permit aligning the right or bottom
edge of @var{frame} exactly at the right or bottom edge of its display
-or parent frame. Neither do they allow to specify a position that does
+or parent frame. Neither do they allow specifying a position that does
not lie within the edges of the display or parent frame. The frame
parameters @code{left} and @code{top} (@pxref{Position Parameters})
-allow to do that, but may still fail to provide good results for the
+allow doing that, but may still fail to provide good results for the
initial or a new frame.
This function has no effect on text terminal frames.
In order to give a child frame a draggable header or mode line, the
window parameters @code{mode-line-format} and @code{header-line-format}
-are handy (@pxref{Window Parameters}). These allow to remove an
+are handy (@pxref{Window Parameters}). These allow removing an
unwanted mode line (when @code{drag-with-header-line} is chosen) and to
remove mouse-sensitive areas which might interfere with frame dragging.
Emacs Lisp objects communicated via the @acronym{API}; it is the
functional equivalent of the @code{Lisp_Object} type used in Emacs C
primitives (@pxref{Writing Emacs Primitives}). This section describes
-the parts of the module @acronym{API} that allow to create
+the parts of the module @acronym{API} that allow creating
@code{emacs_value} objects corresponding to basic Lisp data types, and
how to access from C data in @code{emacs_value} objects that
correspond to Lisp objects.
position in the current buffer it returns the offset from the
beginning of the current buffer's file of the byte that corresponds to
the given character @var{position} in the buffer. The conversion
-requires to know how the text is encoded in the buffer's file; this is
+requires knowing how the text is encoded in the buffer's file; this is
what the @var{coding-system} argument is for, defaulting to the value
of @code{buffer-file-coding-system}. The optional argument
@var{quality} specifies how accurate the result should be; it should
specified by this variable, these operations select an alternative
encoding by calling the function @code{select-safe-coding-system}
(@pxref{User-Chosen Coding Systems}). If selecting a different encoding
-requires to ask the user to specify a coding system,
+requires asking the user to specify a coding system,
@code{buffer-file-coding-system} is updated to the newly selected coding
system.
stream to a different destination.
@cindex program arguments
- All three of the subprocess-creating functions allow to specify
+ All three of the subprocess-creating functions allow specifying
command-line arguments for the process to run. For @code{call-process}
and @code{call-process-region}, these come in the form of a
@code{&rest} argument, @var{args}. For @code{make-process}, both the
returns a string describing the signal interrupting a remote process.
When a process returns an exit code greater than 128, it is
-interpreted as a signal. @code{process-file} requires to return a
+interpreted as a signal. @code{process-file} requires returning a
string describing this signal.
Since there are processes violating this rule, returning exit codes
@code{default-value} will then return the value from that binding, not
the global value, and @code{set-default} will be prevented from
setting the global value (it will change the let-bound value instead).
-The following two functions allow to reference the global value even
+The following two functions allow referencing the global value even
if it's shadowed by a let-binding.
@cindex top-level default value
coordinate would equal the left edge coordinate of the frame's new
root window.
-Four special values for @code{direction} entries allow to implicitly
-specify the selected frame's main window as the reference window:
+Four special values for @code{direction} entries allow implicitly
+specifying the selected frame's main window as the reference window:
@code{leftmost}, @code{top}, @code{rightmost} and @code{bottom}. This
means that instead of, for example, @w{@code{(direction . left)
(window . main)}} one can just specify @w{@code{(direction
main window is either a ``normal'' live window or specifies the area
containing all the normal windows.
- In their most simple form of use, side windows allow to display
+ In their most simple form of use, side windows allow displaying
specific buffers always in the same area of a frame. Hence they can
be regarded as a generalization of the concept provided by
@code{display-buffer-at-bottom} (@pxref{Buffer Display Action
Mouse auto-selection can be used to emulate a focus follows mouse policy
for child frames (@pxref{Child Frames}) which usually are not tracked by
-the window manager. This requires to set the value of
+the window manager. This requires setting the value of
@code{focus-follows-mouse} (@pxref{Input Focus}) to a non-@code{nil}
value. If the value of @code{focus-follows-mouse} is @code{auto-raise},
entering a child frame with the mouse will raise it automatically above
@end defun
The functions @code{window-state-get} and @code{window-state-put} also
-allow to exchange the contents of two live windows. The following
+allow exchanging the contents of two live windows. The following
function does precisely that:
@deffn Command window-swap-states &optional window-1 window-2 size
#+vindex: org-agenda-effort-filter-preset
#+vindex: org-agenda-regexp-filter-preset
Agenda built-in or custom commands are statically defined. Agenda
-filters and limits allow to flexibly narrow down the list of agenda
+filters and limits allow flexibly narrowing down the list of agenda
entries.
/Filters/ only change the visibility of items, are very fast and are
@end group
@end lisp
-This works only for connection methods which allow to override the
+This works only for connection methods which allow overriding the
remote login shell, like @option{sshx} or @option{plink}. See
@ref{Inline methods} and @ref{External methods} for connection methods
which support this.
The host name for Kubernetes connections can be of kind [CONTAINER.]POD,
in order to specify a dedicated container. If there is just the pod
name, the first container in the pod is taken. The new user options
-'tramp-kubernetes-context' and 'tramp-kubernetes-namespace' allow to
-access pods with different context or namespace but the default one.
+'tramp-kubernetes-context' and 'tramp-kubernetes-namespace' allow
+accessing pods with different context or namespace but the default one.
+++
*** Rename 'tramp-use-ssh-controlmaster-options' to 'tramp-use-connection-share'.
*** New commands for reading mailing lists.
The new Rmail commands 'rmail-mailing-list-post',
'rmail-mailing-list-unsubscribe', 'rmail-mailing-list-help', and
-'rmail-mailing-list-archive' allow to, respectively, post to,
-unsubscribe from, request help about, and browse the archives, of the
-mailing list from which the current email message was delivered.
+'rmail-mailing-list-archive' allow, respectively, posting to,
+unsubscribing from, requesting help about, and browsing the archives
+of, the mailing list from which the current email message was
+delivered.
** Dictionary
** Notifications
+++
-*** Allow to use Icon Naming Specification for ':app-icon'.
+*** Allow using Icon Naming Specification for ':app-icon'.
You can use a symbol as the value for ':app-icon' to provide icon name
without specifying a file, like this:
*** References to external documents.
-The LaTeX package 'xr' allows to cross-reference labels in external
+The LaTeX package 'xr' allows cross-referencing labels in external
documents. RefTeX can provide information about the external
documents as well. To use this feature, set up the \externaldocument
macros required by the 'xr' package and rescan the document with
it to return immediately without waiting for you to "finish" the
buffer in Emacs.
-*** The new option --alternate-editor allows to specify an editor to
+*** The new option --alternate-editor allows specifying an editor to
use if Emacs is not running. The environment variable
ALTERNATE_EDITOR can be used for the same effect; the command line
option takes precedence.
*** The new user option 'rmail-automatic-folder-directives' specifies
in which folder to put messages automatically.
-*** The new function 'rmail-redecode-body' allows to fix a message
+*** The new function 'rmail-redecode-body' allows fixing a message
with non-ASCII characters if Emacs happens to decode it incorrectly
due to missing or malformed "charset=" header.
** The Rmail command 'o' ('rmail-output-to-rmail-file') now writes the
current message in the internal 'emacs-mule' encoding, rather than in
the encoding taken from the variable 'buffer-file-coding-system'.
-This allows to save messages whose characters cannot be safely encoded
+This allows saving messages whose characters cannot be safely encoded
by the buffer's coding system, and makes sure the message will be
displayed correctly when you later visit the target Rmail file.
sorted *Index* buffer which looks like the final index. Entries
can be edited from that buffer.
-*** Label and citation key selection now allow to select several
+*** Label and citation key selection now allow selecting several
items and reference them together (use 'm' to mark items, 'a' or
'A' to use all marked entries).
*** The new package zone.el plays games with Emacs' display when
Emacs is idle.
-*** The new package tildify.el allows to add hard spaces or other text
+*** The new package tildify.el allows adding hard spaces or other text
fragments in accordance with the current major mode.
*** The new package xml.el provides a simple but generic XML
'log-view-mode' to view RCS and SCCS logs and 'log-edit-mode' used to
enter check-in log messages.
-*** The new package called 'woman' allows to browse Unix man pages
+*** The new package called 'woman' allows browsing Unix man pages
without invoking external programs.
The command `M-x woman' formats manual pages entirely in Emacs Lisp
- sorted by file paths, file names, ascending or descending.
- showing paths relative to the current default-directory
-The 'recentf-filter-changer' menu filter function allows to
-dynamically change the menu appearance.
+The 'recentf-filter-changer' menu filter function allows
+dynamically changing the menu appearance.
*** 'elide-head' provides a mechanism for eliding boilerplate header
text.
** Hexl contains a new command 'hexl-insert-hex-string' which inserts
a string of hexadecimal numbers read from the mini-buffer.
-** Hexl mode allows to insert non-ASCII characters.
+** Hexl mode allows inserting non-ASCII characters.
The non-ASCII characters are encoded using the same encoding as the
file you are visiting in Hexl mode.
** The new function 'interactive-form' can be used to obtain the
interactive form of a function.
-** The keyword :set-after in defcustom allows to specify dependencies
+** The keyword :set-after in defcustom allows specifying dependencies
between custom options. Example:
(defcustom default-input-method nil
13. Whether or not a box should be drawn around characters, its
color, the width of the box lines, and 3D appearance.
-Faces are frame-local by nature because Emacs allows to define the
+Faces are frame-local by nature because Emacs allows defining the
same named face (face names are symbols) differently for different
frames. Each frame has an alist of face definitions for all named
faces. The value of a named face in such an alist is a Lisp vector
The new command 'reftex-create-bibtex-file' creates a BibTeX database
with all entries referenced in the current document. The keys "e" and
-"E" allow to produce a BibTeX database file from entries marked in a
+"E" allow producing a BibTeX database file from entries marked in a
citation selection buffer.
The command 'reftex-citation' uses the word in the buffer before the
*** The new commands 'pp-macroexpand-expression' and
'pp-macroexpand-last-sexp' pretty-print macro expansions.
-*** The new command 'set-file-modes' allows to set file's mode bits.
+*** The new command 'set-file-modes' allows setting file's mode bits.
The mode bits can be specified in symbolic notation, like with GNU
Coreutils, in addition to an octal number. 'chmod' is a new
convenience alias for this function.
*** New macro 'with-help-window' should set up help windows better
than 'with-output-to-temp-buffer' with 'print-help-return-message'.
-*** New option 'help-window-select' permits to customize whether help
+*** New option 'help-window-select' permits customizing whether help
window shall be automatically selected when invoking help.
*** New variable 'help-window-point-marker' permits one to specify a new
** TeX modes
*** New option 'latex-indent-within-escaped-parens'
-permits to customize indentation of LaTeX environments delimited
+permits customizing indentation of LaTeX environments delimited
by escaped parens.
** T-mouse Mode
a single changeset.
*** 'vc-dir' is a new command that displays file names and their VC
-status. It allows to apply various VC operations to a file, a
+status. It allows applying various VC operations to a file, a
directory or a set of files/directories.
*** VC switches are no longer appended, rather the first non-nil value is used.
** Tramp
-*** New connection method "adb", which allows to access Android
+*** New connection method "adb", which allows accessing Android
devices by the Android Debug Bridge. The variable 'tramp-adb-program'
can be used to adapt the path of the "adb" program, if needed.
display actions, taking precedence over 'display-buffer-base-action'.
*** New option 'window-combination-limit'.
-The new option 'window-combination-limit' allows to return the space
+The new option 'window-combination-limit' allows returning the space
obtained for resizing or creating a window more reliably to the window
from which such space was obtained.
*** New option 'window-combination-resize'.
-The new option 'window-combination-resize' allows to split a window that
+The new option 'window-combination-resize' allows splitting a window that
otherwise cannot be split because it's too small by stealing space from
other windows in the same combination. Subsequent resizing or deletion
of the window will resize all windows in the same combination as well.
These maximize and minimize the size of a window within its frame.
*** New commands 'switch-to-prev-buffer' and 'switch-to-next-buffer'.
-These functions allow to navigate through the live buffers that have
+These functions allow navigating through the live buffers that have
been shown in a specific window.
** Minibuffer changes
For each window you can specify a parameter to override the default
behavior of a number of functions like 'split-window', 'delete-window'
and 'delete-other-windows'. The variable 'ignore-window-parameters'
-allows to ignore processing such parameters.
+allows ignoring processing such parameters.
*** New semantics of third argument of 'split-window'.
The third argument of 'split-window' has been renamed to SIDE and can be
See the docstring of 'display-buffer' for details.
*** New functions 'window-state-get' and 'window-state-put'.
-These functions allow to save and restore the state of an arbitrary
+These functions allow saving and restoring the state of an arbitrary
frame or window as an Elisp object.
** Completion
** Installing Emacs now installs the emacs-module.h file.
The emacs-module.h file is now installed in the system-wide include
-directory as part of the Emacs installation. This allows to build
+directory as part of the Emacs installation. This allows building
Emacs modules outside of the Emacs source tree.
\f
variety of version control system-specific functionality from VC
without complexifying either the VC command set or the backend API.
-*** 'C-x v v' in a diffs buffer allows to commit only some of the changes.
+*** 'C-x v v' in a diffs buffer allows committing only some of the changes.
This command is intended to allow you to commit only some of the
changes you have in your working tree. Begin by creating a buffer
with the changes against the last commit, e.g. with 'C-x v D'
make it more convenient to inspect and modify them.
*** New function 'connection-local-update-profile-variables'.
-This function allows to modify the settings of an existing
+This function allows modifying the settings of an existing
connection-local profile.
*** New macro 'with-connection-local-application-variables'.
dimensions.
** 'window-text-pixel-size' understands a new meaning of FROM.
-Specifying a cons as the FROM argument allows to start measuring text
+Specifying a cons as the FROM argument allows measuring text starting
from a specified amount of pixels above or below a position.
** 'window-body-width' and 'window-body-height' can use remapped faces.
environment to specify additional directories where shared libraries
can be found.
-Other systems allow to set LD_RUN_PATH in a similar way, but before
+Other systems allow setting LD_RUN_PATH in a similar way, but before
Emacs is linked. With LD_RUN_PATH set, the linker will include a
specified run-time search path in the executable.
keys can serve as Meta.
The 'xkeycaps' also shows a visual representation of the current
-keyboard settings. It also allows to modify them.
+keyboard settings. It also allows modifying them.
*** GNU/Linux: slow startup on Linux-based GNU systems.
directory to that new home directory.
. Move all the *.eln files from ~/.emacs.d/eln-cache to a directory
out of the C:\Users tree, and customize Emacs to use that
- directory for *.eln files. This requires to call the function
+ directory for *.eln files. This requires calling the function
startup-redirect-eln-cache in your init file, to force Emacs to
write *.eln files compiled at run time to that directory.
. Delete all *.eln files in your ~/.emacs.d/eln-cache directory, and
*** Locating schemas
-**** Should 'rng-validate-mode' allow to specify a schema?
+**** Should 'rng-validate-mode' allow specifying a schema?
Give the user an opportunity to specify a schema if there is currently
none? Or should it at least give a hint to the user how to specify a
non-vacuous schema?
("'Z" ?Ź)
(".z" ?ż)
(".Z" ?Ż)
- ;; Explicit input of prefix characters. Normally, to input a prefix
- ;; character itself, one needs to press <Tab>. Definitions below
- ;; allow to input those characters by entering them twice.
+ ;; Explicit input of prefix characters. Normally, to input a prefix
+ ;; character itself, one needs to press <Tab>. Definitions below
+ ;; allow inputting those characters by entering them twice.
("//" ?/)
("\\\\" ?\\)
("~~" ?~)
"A function to be called with one argument, VEC.
It should return a string which is used to check, whether the
configuration of the remote host has been changed (which would
-require to flush the cache data). This string is kept as
+require flushing the cache data). This string is kept as
connection property \"config-check-data\".
This variable is intended as connection-local variable.")
docstring. Otherwise, if `org-link-make-description-function' is
non-nil, this function will be called with the link target, and
the result will be the default link description. When called
-non-interactively, don't allow to edit the default description."
+non-interactively, don't allow editing the default description."
(interactive "P")
(let* ((wcf (current-window-configuration))
(origbuf (current-buffer))
(interactive)
(let ((old-regexp org-target-link-regexp)
;; Some languages, e.g., Chinese, do not use spaces to
- ;; separate words. Also allow to surround radio targets with
+ ;; separate words. Also allow surrounding radio targets with
;; line-breakable characters.
(before-re "\\(?:^\\|[^[:alnum:]]\\|\\c|\\)\\(")
(after-re "\\)\\(?:$\\|[^[:alnum:]]\\|\\c|\\)")
;; object types they can contain will be specified in
;; `org-element-object-restrictions'.
;;
-;; Creating a new type of object requires to alter
+;; Creating a new type of object requires altering
;; `org-element--object-regexp' and `org-element--object-lex', add the
;; new type in `org-element-all-objects', and possibly add
;; restrictions in `org-element-object-restrictions'.
;;
;; Also treat any newline character and associated
;; indentation as a single space character. This is not
- ;; compatible with RFC 3986, which requires to ignore
+ ;; compatible with RFC 3986, which requires ignoring
;; them altogether. However, doing so would require
;; users to encode spaces on the fly when writing links
;; (e.g., insert [[shell:ls%20*.org]] instead of
portability of tables."
:group 'org-table-calculation
:type '(choice
- (const :tag "Allow to cross" t)
+ (const :tag "Allow crossing hline" t)
(const :tag "Stick to hline" nil)
(const :tag "Error on attempt to cross" error)))
;; Aligning table from the first row will not shrink again the
;; second row, which was not visible initially.
;;
- ;; However, fixing it requires to check every row, which may be
+ ;; However, fixing it requires checking every row, which may be
;; slow on large tables. Moreover, the hindrance of this
;; pathological case is very limited.
(beginning-of-line)
nil nil nil nil default-prop)))
(defun org-set-property-and-value (use-last)
- "Allow to set [PROPERTY]: [value] direction from prompt.
+ "Allow setting [PROPERTY]: [value] direction from prompt.
When use-default, don't even ask, just use the last
\"[PROPERTY]: [value]\" string from the history."
(interactive "P")
(defun org-open-line (n)
"Insert a new row in tables, call `open-line' elsewhere.
If `org-special-ctrl-o' is nil, just call `open-line' everywhere.
-As a special case, when a document starts with a table, allow to
-call `open-line' on the very first character."
+As a special case, when a document starts with a table, allow
+calling `open-line' on the very first character."
(interactive "*p")
(if (and org-special-ctrl-o (/= (point) 1) (org-at-table-p))
(org-table-insert-row)
(require 'thingatpt) ; end-of-thing
(require 'warnings) ; warning-numeric-level, display-warning
(require 'compile) ; for some faces
-;; We need the next require to avoid compiler warnings and run-time
+;; We need the next `require' to avoid compiler warnings and run-time
;; errors about mouse-wheel-up/down-event in builds --without-x, where
;; mwheel is not preloaded.
(require 'mwheel)
Optional fourth arg OUTPUT-BUFFER specifies where to put the
command's output. If the value is a buffer or buffer name,
erase that buffer and insert the output there; a non-nil value of
-`shell-command-dont-erase-buffer' prevent to erase the buffer.
+`shell-command-dont-erase-buffer' prevents erasing the buffer.
If the value is nil, use the buffer specified by `shell-command-buffer-name'.
Any other non-nil value means to insert the output in the
current buffer after START.
(defcustom process-file-return-signal-string nil
"Whether to return a string describing the signal interrupting a process.
When a process returns an exit code greater than 128, it is
-interpreted as a signal. `process-file' requires to return a
+interpreted as a signal. `process-file' requires returning a
string describing this signal.
Since there are processes violating this rule, returning exit
codes greater than 128 which are not bound to a signal,
:type 'hook)
(defcustom enriched-allow-eval-in-display-props nil
- "If non-nil allow to evaluate arbitrary forms in display properties.
+ "If non-nil, allow evaluating arbitrary forms in display properties.
Enriched mode recognizes display properties of text stored using
an extension command to the text/enriched format, \"x-display\".
window produced this way is on the side of the reference window
specified by the `direction' entry.
-Four special values for `direction' entries allow to implicitly
-specify the selected frame's main window as reference window:
+Four special values for `direction' entries allow implicitly
+specifying the selected frame's main window as reference window:
`leftmost', `top', `rightmost' and `bottom'. Hence, instead of
`(direction . left) (window . main)' one can simply write
`(direction . leftmost)'.
/* Unlike MS and mingw.org, MinGW64 doesn't define gai_strerror as an
inline function in a system header file, and instead seems to
- require to link against ws2_32.a. But we don't want to link with
+ require linking against ws2_32.a. But we don't want to link with
-lws2_32, as that would make Emacs dependent on the respective DLL.
So MinGW64 is amply punished here by the following: */
#undef HAVE_GAI_STRERROR
&& !f->cursor_type_changed
&& NILP (Vshow_trailing_whitespace)
/* When display-line-numbers is in relative mode, moving point
- requires to redraw the entire window. */
+ requires redrawing the entire window. */
&& !EQ (Vdisplay_line_numbers, Qrelative)
&& !EQ (Vdisplay_line_numbers, Qvisual)
/* When the current line number should be displayed in a
projects / emacs.git / commitdiff