From c0400151f8880862d460f0e47be287237a6182ad Mon Sep 17 00:00:00 2001 From: Po Lu Date: Sun, 10 Sep 2023 09:33:50 +0800 Subject: [PATCH] Correct many instances of ``allows to'' Refer to: lists.gnu.org/archive/html/emacs-devel/2016-01/msg01598.html * doc/emacs/frames.texi (Tab Bars): * doc/emacs/maintaining.texi (Tag Syntax): * doc/lispref/compile.texi (Native Compilation): * doc/lispref/control.texi (Destructuring with pcase Patterns): * doc/lispref/display.texi (Overlay Properties, Glyphless Chars): * doc/lispref/frames.texi (Size Parameters, Layout Parameters) (Child Frames): * doc/lispref/minibuf.texi (Minibuffer Windows): * doc/lispref/processes.texi (Asynchronous Processes): * doc/lispref/windows.texi (Precedence of Action Functions) (Mouse Window Auto-selection): * doc/misc/autotype.texi (Autoinserting): * doc/misc/efaq.texi (New in Emacs 28): * doc/misc/idlwave.texi (Examining Variables): * doc/misc/ses.texi (Quick Tutorial, Standard formula functions): * doc/misc/tramp.texi (External methods, FUSE-based methods): * lisp/comint.el (comint-insert-previous-argument-from-end): * lisp/emacs-lisp/rmc.el (read-multiple-choice): * lisp/gnus/gnus-util.el: * lisp/mail/rmailsum.el (rmail-summary-progressively-narrow): * lisp/mouse.el (mouse-drag-track): * lisp/net/tramp-sudoedit.el: * lisp/obsolete/landmark.el: * lisp/org/org.el (org-startup-truncated, org-file-apps): * lisp/pixel-scroll.el (pixel-scroll-precision-mode): * lisp/progmodes/cperl-mode.el (cperl-praise): * lisp/simple.el (yank-from-kill-ring, kill-visual-line): * lisp/window.el (delete-window-choose-selected): * src/ChangeLog.11: * src/xdisp.c (syms_of_xdisp): * src/xterm.c (handle_one_xevent): The construct ``allows to '' is not English inasmuch as no direct object to ``allows'' is provided. Correct and rephrase each instance of such a construct within our documentation and commentary. --- doc/emacs/frames.texi | 7 ++++--- doc/emacs/maintaining.texi | 4 ++-- doc/lispref/compile.texi | 6 +++--- doc/lispref/control.texi | 10 +++++----- doc/lispref/display.texi | 8 ++++---- doc/lispref/frames.texi | 38 ++++++++++++++++++------------------ doc/lispref/minibuf.texi | 2 +- doc/lispref/processes.texi | 2 +- doc/lispref/windows.texi | 12 ++++++------ doc/misc/autotype.texi | 8 ++++---- doc/misc/efaq.texi | 4 ++-- doc/misc/idlwave.texi | 2 +- doc/misc/ses.texi | 4 ++-- doc/misc/tramp.texi | 8 ++++---- lisp/comint.el | 2 +- lisp/emacs-lisp/rmc.el | 3 ++- lisp/gnus/gnus-util.el | 8 ++++---- lisp/mail/rmailsum.el | 2 +- lisp/mouse.el | 9 +++++---- lisp/net/tramp-sudoedit.el | 2 +- lisp/obsolete/landmark.el | 8 ++++---- lisp/org/org.el | 19 +++++++++--------- lisp/pixel-scroll.el | 2 +- lisp/progmodes/cperl-mode.el | 3 ++- lisp/simple.el | 8 ++++---- lisp/window.el | 4 ++-- src/ChangeLog.11 | 2 +- src/xdisp.c | 14 ++++++------- src/xterm.c | 20 ++++++++++--------- 29 files changed, 114 insertions(+), 107 deletions(-) diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index a968c2a97c5..2a9567a7bcd 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -1408,9 +1408,10 @@ the number of tabs created on each frame. @findex toggle-frame-tab-bar To toggle the use of the Tab Bar only on the selected frame, type -@kbd{M-x toggle-frame-tab-bar}. This command allows to enable the -display of the Tab Bar on some frames and disable it on others, -regardless of the values of @code{tab-bar-mode} and @code{tab-bar-show}. +@kbd{M-x toggle-frame-tab-bar}. This command facilitates selectively +enabling the Tab Bar on some frames while keeping it disabled on +others, irrespective of the values of @code{tab-bar-mode} and +@code{tab-bar-show}. @kindex C-x t The prefix key @kbd{C-x t} is analogous to @kbd{C-x 5}. diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi index 2785ccb5109..a95335f3df2 100644 --- a/doc/emacs/maintaining.texi +++ b/doc/emacs/maintaining.texi @@ -2658,8 +2658,8 @@ definitions have tag names like @samp{operator+}. If you specify the @samp{--class-qualify} option, tags for variables and functions in classes are named @samp{@var{class}::@var{variable}} and @samp{@var{class}::@var{function}}. By default, class methods and -members are not class-qualified, which allows to identify their names in -the sources more accurately. +members are not class-qualified, which facilitates identifying their +names in the sources more accurately. @item In Java code, tags include all the constructs recognized in C++, plus diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi index 25b897125dd..0057979778f 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi @@ -831,9 +831,9 @@ produced by earlier or later Emacs versions; native compilation of the same Lisp code by a different Emacs version will usually produce a natively-compiled library under a unique file name that only that version of Emacs will be able to load. However, the use of unique -file names allows to have in the same directory several versions of -the same Lisp library natively-compiled by several different versions -of Emacs. +file names enables several versions of the same Lisp library +natively-compiled by several different versions of Emacs to be placed +within the same directory. @vindex no-native-compile A non-@code{nil} file-local variable binding of diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi index baa2a144bac..dc5b9507efc 100644 --- a/doc/lispref/control.texi +++ b/doc/lispref/control.texi @@ -1281,11 +1281,11 @@ fail, @code{pcase} will immediately return @code{nil} without calling @code{message}. Extraction of multiple values stored in an object is known as -@dfn{destructuring}. Using @code{pcase} patterns allows to perform -@dfn{destructuring binding}, which is similar to a local binding -(@pxref{Local Variables}), but gives values to multiple elements of -a variable by extracting those values from an object of compatible -structure. +@dfn{destructuring}. Using @code{pcase} patterns allows you to +perform @dfn{destructuring binding}, which is similar to a local +binding (@pxref{Local Variables}), but gives values to multiple +elements of a variable by extracting those values from an object of +compatible structure. The macros described in this section use @code{pcase} patterns to perform destructuring binding. The condition of the object to be of diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 0b5ca9c0ee2..22a3eeb9595 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -1821,8 +1821,8 @@ where the @var{primary} value is used as described above, and @var{secondary} is the fallback value used when @var{primary} and the nesting considerations fail to resolve the precedence between overlays. In particular, priority value @w{@code{(nil . @var{n})}}, -with @var{n} a positive integer, allows to have the overlays ordered -by priority when necessary without completely overriding other +with @var{n} a positive integer, enables you to have the overlays +ordered by priority when necessary without completely overriding other overlays. Currently, all overlays take priority over text properties. @@ -8731,8 +8731,8 @@ hexadecimal notation. Display a box containing that string. The string should contain at most 6 @acronym{ASCII} characters. As an exception, if the string includes just one character, on text-mode terminals that character -will be displayed without a box; this allows to handle such -``acronyms'' as a replacement character for characters that cannot be +will be displayed without a box; this enables treating such +``acronyms'' as replacement characters for characters that cannot be displayed by the terminal. @item a cons cell @code{(@var{graphical} . @var{text})} diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index 853ca5ae69e..1c4e85b14be 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -1742,7 +1742,7 @@ Geometry}) of the frame, in characters. Normally, the functions that establish a frame's initial width or resize a frame horizontally make sure that all the frame's windows, vertical scroll bars, fringes, margins and vertical dividers can be displayed. This parameter, if -non-@code{nil} allows to make a frame narrower than that with the +non-@code{nil} enables making a frame narrower than that with the consequence that any components that do not fit will be clipped by the window manager. @@ -1753,7 +1753,7 @@ Geometry}) of the frame, in characters. Normally, the functions that establish a frame's initial size or resize a frame make sure that all the frame's windows, horizontal scroll bars and dividers, mode and header lines, the echo area and the internal menu and tool bar can be -displayed. This parameter, if non-@code{nil} allows to make a frame +displayed. This parameter, if non-@code{nil} enables making a frame smaller than that with the consequence that any components that do not fit will be clipped by the window manager. @@ -1814,14 +1814,14 @@ the first time. @vindex fit-frame-to-buffer-margins@r{, a frame parameter} @item fit-frame-to-buffer-margins -This parameter allows to override the value of the option -@code{fit-frame-to-buffer-margins} when fitting this frame to the buffer -of its root window with @code{fit-frame-to-buffer} (@pxref{Resizing -Windows}). +This parameter enables overriding the value of the option +@code{fit-frame-to-buffer-margins} when fitting this frame to the +buffer of its root window with @code{fit-frame-to-buffer} +(@pxref{Resizing Windows}). @vindex fit-frame-to-buffer-sizes@r{, a frame parameter} @item fit-frame-to-buffer-sizes -This parameter allows to override the value of the option +This parameter enables overriding the value of the option @code{fit-frame-to-buffer-sizes} when fitting this frame to the buffer of its root window with @code{fit-frame-to-buffer} (@pxref{Resizing Windows}). @@ -1902,13 +1902,13 @@ to not draw bottom dividers. @vindex menu-bar-lines@r{, a frame parameter} @item menu-bar-lines The number of lines to allocate at the top of the frame for a menu bar -(@pxref{Menu Bar}). The default is one if Menu Bar mode is enabled and -zero otherwise. @xref{Menu Bars,,,emacs, The GNU Emacs Manual}. For an -external menu bar (@pxref{Frame Layout}), this value remains unchanged -even when the menu bar wraps to two or more lines. In that case, the -@code{menu-bar-size} value returned by @code{frame-geometry} -(@pxref{Frame Geometry}) allows to derive whether the menu bar actually -occupies one or more lines. +(@pxref{Menu Bar}). The default is one if Menu Bar mode is enabled +and zero otherwise. @xref{Menu Bars,,,emacs, The GNU Emacs Manual}. +For an external menu bar (@pxref{Frame Layout}), this value remains +unchanged even when the menu bar wraps to two or more lines. In that +case, the @code{menu-bar-size} value returned by @code{frame-geometry} +(@pxref{Frame Geometry}) enables you to establish whether the menu bar +actually occupies one or more lines. @vindex tool-bar-lines@r{, a frame parameter} @item tool-bar-lines @@ -3433,11 +3433,11 @@ parameter indicates the number of pixels where the frame @dfn{snaps} at the respective edge or corner of its parent frame. There are two ways to drag an entire child frame with the mouse: The -@code{drag-with-mode-line} parameter, if non-@code{nil}, allows to drag -a frame without minibuffer window (@pxref{Minibuffer Windows}) via the -mode line area of its bottommost window. The -@code{drag-with-header-line} parameter, if non-@code{nil}, allows to -drag the frame via the header line area of its topmost window. +@code{drag-with-mode-line} parameter, if non-@code{nil}, enables +dragging a frame without minibuffer window (@pxref{Minibuffer +Windows}) via the mode line area of its bottommost window. The +@code{drag-with-header-line} parameter, if non-@code{nil}, enables +dragging the frame via the header line area of its topmost window. 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} diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi index 66191243702..6cdfe1bd1cb 100644 --- a/doc/lispref/minibuf.texi +++ b/doc/lispref/minibuf.texi @@ -2669,7 +2669,7 @@ variable instead (@pxref{Echo Area Customization}). The option @code{resize-mini-windows} does not affect the behavior of minibuffer-only frames (@pxref{Frame Layout}). The following option -allows to automatically resize such frames as well. +enables automatically resizing such frames as well. @defopt resize-mini-frames If this is @code{nil}, minibuffer-only frames are never resized diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi index e055d043c91..cfab2c22d6b 100644 --- a/doc/lispref/processes.texi +++ b/doc/lispref/processes.texi @@ -681,7 +681,7 @@ This function is the basic low-level primitive for starting asynchronous subprocesses. It returns a process object representing the subprocess. Compared to the more high-level @code{start-process}, described below, it takes keyword arguments, is more flexible, and -allows to specify process filters and sentinels in a single call. +enables you to specify process filters and sentinels in a single call. The arguments @var{args} are a list of keyword/argument pairs. Omitting a keyword is always equivalent to specifying it with value diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi index a49e63e49de..659a064a173 100644 --- a/doc/lispref/windows.texi +++ b/doc/lispref/windows.texi @@ -3759,7 +3759,7 @@ preferred way regardless of whether the display is also guided by an @code{display-buffer-alist} differs from customizing @code{display-buffer-base-action} in two major aspects: it is stronger because it overrides the @var{action} argument of -@code{display-buffer}, and it allows to explicitly specify the +@code{display-buffer}, and it enables you to explicitly specify the affected buffers. In fact, displaying other buffers is not affected in any way by a customization for @file{*foo*}. For example, @@ -6150,11 +6150,11 @@ up-to-date. @section Mouse Window Auto-selection @cindex window auto-selection @cindex auto-selection of window -The following option allows to automatically select the window under the -mouse pointer. This accomplishes a policy similar to that of window -managers that give focus to a frame (and thus trigger its subsequent -selection) whenever the mouse pointer enters its window-system window -(@pxref{Input Focus}). +The following option enables automatically selecting the window under +the mouse pointer. This accomplishes a policy similar to that of +window managers that give focus to a frame (and thus trigger its +subsequent selection) whenever the mouse pointer enters its +window-system window (@pxref{Input Focus}). @defopt mouse-autoselect-window If this variable is non-@code{nil}, Emacs will try to automatically diff --git a/doc/misc/autotype.texi b/doc/misc/autotype.texi index 4110b60a774..8617db16ca0 100644 --- a/doc/misc/autotype.texi +++ b/doc/misc/autotype.texi @@ -276,10 +276,10 @@ empty file is visited. This is accomplished by putting @code{auto-insert-alist}. The @sc{car} of each element of this list is either a mode name, making the element applicable when a buffer is in that mode, or a string, which is a regexp matched against a -buffer's file name (the latter allows to distinguish between different -kinds of files that have the same mode in Emacs). The @sc{car} of an -element may also be a cons cell, consisting of mode name or regexp, as -above, and an additional descriptive string. +buffer's file name (the latter enables you to distinguish between +different kinds of files that have the same mode in Emacs). The +@sc{car} of an element may also be a cons cell, consisting of mode +name or regexp, as above, and an additional descriptive string. When a matching element is found, the @sc{cdr} says what to do. It may be a string, which is a file name, whose contents are to be inserted, if diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi index db754a6dd0d..600f4435e62 100644 --- a/doc/misc/efaq.texi +++ b/doc/misc/efaq.texi @@ -1121,8 +1121,8 @@ feature, when you need to insert a single special character. allows selection of one of the previous kills. @item -New minor mode @code{repeat-mode} allows to repeat commands with fewer -keystrokes. +New minor mode @code{repeat-mode} enables repeating commands with +fewer keystrokes. @item Among the many internal changes in this release, we would like to diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi index 10fc4c85c7b..5577105ab2b 100644 --- a/doc/misc/idlwave.texi +++ b/doc/misc/idlwave.texi @@ -3186,7 +3186,7 @@ the expression printed by IDL. @defopt idlwave-shell-output-face The face for @code{idlwave-shell-output-overlay}. -Allows to choose the font, color and other properties for the most +Allows you to choose the font, color and other properties for the most recent output of IDL when examining an expression." @end defopt diff --git a/doc/misc/ses.texi b/doc/misc/ses.texi index f63bffe2a9f..cfca9c25ebb 100644 --- a/doc/misc/ses.texi +++ b/doc/misc/ses.texi @@ -188,7 +188,7 @@ the end-points, e.g.: @emph{list} of values. This allows for more complex possibilities.) Alternatively you can use the @code{!} modifier of @code{ses-range} to -remove blank cells from the returned list, which allows to use +remove blank cells from the returned list, which enables using @code{+} instead of @code{ses+}: @lisp @@ -1007,7 +1007,7 @@ are some useful functions to call from your formulas: @item (ses-delete-blanks &rest @var{args}) Returns a list from which all blank cells (value is either @code{nil} or '*skip*) have been deleted. Order of args is reverted. Please note -that @code{ses-range} has a @code{!} modifier that allows to remove +that @code{ses-range} has a @code{!} modifier that enables removing blanks, so it is possible to write: @lisp (ses-range A1 A5 !) diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index c136cbc294a..78b47f779cf 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -1094,11 +1094,11 @@ decode programs. @cindex method @option{sudoedit} @cindex @option{sudoedit} method -The @option{sudoedit} method allows to edit a file as a different user -on the local host. You could regard this as @value{tramp}'s +The @option{sudoedit} method facilitates editing a file as a different +user on the local host. You could regard this as @value{tramp}'s implementation of the @command{sudoedit}. Contrary to the @option{sudo} method, all magic file name functions are implemented by -single @command{sudo @dots{}} commands. The purpose is to make +single @command{sudo @dots{}} commands. The purpose is to make editing such a file as secure as possible; there must be no session running in the Emacs background which could be attacked from inside Emacs. @@ -1383,7 +1383,7 @@ possible, @value{tramp} emulates those operations otherwise. @cindex @option{rclone} method @vindex tramp-rclone-program -The program @command{rclone} allows to access different system +The program @command{rclone} enables accessing different system storages in the cloud, see @uref{https://rclone.org/} for a list of supported systems. If the @command{rclone} program isn't found in your @env{PATH} environment variable, you can tell @value{tramp} its diff --git a/lisp/comint.el b/lisp/comint.el index 777795bcb46..4c49d27dd52 100644 --- a/lisp/comint.el +++ b/lisp/comint.el @@ -2857,7 +2857,7 @@ text matching `comint-prompt-regexp'." "If non-nil, `comint-insert-previous-argument' counts args from the end. If this variable is nil, the default, `comint-insert-previous-argument' counts the arguments from the beginning; if non-nil, it counts from -the end instead. This allows to emulate the behavior of `ESC-NUM ESC-.' +the end instead. This emulates the behavior of `ESC-NUM ESC-.' in both Bash and zsh: in Bash, `number' counts from the beginning (variable is nil), while in zsh, it counts from the end." :type 'boolean diff --git a/lisp/emacs-lisp/rmc.el b/lisp/emacs-lisp/rmc.el index bfd7434be9a..45e2bbf3831 100644 --- a/lisp/emacs-lisp/rmc.el +++ b/lisp/emacs-lisp/rmc.el @@ -126,7 +126,8 @@ (defun read-multiple-choice (prompt choices &optional help-string show-help long-form) "Ask user to select an entry from CHOICES, prompting with PROMPT. -This function allows to ask the user a multiple-choice question. +This function is used to ask the user a question with multiple +choices. CHOICES should be a list of the form (KEY NAME [DESCRIPTION]). KEY is a character the user should type to select the entry. diff --git a/lisp/gnus/gnus-util.el b/lisp/gnus/gnus-util.el index 4b5bc69894b..1d25d7ac919 100644 --- a/lisp/gnus/gnus-util.el +++ b/lisp/gnus/gnus-util.el @@ -343,10 +343,10 @@ Symbols are also allowed; their print names are used instead." (yes-or-no-p prompt) (message ""))) -;; By Frank Schmitt . Allows to have -;; age-depending date representations. (e.g. just the time if it's -;; from today, the day of the week if it's within the last 7 days and -;; the full date if it's older) +;; By Frank Schmitt . Enables age-dependent +;; date representations. (e.g. just the time if it's from today, the +;; day of the week if it's within the last 7 days and the full date if +;; it's older) (defun gnus-seconds-today () "Return the integer number of seconds passed today." diff --git a/lisp/mail/rmailsum.el b/lisp/mail/rmailsum.el index e3a6c16933b..661bfee4ab3 100644 --- a/lisp/mail/rmailsum.el +++ b/lisp/mail/rmailsum.el @@ -52,7 +52,7 @@ Setting this option to nil might speed up the generation of summaries." (defcustom rmail-summary-progressively-narrow nil "Non-nil means progressively narrow the set of messages produced by summary. -This allows to apply the summary criteria on top one another, +This enables you to apply the summary criteria on top one another, thus progressively narrowing the selection of the messages produced by each summary criteria. For example, applying `rmail-summary-by-senders' on top diff --git a/lisp/mouse.el b/lisp/mouse.el index 11a2db52eec..66308ce6839 100644 --- a/lisp/mouse.el +++ b/lisp/mouse.el @@ -1829,10 +1829,11 @@ The region will be defined with mark and point." map) t (lambda () (funcall cleanup) - ;; Don't deactivate the mark when the context menu was invoked - ;; by down-mouse-3 immediately after down-mouse-1 and without - ;; releasing the mouse button with mouse-1. This allows to use - ;; region-related context menu to operate on the selected region. + ;; Don't deactivate the mark when the context menu was + ;; invoked by down-mouse-3 immediately after + ;; down-mouse-1 and without releasing the mouse button + ;; with mouse-1. This enables region-related context + ;; menu to operate on the selected region. (unless (and context-menu-mode (eq (car-safe (aref (this-command-keys-vector) 0)) 'down-mouse-3)) diff --git a/lisp/net/tramp-sudoedit.el b/lisp/net/tramp-sudoedit.el index 3d6e1d92d0b..c22bfd7ff5c 100644 --- a/lisp/net/tramp-sudoedit.el +++ b/lisp/net/tramp-sudoedit.el @@ -23,7 +23,7 @@ ;;; Commentary: -;; The "sudoedit" Tramp method allows to edit a file as a different +;; The "sudoedit" Tramp method enables editing a file as a different ;; user on the local host. Contrary to the "sudo" method, all magic ;; file name functions are implemented by single "sudo ..." commands. ;; The purpose is to make editing such a file as secure as possible; diff --git a/lisp/obsolete/landmark.el b/lisp/obsolete/landmark.el index 57ca28e6d1d..968b817e9e8 100644 --- a/lisp/obsolete/landmark.el +++ b/lisp/obsolete/landmark.el @@ -549,10 +549,10 @@ along the DX, DY direction, considering that DVAL has been added on SQUARE." ;;; GAME CONTROL. ;;; -;; Several variables are used to monitor a game, including a GAME-HISTORY (the -;; list of all (SQUARE . PREVSCORE) played) that allows to take moves back -;; (anti-updating the score table) and to compute the table from scratch in -;; case of an interruption. +;; Several variables are used to monitor a game, including a +;; GAME-HISTORY (the list of all (SQUARE . PREVSCORE) played) that +;; enables rescinding moves (anti-updating the score table) and to +;; compute the table from scratch in case of an interruption. (defvar landmark-game-in-progress nil "Non-nil if a game is in progress.") diff --git a/lisp/org/org.el b/lisp/org/org.el index 2c15a37e9c1..b18a446e4d4 100644 --- a/lisp/org/org.el +++ b/lisp/org/org.el @@ -1021,7 +1021,7 @@ time." This is useful since some lines containing links can be very long and uninteresting. Also tables look terrible when wrapped. -The variable `org-startup-truncated' allows to configure +The variable `org-startup-truncated' enables you to configure truncation for Org mode different to the other modes that use the variable `truncate-lines' and as a shortcut instead of putting the variable `truncate-lines' into the `org-mode-hook'. If one @@ -1321,14 +1321,15 @@ Possible values for the file identifier are: to open [[file:document.pdf::5]] with evince at page 5. Likely, you will need more entries: without page - number; with search pattern; with cross-reference - anchor; some combination of options. Consider simple - pattern here and a Lisp function to determine command - line arguments instead. Passing argument list to - `call-process' or `make-process' directly allows to - avoid treating some character in peculiar file names - as shell specialls causing executing part of file - name as a subcommand. + number; with search pattern; with + cross-reference anchor; some combination of + options. Consider simple pattern here and a + Lisp function to determine command line + arguments instead. Passing an argument list to + `call-process' or `make-process' directly avoids + treating some character in peculiar file names + as shell specials that prompt parts of said file + names to be executed as subcommands. `directory' Matches a directory `remote' Matches a remote file, accessible through tramp. diff --git a/lisp/pixel-scroll.el b/lisp/pixel-scroll.el index 488f6781254..6ee37d03e87 100644 --- a/lisp/pixel-scroll.el +++ b/lisp/pixel-scroll.el @@ -851,7 +851,7 @@ It is a vector of the form [ VELOCITY TIME SIGN ]." ;;;###autoload (define-minor-mode pixel-scroll-precision-mode "Toggle pixel scrolling. -When enabled, this minor mode allows to scroll the display +When enabled, this minor mode allows you to scroll the display precisely, according to the turning of the mouse wheel." :global t :group 'mouse diff --git a/lisp/progmodes/cperl-mode.el b/lisp/progmodes/cperl-mode.el index 98943ebda3f..37ab900a476 100644 --- a/lisp/progmodes/cperl-mode.el +++ b/lisp/progmodes/cperl-mode.el @@ -746,7 +746,8 @@ voice); s) Allows indentation of //x-style regular expressions; t) Highlights different symbols in regular expressions according to their function; much less problems with backslashitis; - u) Allows to find regular expressions which contain interpolated parts. + u) Allows you to locate regular expressions which contain + interpolated parts. 5) The indentation engine was very smart, but most of tricks may be not needed anymore with the support for `syntax-table' property. Has diff --git a/lisp/simple.el b/lisp/simple.el index f4672b46b10..35dd0f59e29 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -6460,9 +6460,9 @@ If non-nil, the kill ring is rotated after selecting previously killed text." (defun yank-from-kill-ring (string &optional arg) "Select a stretch of previously killed text and insert (\"paste\") it. -This command allows to choose one of the stretches of text killed -or yanked by previous commands, which are recorded in `kill-ring', -and reinsert the chosen kill at point. +This command allows you to select one of the stretches of text +killed or yanked by previous commands, which are recorded in +`kill-ring', and reinsert the chosen kill at point. This command prompts for a previously-killed text in the minibuffer. Use the minibuffer history and search commands, or the minibuffer @@ -8440,7 +8440,7 @@ even beep.)" (and (= (cdr (nth 6 (posn-at-point))) orig-vlnum) ;; Make sure we delete the character where the line wraps ;; under visual-line-mode, be it whitespace or a - ;; character whose category set allows to wrap at it. + ;; character whose category set permits wrapping at it. (or (looking-at-p "[ \t]") (and word-wrap-by-category (aref (char-category-set (following-char)) ?\|))) diff --git a/lisp/window.el b/lisp/window.el index b9b032c33e9..5184b5457ba 100644 --- a/lisp/window.el +++ b/lisp/window.el @@ -4177,8 +4177,8 @@ a non-nil `no-other-window' parameter." "How to choose a frame's selected window after window deletion. When a frame's selected window gets deleted, Emacs has to choose another live window on that frame to serve as its selected -window. This option allows to control which window gets selected -instead. +window. This option controls the window that is selected in such +a situation. The possible choices are `mru' (the default) to select the most recently used window on that frame, and `pos' to choose the diff --git a/src/ChangeLog.11 b/src/ChangeLog.11 index b2b776d491f..bfd4fef4e80 100644 --- a/src/ChangeLog.11 +++ b/src/ChangeLog.11 @@ -6278,7 +6278,7 @@ 2010-07-09 Michael Albinus * dbusbind.c (xd_initialize): Add new argument RAISE_ERROR, which - allows to suppress errors when polling in Emacs' main loop. + allows suppressing errors when polling in Emacs' main loop. (Fdbus_init_bus, Fdbus_get_unique_name, Fdbus_call_method) (Fdbus_call_method_asynchronously, Fdbus_method_return_internal) (Fdbus_method_error_internal, Fdbus_send_signal) diff --git a/src/xdisp.c b/src/xdisp.c index 8970d5aaaf2..a9119788663 100644 --- a/src/xdisp.c +++ b/src/xdisp.c @@ -37814,13 +37814,13 @@ composed on display. */); DEFVAR_INT ("max-redisplay-ticks", max_redisplay_ticks, doc: /* Maximum number of redisplay ticks before aborting redisplay of a window. -This allows to abort the display of a window if the amount of low-level -redisplay operations exceeds the value of this variable. When display of -a window is aborted due to this reason, the buffer shown in that window -will not have its windows redisplayed until the buffer is modified or until -you type \\[recenter-top-bottom] with one of its windows selected. -You can also decide to kill the buffer and visit it in some -other way, like under `so-long-mode' or literally. +This enables aborting the display of a window if the amount of +low-level redisplay operations exceeds the value of this variable. +When display of a window is aborted due to this reason, the buffer +shown in that window will not have its windows redisplayed until the +buffer is modified or until you type \\[recenter-top-bottom] with one +of its windows selected. You can also decide to kill the buffer and +visit it in some other way, like under `so-long-mode' or literally. The default value is zero, which disables this feature. The recommended non-zero value is between 100000 and 1000000, diff --git a/src/xterm.c b/src/xterm.c index d826eec2419..11ccd5ebdb3 100644 --- a/src/xterm.c +++ b/src/xterm.c @@ -20649,8 +20649,8 @@ handle_one_xevent (struct x_display_info *dpyinfo, https://lists.gnu.org/archive/html/emacs-devel/2017-02/msg00133.html. That is fixed above but bites us here again. - The option x_set_frame_visibility_more_laxly allows to override - the default behavior (Bug#49955, Bug#53298). */ + The option x_set_frame_visibility_more_laxly enables + overriding the default behavior (Bug#49955, Bug#53298). */ if (EQ (x_set_frame_visibility_more_laxly, Qfocus_in) || EQ (x_set_frame_visibility_more_laxly, Qt)) #endif /* USE_GTK */ @@ -22091,17 +22091,19 @@ handle_one_xevent (struct x_display_info *dpyinfo, #ifdef USE_GTK /* Some WMs (e.g. Mutter in Gnome Shell), don't unmap - minimized/iconified windows; thus, for those WMs we won't get - a MapNotify when unminimizing/deiconifying. Check here if we - are deiconizing a window (Bug42655). + minimized/iconified windows; thus, for those WMs we + won't get a MapNotify when unminimizing/deiconifying. + Check here if we are deiconizing a window (Bug42655). - But don't do that by default on GTK since it may cause a plain - invisible frame get reported as iconified, compare + But don't do that by default on GTK since it may + cause a plain invisible frame get reported as + iconified, compare https://lists.gnu.org/archive/html/emacs-devel/2017-02/msg00133.html. That is fixed above but bites us here again. - The option x_set_frame_visibility_more_laxly allows to override - the default behavior (Bug#49955, Bug#53298). */ + The option x_set_frame_visibility_more_laxly enables + overriding the default behavior (Bug#49955, + Bug#53298). */ if (EQ (x_set_frame_visibility_more_laxly, Qfocus_in) || EQ (x_set_frame_visibility_more_laxly, Qt)) #endif /* USE_GTK */ -- 2.39.5