Commit fbce4757 authored by Alan Mackenzie's avatar Alan Mackenzie
Browse files

Expunge "allow" + infinitive without direct object from source and doc.

Do the same for "permit", "enable", and "prevent".

* doc/emacs/mule.texi:
* doc/lispref/control.texi:
* doc/lispref/display.texi:
* doc/lispref/frames.texi:
* doc/lispref/functions.texi:
* doc/lispref/nonascii.texi:
* doc/lispref/streams.texi:
* doc/lispref/windows.texi:
* doc/misc/dbus.texi:
* doc/misc/eww.texi:
* doc/misc/flymake.texi:
* doc/misc/octave-mode.texi:
* doc/misc/org.texi:
* doc/misc/reftex.texi:
* doc/misc/tramp.texi:
* doc/misc/wisent.texi:
* etc/NEWS:
* lisp/autorevert.el:
* lisp/cedet/mode-local.el:
* lisp/cedet/semantic/senator.el:
* lisp/cedet/semantic/wisent.el:
* lisp/dos-fns.el:
* lisp/frameset.el:
* lisp/gnus/gnus-agent.el:
* lisp/gnus/mm-util.el:
* lisp/international/characters.el:
* lisp/ldefs-boot.el:
* lisp/mail/mailclient.el:
* lisp/man.el:
* lisp/mh-e/mh-search.el:
* lisp/net/tramp-cmds.el:
* lisp/net/tramp-gvfs.el:
* lisp/org/org-crypt.el:
* lisp/org/org-element.el:
* lisp/org/org-feed.el:
* lisp/org/org.el:
* lisp/org/ox-ascii.el:
* lisp/org/ox-icalendar.el:
* lisp/org/ox-publish.el:
* lisp/org/ox.el:
* lisp/play/gamegrid.el:
* lisp/play/gomoku.el:
* lisp/progmodes/antlr-mode.el:
* lisp/progmodes/python.el:
* lisp/progmodes/vhdl-mode.el:
* lisp/strokes.el:
* lisp/textmodes/ispell.el:
* lisp/tree-widget.el:
* lisp/vc/pcvs.el:
* lisp/window.el:
* src/lisp.h:
* src/w32.c:
* src/w32heap.c:
* src/w32term.c:
* src/window.c:
* src/xfaces.c:

Replace solecisms like "This allow to do something" with a correct
alternative, such as "This allow you to do something", "This allows
something to be done" or "This allows the doing of something".
parent fef1b306
......@@ -1216,7 +1216,7 @@ using the internal Emacs representation.
When Emacs runs on MS-Windows versions that are descendants of the
NT family (Windows 2000, XP, Vista, Windows 7, and Windows 8), the
value of @code{file-name-coding-system} is largely ignored, as Emacs
by default uses APIs that allow to pass Unicode file names directly.
by default uses APIs that allow passing Unicode file names directly.
By contrast, on Windows 9X, file names are encoded using
@code{file-name-coding-system}, which should be set to the codepage
(@pxref{Coding Systems, codepage}) pertinent for the current system
......
......@@ -302,8 +302,8 @@ predicate conditions that compare values of expressions against
specific values known and written in advance. However, sometimes it
is useful to select alternatives based on more general conditions that
distinguish between broad classes of values. The @code{pcase} macro
allows to choose between alternatives based on matching the value of
an expression against a series of patterns. A pattern can be a
allows you to choose between alternatives based on matching the value
of an expression against a series of patterns. A pattern can be a
literal value (comparison to literal values is what @code{cond} does),
or it can be a more general description of the expected structure of
the expression's value.
......@@ -350,7 +350,7 @@ when called with the value being matched as its argument.
@var{predfun} can be one of the possible forms described below.
@item (guard @var{boolean-expression})
Matches if @var{boolean-expression} evaluates to non-@code{nil}. This
allows to include in a UPattern boolean conditions that refer to
allows you to include in a UPattern boolean conditions that refer to
symbols bound to values (including the value being matched) by
previous UPatterns. Typically used inside an @code{and} UPattern, see
below. For example, @w{@code{(and x (guard (< x 10)))}} is a pattern
......@@ -358,7 +358,7 @@ which matches any number smaller than 10 and let-binds the variable
@code{x} to that number.
@item (let @var{upattern} @var{expression})
Matches if the specified @var{expression} matches the specified
@var{upattern}. This allows to match a pattern against the value of
@var{upattern}. This allows matching a pattern against the value of
an @emph{arbitrary} expression, not just the expression that is the
first argument to @code{pcase}. (It is called @code{let} because
@var{upattern} can bind symbols to values using the @var{symbol}
......@@ -407,7 +407,7 @@ Here's an illustrative example of using UPatterns:
(code (message "Unknown return code %S" code)))
@end example
The QPatterns are more powerful. They allow to match the value of the
The QPatterns are more powerful. They allow matching the value of the
@var{expression} that is the first argument of @code{pcase} against
specifications of its @emph{structure}. For example, you can specify
that the value must be a list of 2 elements whose first element is a
......
......@@ -4303,7 +4303,7 @@ divider ends above the bottom divider.
Dividers can be dragged with the mouse and are therefore useful for
adjusting the sizes of adjacent windows with the mouse. They also serve
to visually set apart adjacent windows when no scroll bars or mode lines
are present. The following three faces allow to customize the
are present. The following three faces allow the customization of the
appearance of dividers:
@table @code
......
......@@ -2403,8 +2403,8 @@ The resulting mouse position is not constrained to the native frame of
The return value is not significant.
@end defun
On a graphical terminal the following two functions allow to retrieve
and set the absolute position of the mouse cursor.
On a graphical terminal the following two functions allow the absolute
position of the mouse cursor to be retrieved and set.
@defun mouse-absolute-pixel-position
This function returns a cons cell (@var{x} . @var{y}) of the coordinates
......@@ -2426,7 +2426,7 @@ This predicate function returns non-@code{nil} if the mouse pointer
displayed on @var{frame} is visible; otherwise it returns @code{nil}.
@var{frame} omitted or @code{nil} means the selected frame. This is
useful when @code{make-pointer-invisible} is set to @code{t}: it
allows to know if the pointer has been hidden.
allows you to know if the pointer has been hidden.
@xref{Mouse Avoidance,,,emacs, The Emacs Manual}.
@end defun
......
......@@ -1248,7 +1248,7 @@ Parent type: @code{array}.
@item font-object
@end table
The optional @var{qualifier} allows to combine several applicable
The optional @var{qualifier} allows combining several applicable
methods. If it is not present, the defined method is a @dfn{primary}
method, responsible for providing the primary implementation of the
generic function for the specialized arguments. You can also define
......@@ -1270,8 +1270,8 @@ The most specific of such methods will be run before any other method.
Such methods normally use @code{cl-call-next-method}, described below,
to invoke the other auxiliary or primary methods.
@item :extra @var{string}
This allows to add more methods, distinguished by @var{string}, for
the same specializers and qualifiers.
This allows you to add more methods, distinguished by @var{string},
for the same specializers and qualifiers.
@end table
@end defmac
......
......@@ -1338,9 +1338,9 @@ operates on the contents of @var{string} instead of bytes in the buffer.
@cindex null bytes, and decoding text
@defvar inhibit-null-byte-detection
If this variable has a non-@code{nil} value, null bytes are ignored
when detecting the encoding of a region or a string. This allows to
correctly detect the encoding of text that contains null bytes, such
as Info files with Index nodes.
when detecting the encoding of a region or a string. This allows the
encoding of text that contains null bytes to be correctly detected,
such as Info files with Index nodes.
@end defvar
@defvar inhibit-iso-escape-detection
......
......@@ -343,10 +343,10 @@ shared structures. @xref{Circular Objects}. Its default value is
When reading or writing from the standard input/output streams of the
Emacs process in batch mode, it is sometimes required to make sure any
arbitrary binary data will be read/written verbatim, and/or that no
translation of newlines to or from CR-LF pairs are performed. This
translation of newlines to or from CR-LF pairs is performed. This
issue does not exist on Posix hosts, only on MS-Windows and MS-DOS@.
The following function allows to control the I/O mode of any standard
stream of the Emacs process.
The following function allows you to control the I/O mode of any
standard stream of the Emacs process.
@defun set-binary-mode stream mode
Switch @var{stream} into binary or text I/O mode. If @var{mode} is
......
......@@ -383,8 +383,8 @@ as if @var{mini} were @code{nil}.
If it doesn't find a suitable window, this function returns @code{nil}.
@end defun
The following function allows to retrieve the entire window tree of a
frame:
The following function allows the entire window tree of a frame to be
retrieved:
@defun window-tree &optional frame
This function returns a list representing the window tree for frame
......@@ -1476,7 +1476,7 @@ displaying a buffer only temporarily (@pxref{Temporary Displays}), and
you want to continue working with the initial layout.
The behavior can be fixed by making a new parent window when splitting
@var{W2}. The variable described next allows to do that.
@var{W2}. The variable described next allows that to be done.
@defopt window-combination-limit
This variable controls whether splitting a window shall make a new
......@@ -1579,7 +1579,7 @@ combination limit of @var{W4} (the parent window of @var{W6} and
Alternatively, the problems sketched above can be avoided by always
resizing all windows in the same combination whenever one of its windows
is split or deleted. This also permits to split windows that would be
is split or deleted. This also permits spliting windows that would be
otherwise too small for such an operation.
@defopt window-combination-resize
......@@ -2522,11 +2522,11 @@ windows are dedicated to another buffer (@pxref{Dedicated Windows}).
@defun display-buffer-no-window buffer alist
If @var{alist} has a non-@code{nil} @code{allow-no-window} entry, then
this function does not display @code{buffer}. This allows to override
the default action and avoid displaying the buffer. It is assumed that
when the caller specifies a non-@code{nil} @code{allow-no-window} value
it can handle a @code{nil} value returned from @code{display-buffer} in
this case.
this function does not display @code{buffer}. This allows you to
override the default action and avoid displaying the buffer. It is
assumed that when the caller specifies a non-@code{nil}
@code{allow-no-window} value it can handle a @code{nil} value returned
from @code{display-buffer} in this case.
@end defun
To illustrate the use of action functions, consider the following
......
......@@ -138,8 +138,8 @@ name could be @samp{org.gnu.Emacs.TextEditor} or
@section D-Bus version.
D-Bus has evolved over the years. New features have been added with
new D-Bus versions. There are two variables, which allow to determine
the used D-Bus version.
new D-Bus versions. There are two variables, which allow the determination
of the D-Bus version used.
@defvar dbus-compiled-version
This variable, a string, determines the version of D-Bus Emacs is
......
......@@ -162,8 +162,8 @@ You can view stored bookmarks with @kbd{B}
@kindex S
@cindex Multiple Buffers
To get summary of currently opened EWW buffers, press @kbd{S}
(@code{eww-list-buffers}). The @file{*eww buffers*} buffer allows to
quickly kill, flip through and switch to specific EWW buffer.
(@code{eww-list-buffers}). The @file{*eww buffers*} buffer allows you
to quickly kill, flip through and switch to specific EWW buffer.
@findex eww-browse-with-external-browser
@vindex shr-external-browser
......
......@@ -717,7 +717,7 @@ sort error menu items, which shows error messages first.
Flymake is also able to interpret error message patterns missing err-text-idx
information. This is done by merely taking the rest of the matched line
(@code{(substring line (match-end 0))}) as error text. This trick allows
to make use of a huge collection of error message line patterns from
making use of a huge collection of error message line patterns from
@code{compile.el}. All these error patterns are appended to
the end of @code{flymake-err-line-patterns}.
......
......@@ -436,7 +436,7 @@ when Octave is waiting for input, or done sending output.
@c You can use either 'plain' Emacs Info or the function @code{octave-help}
@c as your Octave info reader (for @samp{help -i}). In the former case,
@c use @code{info_program ("info-emacs-info")}.
@c The latter is perhaps more attractive because it allows to look up keys
@c The latter is perhaps more attractive because it allows you to look up keys
@c in the indices of @emph{several} info files related to Octave (provided
@c that the Emacs variable @code{octave-help-files} is set correctly). In
@c this case, use @code{info_program ("info-emacs-octave-help")}.
......
......@@ -12890,9 +12890,9 @@ including DocBook.}.
When processing a document, @samp{texinfo} back-end generates a minimal file
header along with a title page, a copyright page, and a menu. You control
the latter through the structure of the document (@pxref{Headings and
sectioning structure}). Various keywords allow to tweak the other parts. It
is also possible to give directions to install the document in the @samp{Top}
node.
sectioning structure}). Various keywords allow you to tweak the other parts.
It is also possible to give directions to install the document in the
@samp{Top} node.
 
@subsubheading File header
 
......
......@@ -5421,8 +5421,8 @@ after words. Disabled indexing in comment lines.
New command @code{reftex-create-bibtex-file} to create a new database
with all entries referenced in the current document.
@item
New keys @kbd{e} and @kbd{E} allow to produce a BibTeX database file
from entries marked in a citation selection buffer.
New keys @kbd{e} and @kbd{E} allow you to produce a BibTeX database
file from entries marked in a citation selection buffer.
@end itemize
@noindent @b{Version 4.21}
......@@ -5610,8 +5610,8 @@ demand.
@item
Index support, along with many new options.
@item
The selection of keys for @code{\ref} and @code{\cite} now allows to
select multiple items by marking entries with the @kbd{m} key.
The selection of keys for @code{\ref} and @code{\cite} now allows you
to select multiple items by marking entries with the @kbd{m} key.
@item
Fancyref support.
@end itemize
......
......@@ -915,8 +915,9 @@ can still access remote files using UNC file names instead of @value{tramp}:
//melancholia/daniel$$/.emacs
@end example
UNC file name specification does not allow to specify a different user
name for authentication like the @command{smbclient} can.
UNC file name specification does not allow the specification of a
different user name for authentication like the @command{smbclient}
can.
@item @option{adb}
......@@ -2990,7 +2991,7 @@ longer open. That is why @value{tramp} prompts for the password again
even if there is an @command{ssh} already open.
Some @command{ssh} versions support a @code{ControlPersist} option,
which allows to set the @code{ControlPath} provided the variable
which allows you to set the @code{ControlPath} provided the variable
@code{tramp-ssh-controlmaster-options} is customized as follows:
@lisp
......
......@@ -1155,8 +1155,8 @@ It defaults to the start symbol defined in the grammar
@end table
@end defun
The following two normal hooks permit to do some useful processing
respectively before to start parsing, and after the parser terminated.
The following two normal hooks permit doing some useful processing
respectively before starting parsing, and after the parser terminated.
@vindex wisent-pre-parse-hook
@defvar wisent-pre-parse-hook
......
......@@ -87,7 +87,7 @@ and silent rules are now quieter. To get the old behavior where
build with 'make V=1'.
---
** The configure option '--with-gameuser' now allows to specify a
** The configure option '--with-gameuser' now allows you to specify a
group instead of a user if its argument is prefixed by ':' (a colon).
This will cause the game score files in ${localstatedir}/games/emacs
to be owned by that group, and the helper program for updating them to
......@@ -200,9 +200,9 @@ select-enable-primary is ineffective since the system doesn't
have the equivalent of a primary selection.
+++
** New option `switch-to-buffer-in-dedicated-window' allows to customize
how `switch-to-buffer' proceeds interactively when the selected window
is strongly dedicated to its buffer.
** New option `switch-to-buffer-in-dedicated-window' allows you to
customize how `switch-to-buffer' proceeds interactively when the
selected window is strongly dedicated to its buffer.
+++
** The option `even-window-heights' has been renamed to
......@@ -855,11 +855,12 @@ plist will contain a :peer element that has the output of
** Tramp
+++
*** New connection method "afp", which allows to access Mac OS X
*** New connection method "afp", which allows you to access Mac OS X
volumes via the Apple Filing Protocol.
+++
*** New connection method "nc", which allows to access dumb busyboxes.
*** New connection method "nc", which allows you to access dumb
busyboxes.
+++
*** Method-specific parameters can be overwritten now with variable
......@@ -1220,7 +1221,7 @@ node "Generic Functions" in the Emacs Lisp manual for more details.
let-bind the values stored in an alist.
---
** `tildify-mode' allows to automatically insert hard spaces as one
** `tildify-mode' allows automatic insertion of hard spaces as one
types the text. Breaking line after a single-character words is
forbidden by Czech and Polish typography (and may be discouraged in
other languages), so `auto-tildify-mode' makes it easier to create
......@@ -1424,7 +1425,7 @@ commands other than the predefined `C-u'.
+++
** New functions `filepos-to-bufferpos' and `bufferpos-to-filepos'.
These allow to convert between buffer positions and the corresponding
These allow conversion between buffer positions and the corresponding
file byte offsets, given the file's encoding.
+++
......@@ -1547,14 +1548,14 @@ called interactively.
** New function `function-put' to use instead of `put' for function properties.
+++
** The new function `bidi-find-overridden-directionality' allows to
** The new function `bidi-find-overridden-directionality' allows you to
find characters whose directionality was, perhaps maliciously,
overridden by directional override control characters. Lisp programs
can use this to detect potential phishing of URLs and other links that
exploits bidirectional display reordering.
+++
** The new function `buffer-substring-with-bidi-context' allows to
** The new function `buffer-substring-with-bidi-context' allows you to
copy a portion of a buffer into a different location while preserving
the visual appearance both of the copied text and the text at
destination, even when the copied text includes mixed bidirectional
......@@ -1677,7 +1678,7 @@ undocumented integer-pair format. Instead, they return a list of two
integers.
+++
** New function `set-binary-mode' allows to switch a standard stream
** New function `set-binary-mode' allows switching a standard stream
of the Emacs process to binary I/O mode.
+++
......@@ -1788,8 +1789,8 @@ fullwidth frames, the behavior may depend on the toolkit used.
number of columns or lines it displays.
+++
*** New function `window-preserve-size' allows to preserve the size of
windows without "fixing" it. It's supported by `fit-window-to-buffer',
*** New function `window-preserve-size' allows you to preserve the size of
a window without "fixing" it. It's supported by `fit-window-to-buffer',
`temp-buffer-resize-mode' and `display-buffer'.
+++
......
......@@ -664,8 +664,8 @@ This is an internal function used by Auto-Revert Mode."
(not (eq revert 'fast)))
(message "Reverting buffer `%s'." (buffer-name)))
;; If point (or a window point) is at the end of the buffer, we
;; want to keep it at the end after reverting. This allows to
;; tail a file.
;; want to keep it at the end after reverting. This allows one
;; to tail a file.
(when buffer-file-name
(setq eob (eobp))
(walk-windows
......
......@@ -189,7 +189,7 @@ BINDINGS is a list of (VARIABLE . VALUE).
Optional argument PLIST is a property list each VARIABLE symbol will
be set to. The following properties have special meaning:
- `constant-flag' if non-nil, prevent to rebind variables.
- `constant-flag' if non-nil, prevent rebinding variables.
- `mode-variable-flag' if non-nil, define mode variables.
- `override-flag' if non-nil, define override functions.
......@@ -544,7 +544,7 @@ default is to call the function `NAME-default' with the appropriate
arguments.
BODY can also include an override form that specifies which part of
BODY is specifically overridden. This permits to specify common code
BODY is specifically overridden. This permits specifying common code
run for both default and overridden implementations.
An override form is one of:
......
......@@ -803,7 +803,7 @@ if available."
(setq isearch-adjusted t)
(isearch-update))
;; Recent versions of GNU Emacs allow to override the isearch search
;; Recent versions of GNU Emacs allow overriding the isearch search
;; function for special needs, and avoid to advice the built-in search
;; function :-)
(defun senator-isearch-search-fun ()
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment