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".
This commit is contained in:
Alan Mackenzie 2016-01-24 20:30:39 +00:00
parent fef1b3066a
commit fbce4757a8
56 changed files with 131 additions and 129 deletions

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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}.

View file

@ -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")}.

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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'.
+++

View file

@ -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

View file

@ -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:

View file

@ -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 ()

View file

@ -149,7 +149,7 @@ and will be collected in `semantic-lex' form: (SYMBOL START . END)."
;; Parser plug-ins
;;
;; The following functions permit to plug the Wisent LALR parser in
;; The following functions permit plugging the Wisent LALR parser in
;; Semantic toolkit. They use the standard API provided by Semantic
;; to plug parsers in.
;;

View file

@ -98,7 +98,7 @@ sure to obey the 8.3 limitations."
string))
(aset string i ?_))
;; If we don't have a period in the first 8 chars, insert one.
;; This enables to have 3 more characters from the original
;; This enables having 3 more characters from the original
;; name in the extension.
(if (> (or (string-match "\\." string) (length string))
8)

View file

@ -354,12 +354,12 @@ Properties can be set with
;; Now, what about the filter alist variables? There are three of them,
;; though only two sets of parameters:
;;
;; - `frameset-session-filter-alist' contains these filters that allow to
;; save and restore framesets in-session, without the need to serialize
;; the frameset or save it to disk (for example, to save a frameset in a
;; register and restore it later). Filters in this list do not remove
;; live objects, except in `minibuffer', which is dealt especially by
;; `frameset-save' / `frameset-restore'.
;; - `frameset-session-filter-alist' contains these filters that allow
;; saving and restoring framesets in-session, without the need to
;; serialize the frameset or save it to disk (for example, to save a
;; frameset in a register and restore it later). Filters in this
;; list do not remove live objects, except in `minibuffer', which is
;; dealt especially by `frameset-save' / `frameset-restore'.
;;
;; - `frameset-persistent-filter-alist' is the whole deal. It does all
;; the filtering described above, and the result is ready to be saved on
@ -1072,7 +1072,7 @@ FORCE-ONSCREEN can be:
- a list (LEFT TOP WIDTH HEIGHT), describing the workarea.
It must return non-nil to force the frame onscreen, nil otherwise.
CLEANUP-FRAMES allows to \"clean up\" the frame list after restoring a frameset:
CLEANUP-FRAMES allows \"cleaning up\" the frame list after restoring a frameset:
t Delete all frames that were not created or restored upon.
nil Keep all frames.
FUNC A function called with two arguments:

View file

@ -680,7 +680,7 @@ minor mode in all Gnus buffers."
(defun gnus-agent-queue-setup (&optional group-name)
"Make sure the queue group exists.
Optional arg GROUP-NAME allows to specify another group."
Optional arg GROUP-NAME allows another group to be specified."
(unless (gnus-gethash (format "nndraft:%s" (or group-name "queue"))
gnus-newsrc-hashtb)
(gnus-request-create-group (or group-name "queue") '(nndraft ""))

View file

@ -496,9 +496,9 @@ Unless LIST is given, `mm-codepage-ibm-list' is used."
(windows-1257 . (mm-codepage-setup 1257 t))))
"An alist of (CHARSET . FORM) pairs.
If an article is encoded in an unknown CHARSET, FORM is
evaluated. This allows to load additional libraries providing
charsets on demand. If supported by your Emacs version, you
could use `autoload-coding-system' here."
evaluated. This allows the loading of additional libraries
providing charsets on demand. If supported by your Emacs
version, you could use `autoload-coding-system' here."
:version "22.1" ;; Gnus 5.10.9
:type '(list (set :inline t
(const (windows-1250 . (mm-codepage-setup 1250 t)))

View file

@ -496,7 +496,7 @@ with L, LRE, or LRO Unicode bidi character type.")
table)))
;; Load uni-mirrored.el and uni-brackets.el if available, so that they
;; get dumped into Emacs. This allows to start Emacs with
;; get dumped into Emacs. This allows starting Emacs with
;; force-load-messages in ~/.emacs, and avoid infinite recursion in
;; bidi_initialize, which needs to load uni-mirrored.el and
;; uni-brackets.el in order to display the "Loading" messages.

View file

@ -11632,7 +11632,7 @@ FORCE-ONSCREEN can be:
- a list (LEFT TOP WIDTH HEIGHT), describing the workarea.
It must return non-nil to force the frame onscreen, nil otherwise.
CLEANUP-FRAMES allows to \"clean up\" the frame list after restoring a frameset:
CLEANUP-FRAMES allows \"cleaning up\" the frame list after restoring a frameset:
t Delete all frames that were not created or restored upon.
nil Keep all frames.
FUNC A function called with two arguments:
@ -30613,8 +30613,8 @@ Usage:
according to option `vhdl-argument-list-indent'.
If option `vhdl-indent-tabs-mode' is nil, spaces are used instead of
tabs. `\\[tabify]' and `\\[untabify]' allow to convert spaces to tabs
and vice versa.
tabs. `\\[tabify]' and `\\[untabify]' allow the conversion of spaces to
tabs and vice versa.
Syntax-based indentation can be very slow in large files. Option
`vhdl-indent-syntax-based' allows you to use faster but simpler indentation.

View file

@ -22,7 +22,7 @@
;;; Commentary:
;; This package allows to hand over a buffer to be sent off
;; This package allows handing over a buffer to be sent off
;; via the system's designated e-mail client.
;; Note that the e-mail client will display the contents of the buffer
;; again for editing.

View file

@ -75,7 +75,7 @@
;; ============= TODO ===========
;; - Add a command for printing.
;; - The awk script deletes multiple blank lines. This behavior does
;; not allow to understand if there was indeed a blank line at the
;; not allow one to understand if there was indeed a blank line at the
;; end or beginning of a page (after the header, or before the
;; footer). A different algorithm should be used. It is easy to
;; compute how many blank lines there are before and after the page

View file

@ -1262,7 +1262,7 @@ is used to search."
(forward-line)))
;; All implementations of pick have special options -cc, -date, -from and
;; -subject that allow to search for corresponding components. Any other
;; -subject that allow searching for corresponding components. Any other
;; component is searched using option --COMPNAME, for example: `pick
;; --x-mailer mh-e'. Mailutils "pick" supports this option using a certain
;; kludge, but it prefers the following syntax for this purpose:

View file

@ -209,7 +209,7 @@ Before reproducing the bug, you might apply
M-x tramp-cleanup-all-connections
This allows to investigate from a clean environment. Another
This allows us to investigate from a clean environment. Another
useful thing to do is to put
(setq tramp-verbose 9)

View file

@ -86,7 +86,7 @@
;; Restrictions:
;; * The current GVFS implementation does not allow to write on the
;; * The current GVFS implementation does not allow writing on the
;; remote bluetooth device via OBEX.
;;
;; * Two shares of the same SMB server cannot be mounted in parallel.

View file

@ -225,7 +225,7 @@ See `org-crypt-disable-auto-save'."
;; outline property starts at the \n of the heading.
(delete-region (1- (point)) end)
;; Store a checksum of the decrypted and the encrypted
;; text value. This allow to reuse the same encrypted text
;; text value. This allow reusing the same encrypted text
;; if the text does not change, and therefore avoid a
;; re-encryption process.
(insert "\n" (propertize decrypted-text

View file

@ -367,8 +367,8 @@ still has an entry since one of its properties (`:title') does.")
;; Provide four accessors: `org-element-type', `org-element-property'
;; `org-element-contents' and `org-element-restriction'.
;;
;; Setter functions allow to modify elements by side effect. There is
;; `org-element-put-property', `org-element-set-contents',
;; Setter functions allow modification of elements by side effect.
;; There is `org-element-put-property', `org-element-set-contents',
;; `org-element-set-element' and `org-element-adopt-element'. Note
;; that `org-element-set-element' and `org-element-adopt-elements' are
;; higher level functions since also update `:parent' property.
@ -4023,8 +4023,8 @@ position of point and CDR is nil."
;; `org-element-parse-secondary-string', which parses objects within
;; a given string.
;;
;; The (almost) almighty `org-element-map' allows to apply a function
;; on elements or objects matching some type, and accumulate the
;; The (almost) almighty `org-element-map' allows applying a function
;; on elements or objects matching some type, and accumulating the
;; resulting values. In an export situation, it also skips unneeded
;; parts of the parse tree.

View file

@ -24,7 +24,7 @@
;;
;;; Commentary:
;;
;; This module allows to create and change entries in an Org-mode
;; This module allows entries to be created and changed in an Org-mode
;; file triggered by items in an RSS feed. The basic functionality is
;; geared toward simply adding new items found in a feed as outline nodes
;; to an Org file. Using hooks, arbitrary actions can be triggered for

View file

@ -2254,7 +2254,7 @@ fast, while still showing the whole path to the entry."
:type 'boolean)
(defcustom org-refile-allow-creating-parent-nodes nil
"Non-nil means allow to create new nodes as refile targets.
"Non-nil means allow the creation of new nodes as refile targets.
New nodes are then created by adding \"/new node name\" to the completion
of an existing node. When the value of this variable is `confirm',
new node creation must be confirmed by the user (recommended).

View file

@ -35,10 +35,10 @@
;;; Define Back-End
;;
;; The following setting won't allow to modify preferred charset
;; The following setting won't allow modifying preferred charset
;; through a buffer keyword or an option item, but, since the property
;; will appear in communication channel nonetheless, it allows to
;; override `org-ascii-charset' variable on the fly by the ext-plist
;; will appear in communication channel nonetheless, it allows
;; overriding `org-ascii-charset' variable on the fly by the ext-plist
;; mechanism.
;;
;; We also install a filter for headlines and sections, in order to

View file

@ -76,7 +76,7 @@ for timed events. If non-zero, alarms are created.
(defcustom org-icalendar-exclude-tags nil
"Tags that exclude a tree from export.
This variable allows to specify different exclude tags from other
This variable allows specifying different exclude tags from other
back-ends. It can also be set with the ICAL_EXCLUDE_TAGS
keyword."
:group 'org-export-icalendar

View file

@ -1078,7 +1078,7 @@ publishing directory."
"Return numbering for headline matching FUZZY search in FILE.
Return value is a list of numbers, or nil. This function allows
to resolve external fuzzy links like:
the resolution of external fuzzy links like:
[[file.org::*fuzzy][description]]"
(when org-publish-cache

View file

@ -775,7 +775,7 @@ is nil. You can also allow them through local buffer variables."
(defcustom org-export-snippet-translation-alist nil
"Alist between export snippets back-ends and exporter back-ends.
This variable allows to provide shortcuts for export snippets.
This variable allows providing shortcuts for export snippets.
For example, with a value of \((\"h\" . \"html\")), the
HTML back-end will recognize the contents of \"@@h:<b>@@\" as
@ -849,7 +849,7 @@ output is restricted to body only, \"s\" when it is restricted to
the current subtree, \"v\" when only visible elements are
considered for export, \"f\" when publishing functions should be
passed the FORCE argument and \"a\" when the export should be
asynchronous). Also, [?] allows to switch back to standard
asynchronous). Also, [?] allows switching back to standard
mode."
:group 'org-export-general
:version "24.4"
@ -3657,9 +3657,9 @@ INFO is the plist used as a communication channel."
;; `org-export-get-relative-level' is a shortcut to get headline
;; level, relatively to the lower headline level in the parsed tree.
;;
;; `org-export-get-headline-number' returns the section number of an
;; headline, while `org-export-number-to-roman' allows to convert it
;; to roman numbers.
;; `org-export-get-headline-number' returns the section number of a
;; headline, while `org-export-number-to-roman' allows it to be
;; converted to roman numbers.
;;
;; `org-export-low-level-p', `org-export-first-sibling-p' and
;; `org-export-last-sibling-p' are three useful predicates when it
@ -4093,8 +4093,8 @@ Otherwise, only provided element's type is considered.
Optional argument PREDICATE is a function returning a non-nil
value if the current element or object should be counted in. It
accepts two arguments: the element or object being considered and
the plist used as a communication channel. This allows to count
only a certain type of objects (i.e. inline images).
the plist used as a communication channel. This allows counting
only a certain type of object (i.e. inline images).
Return value is a list of numbers if ELEMENT is a headline or an
item. It is nil for keywords. It represents the footnote number
@ -5458,7 +5458,7 @@ to `:default' encoding. If it fails, return S."
;; returned results in the current process.
;;
;; At a higher level, `org-export-to-buffer' and `org-export-to-file'
;; allow to export to a buffer or a file, asynchronously or not.
;; allow exporting to a buffer or a file, asynchronously or not.
;;
;; `org-export-output-file-name' is an auxiliary function meant to be
;; used with `org-export-to-file'. With a given extension, it tries
@ -5985,7 +5985,7 @@ is nil when this menu hasn't been selected yet.
EXPERTP, when non-nil, triggers expert UI. In that case, no help
buffer is provided, but indications about currently active
options are given in the prompt. Moreover, [?] allows to switch
options are given in the prompt. Moreover, [?] allows switching
back to standard interface."
(let* ((fontify-key
(lambda (key &optional access-key)

View file

@ -379,7 +379,7 @@ static unsigned char gamegrid_bits[] = {
(dotimes (i height)
(insert line))
;; Adjust the height of the default face to the height of the
;; images. Unlike XEmacs, Emacs doesn't allow to make the default
;; images. Unlike XEmacs, Emacs doesn't allow making the default
;; face buffer-local; so we do this with an overlay.
(when (eq gamegrid-display-mode 'glyph)
(overlay-put (make-overlay (point-min) (point-max))

View file

@ -551,7 +551,7 @@ that DVAL has been added on SQUARE."
;;;
;; 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
;; list of all (SQUARE . PREVSCORE) played) that allows you to take moves back
;; (anti-updating the score table) and to compute the table from scratch in
;; case of an interruption.

View file

@ -537,8 +537,8 @@ corresponding kind, i.e., looks like \(OPTION-DEF...).
Each OPTION-DEF looks like \(OPTION-NAME EXTRA-FN VALUE-SPEC...) which
defines a file/grammar/rule/subrule option with name OPTION-NAME. The
OPTION-NAMEs are used for the creation of the \"Insert XXX Option\"
submenus, see `antlr-options-use-submenus', and to allow to insert the
option name with completion when using \\[antlr-insert-option].
submenus, see `antlr-options-use-submenus', and to allow the insersion
of the option name with completion when using \\[antlr-insert-option].
If EXTRA-FN is a function, it is called at different phases of the
insertion with arguments \(PHASE OPTION-NAME). PHASE can have the

View file

@ -2737,7 +2737,7 @@ killed."
(process (get-buffer-process buffer))
;; Users can override the interpreter and args
;; interactively when calling `run-python', let-binding
;; these allows to have the new right values in all
;; these allows having the new right values in all
;; setup code that is done in `inferior-python-mode',
;; which is important, especially for prompt detection.
(python-shell--interpreter interpreter)
@ -3351,7 +3351,7 @@ def __PYTHON_EL_native_completion_setup():
if not completion:
if self.last_completion != '1__dummy_completion__':
# When no more completions are available, returning a
# dummy with non-sharing prefix allow to ensure output
# dummy with non-sharing prefix allow ensuring output
# while preventing changes to current input.
# Coincidentally it's also the end of output.
completion = '1__dummy_completion__'

View file

@ -4422,8 +4422,8 @@ Usage:
according to option `vhdl-argument-list-indent'.
If option `vhdl-indent-tabs-mode' is nil, spaces are used instead of
tabs. `\\[tabify]' and `\\[untabify]' allow to convert spaces to tabs
and vice versa.
tabs. `\\[tabify]' and `\\[untabify]' allow the conversion of spaces to
tabs and vice versa.
Syntax-based indentation can be very slow in large files. Option
`vhdl-indent-syntax-based' allows you to use faster but simpler indentation.

View file

@ -858,7 +858,7 @@ The command will be executed provided one exists for that stroke,
based on the variable `strokes-minimum-match-score'.
If no stroke matches, nothing is done and return value is nil."
;; FIXME: Undocument return value. It is not documented for all cases,
;; and doesn't allow to difference between no stroke matches and
;; and doesn't allow differentiating between no stroke matches and
;; command-execute returning nil, anyway.
(let* ((match (strokes-match-stroke stroke strokes-global-map))
(command (car match))

View file

@ -1979,7 +1979,7 @@ and pass it the output of the last Ispell invocation."
(defun ispell-send-replacement (misspelled replacement)
"Notify Aspell that MISSPELLED should be spelled REPLACEMENT.
This allows to improve the suggestion list based on actual misspellings."
This allows improving the suggestion list based on actual misspellings."
(and ispell-really-aspell
(ispell-send-string (concat "$$ra " misspelled "," replacement "\n"))))

View file

@ -664,7 +664,7 @@ This hook should be local in the buffer setup to display widgets.")
(flags (widget-get tree :tree-widget--guide-flags))
(indent (widget-get tree :indent))
;; Setup widget's image support. Looking up for images, and
;; setting widgets' :tag-glyph is done here, to allow to
;; setting widgets' :tag-glyph is done here, to allow us to
;; dynamically change the image theme.
(widget-image-enable (tree-widget-use-image-p)) ; Emacs
(widget-glyph-enable widget-image-enable) ; XEmacs

View file

@ -58,8 +58,8 @@
;; ******** FIX THE DOCUMENTATION *********
;;
;; - rework the displaying of error messages.
;; - allow to flush messages only
;; - allow to protect files like ChangeLog from flushing
;; - allow the flushing of messages only
;; - allow the protection of files like ChangeLog from flushing
;; - query the user for cvs-get-marked (for some cmds or if nothing's selected)
;; - don't return the first (resp last) FI if the cursor is before
;; (resp after) it.

View file

@ -2005,7 +2005,7 @@ SIDE can be any of the symbols `left', `top', `right' or
;; Predecessors to the below have been devised by Julian Assange in
;; change-windows-intuitively.el and Hovav Shacham in windmove.el.
;; Neither of these allow to selectively ignore specific windows
;; Neither of these allow one to selectively ignore specific windows
;; (windows whose `no-other-window' parameter is non-nil) as targets of
;; the movement.
(defun window-in-direction (direction &optional window ignore sign wrap mini)

View file

@ -2090,7 +2090,7 @@ struct Lisp_Marker
/* For markers that point somewhere,
this is used to chain of all the markers in a given buffer. */
/* We could remove it and use an array in buffer_text instead.
That would also allow to preserve it ordered. */
That would also allow us to preserve it ordered. */
struct Lisp_Marker *next;
/* This is the char position where the marker points. */
ptrdiff_t charpos;

View file

@ -95,7 +95,7 @@ typedef struct _MEMORY_STATUS_EX {
} MEMORY_STATUS_EX,*LPMEMORY_STATUS_EX;
/* These are here so that GDB would know about these data types. This
allows to attach GDB to Emacs when a fatal exception is triggered
allows attaching GDB to Emacs when a fatal exception is triggered
and Windows pops up the "application needs to be closed" dialog.
At that point, _gnu_exception_handler, the top-level exception
handler installed by the MinGW startup code, is somewhere on the

View file

@ -100,8 +100,8 @@ typedef struct _RTL_HEAP_PARAMETERS {
special segment to the executable. In order to be able to do this
without losing too much space, we need to create a Windows heap at
the specific address of the static array. The RtlCreateHeap
available inside the NT kernel since XP will do this. It allows to
create a non-growable heap at a specific address. So before
available inside the NT kernel since XP will do this. It allows the
creation of a non-growable heap at a specific address. So before
dumping, we create a non-growable heap at the address of the
dumped_data[] array. After dumping, we reuse memory allocated
there without being able to free it (but most of it is not meant to

View file

@ -3616,8 +3616,8 @@ w32_set_horizontal_scroll_bar_thumb (struct scroll_bar *bar,
si.fMask = SIF_PAGE | SIF_POS | SIF_RANGE;
si.nMin = 0;
si.nMax = whole;
/* Allow nPage to be one larger than nPos so we don't allow to scroll
an already fully visible buffer. */
/* Allow nPage to be one larger than nPos so we don't allow the scrolling
of an already fully visible buffer. */
si.nPage = min (portion, si.nMax) + 1;
si.nPos = min (position, si.nMax);
SetScrollInfo (w, SB_CTL, &si, TRUE);

View file

@ -7263,7 +7263,7 @@ resizing a window preferably resizes one adjacent window only.
If this variable is t, splitting a window tries to get the space
proportionally from all windows in the same combination. This also
allows to split a window that is otherwise too small or of fixed size.
allows splitting a window that is otherwise too small or of fixed size.
Resizing and deleting a window proportionally resize all windows in the
same combination.

View file

@ -80,7 +80,7 @@ along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
specs overwrite the font-spec in the 14th attribute.
Faces are frame-local by nature because Emacs allows to define the
Faces are frame-local by nature because Emacs allows you to define 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