[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Grammar checking
|
From: |
Ihor Radchenko |
|
Subject: |
Re: Grammar checking |
|
Date: |
Fri, 31 Mar 2023 14:24:20 +0000 |
Eli Zaretskii <eliz@gnu.org> writes:
> About 25% success rate. But CONTRIBUTE sees a lot of review, so it
> isn't surprising that most of the reports are false positives. It is
> better to try some document out there written by a non-native English
> speaker, like README.md of some package.
I just tried https://elpa.gnu.org/packages/doc/compat.html
The attached are full report and the report that I cleaned up a bit,
removing false positives related to texinfo format not being understood.
Also, I noticed that checking time is actually much faster compared to
what I am getting with Elisp package:
Time: 2994ms for 1271 sentences (424.5 sentences/sec)
real 0m4.078s
user 0m21.279s
sys 0m0.501s
So, the slowness I was talking about might have something to do with
https://github.com/mhayashi1120/Emacs-langtool implementation.
9.) Line 130, column 64, Rule ID: ALL_OF_THE[1]
Message: Consider using “all the”.
Suggestion: all the
...t is installed on a recent version of Emacs, all of the definitions are
disabled at compile time, su...
^^^^^^^^^^
11.) Line 151, column 9, Rule ID: SENT_START_CONJUNCTIVE_LINKING_ADVERB_COMMA[1]
Message: A comma may be missing after the conjunctive/linking adverb ‘However’.
Suggestion: However,
... can be called directly without this macro. However in the case where
Compat provides an alterna...
^^^^^^^
More info: https://writing.wisc.edu/handbook/grammarpunct/conjadv/
13.) Line 167, column 34, Rule ID: MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE[1]
Message: A comma is probably missing here.
Suggestion: now,
...f compat.el could be added to the core. For now it is necessary to
replicate the definition ...
^^^
More info: http://englishplus.com/grammar/00000074.htm
15.) Line 217, column 40, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...think should belong here, a @ref{Development, , report} would be much
appreciated. @itemize...
^^
16.) Line 217, column 40, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...think should belong here, a @ref{Development, , report} would be much
appreciated. @itemize...
^^
24.) Line 359, column 1, Rule ID: SENT_START_CONJUNCTIVE_LINKING_ADVERB_COMMA[1]
Message: A comma may be missing after the conjunctive/linking adverb
‘Typically’.
Suggestion: Typically,
...per the value of @code{text-quoting-style}. Typically grave accent and
apostrophe in the format tr...
^^^^^^^^^
More info: https://writing.wisc.edu/handbook/grammarpunct/conjadv/
26.) Line 442, column 30, Rule ID:
SENT_START_CONJUNCTIVE_LINKING_ADVERB_COMMA[1]
Message: A comma may be missing after the conjunctive/linking adverb
‘Otherwise’.
Suggestion: Otherwise,
... case where all @var{bindings} are non-nil. Otherwise @var{bindings} are
interpreted just as they ...
^^^^^^^^^
More info: https://writing.wisc.edu/handbook/grammarpunct/conjadv/
27.) Line 455, column 27, Rule ID: EN_A_VS_AN prio=-1
Message: Use “a” instead of ‘an’ if the following word doesn’t start with a
vowel sound, e.g. ‘a sentence’, ‘a university’.
Suggestion: a
...ssor. Elements of @var{forms} can either be an list of an atom. For
example, consider the ...
^^
28.) Line 457, column 47, Rule ID: COMMA_COMPOUND_SENTENCE[1] prio=-1
Message: Use a comma before ‘and’ if it connects two independent clauses
(unless they are closely connected and short).
Suggestion: , and
...or example, consider the threading expression and it's equivalent macro
expansion: @example (...
^^^^
More info:
https://www.grammar-monster.com/lessons/commas_before_conjunctions.htm
30.) Line 473, column 29, Rule ID: AFFECT_EFFECT[16]
Message: Did you mean “side effect” (=adverse effect, unintended consequence)?
Open compounds are not hyphenated.
Suggestion: side effect
...ad-first} is not restricted to arithmetic or side-effect free code. @end
defmac @defmac thread-last ...
^^^^^^^^^^^
More info: https://www.merriam-webster.com/dictionary/side%20effect
31.) Line 479, column 27, Rule ID: EN_A_VS_AN prio=-1
Message: Use “a” instead of ‘an’ if the following word doesn’t start with a
vowel sound, e.g. ‘a sentence’, ‘a university’.
Suggestion: a
...ssor. Elements of @var{forms} can either be an list of an atom. For
example, consider the ...
^^
32.) Line 481, column 47, Rule ID: COMMA_COMPOUND_SENTENCE[1] prio=-1
Message: Use a comma before ‘and’ if it connects two independent clauses
(unless they are closely connected and short).
Suggestion: , and
...or example, consider the threading expression and it's equivalent macro
expansion: @example (...
^^^^
More info:
https://www.grammar-monster.com/lessons/commas_before_conjunctions.htm
34.) Line 497, column 29, Rule ID: AFFECT_EFFECT[16]
Message: Did you mean “side effect” (=adverse effect, unintended consequence)?
Open compounds are not hyphenated.
Suggestion: side effect
...ead-last} is not restricted to arithmetic or side-effect free code. @end
defmac @c copied from lispr...
^^^^^^^^^^^
More info: https://www.merriam-webster.com/dictionary/side%20effect
36.) Line 506, column 26, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ill not expand it. @xref{Expansion,Expansion,,elisp}. @end defun @c based
on lisp/emacs-li...
^^
39.) Line 534, column 6, Rule ID: AGREEMENT_SENT_START[2] prio=-1
Message: Consider using the singular form after the singular determiner “This”.
Suggestion: function
...s a list, it is modified destructively. This functions returns the sorted
@var{sequence} and compar...
^^^^^^^^^
44.) Line 645, column 20, Rule ID: UPPERCASE_SENTENCE_START
Message: This sentence does not start with an uppercase letter.
Suggestion: Perform
... ?n "skip to the next") ("all" ?! "perform for the rest without
more questions") ...
^^^^^^^
46.) Line 841, column 45, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
... See @ref{Reading One Event,Reading One Event,,elisp,}. @end defun @defun
image-property De...
^^
48.) Line 847, column 36, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...ge.el}. This function can also be used as a generalised variable. @end
defun @defun file-attribute-...
^^^^^^^^^^^
49.) Line 978, column 43, Rule ID: LARGE_NUMBER_OF[1]
Message: Specify a number, remove phrase, or simply use “many” or “numerous”
Suggestion: many; numerous
...cs jobs. Additional added characters permit a large number of distinct
names even in one Emacs job. @end d...
^^^^^^^^^^^^^^^^^
52.) Line 1025, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
... @var{testfn}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
53.) Line 1025, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun compat...
^^^^^^^^^^^^
54.) Line 1026, column 10, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @defun
compat-call@ strin...
^^
64.) Line 1305, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
65.) Line 1305, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
67.) Line 1311, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
68.) Line 1311, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
70.) Line 1317, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
71.) Line 1317, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
98.) Line 1524, column 54, Rule ID: COMMA_COMPOUND_SENTENCE_2[1] prio=-1
Message: Use a comma before ‘so’ if it connects two independent clauses (unless
they are closely connected and short).
Suggestion: , so
...ction scrolls the text in the selected window so that point is displayed at
a specified verti...
^^^
99.) Line 1577, column 30, Rule ID: THIS_NNS[2]
Message: The demonstrative ‘this’ may not agree with the plural noun
‘functions’. Did you mean “these”?
Suggestion: these
...ions,,,elisp}. The compatibility version of this functions handles the case
where @var{string...
^^^^
100.) Line 1584, column 24, Rule ID: EN_COMPOUNDS prio=2
Message: This word is normally spelled with a hyphen.
Suggestion: human-readable
...nal flavor space unit Return a string with a human readable representation
of @var{file-size}. The opti...
^^^^^^^^^^^^^^
105.) Line 1604, column 30, Rule ID: BY_DEFAULT_COMMA[1]
Message: Did you mean: “By default,”?
Suggestion: By default,
...ment @var{unit} determines the unit to use. By default it will be an empty
string, unless @var{flav...
^^^^^^^^^^
106.) Line 1604, column 33, Rule ID: MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE[1]
Message: A comma is probably missing here.
Suggestion: default,
...t @var{unit} determines the unit to use. By default it will be an empty
string, unless @var{flav...
^^^^^^^
More info: http://englishplus.com/grammar/00000074.htm
107.) Line 1762, column 1, Rule ID: ADMIT_ENJOY_VB[1]
Message: The verb ‘Suggest’ is used with the gerund form.
Suggestion: Suggest running
.../alloc.c @defun garbage-collect-maybe factor Suggest to run garbage
collection, if @emph{enough} data ha...
^^^^^^^^^^^^^^
More info:
https://www.ef.com/english-resources/english-grammar/gerund-equals-infinitive/
114.) Line 1980, column 21, Rule ID: COMMA_COMPOUND_SENTENCE[1] prio=-1
Message: Use a comma before ‘and’ if it connects two independent clauses
(unless they are closely connected and short).
Suggestion: , and
...en @var{directory} is an accessible directory and it does not contain any
files, i.e., is an e...
^^^^
More info:
https://www.grammar-monster.com/lessons/commas_before_conjunctions.htm
116.) Line 1995, column 59, Rule ID: EN_UNPAIRED_BRACKETS prio=-1
Message: Unpaired symbol: ‘)’ seems to be missing
...er-default-prompt-format} is a format string (defaulting to @samp{" (default
%s)"} that say...
^
119.) Line 2089, column 32, Rule ID: EN_A_VS_AN prio=-1
Message: Use “an” instead of ‘a’ if the following word starts with a vowel
sound, e.g. ‘an article’, ‘an hour’.
Suggestion: an
...of @var{red}, @var{green} and @code{blue} is a integer value between 0 and
65535. The spec...
^
133.) Line 2493, column 1, Rule ID: ENGLISH_WORD_REPEAT_BEGINNING_RULE prio=-50
Message: Three successive sentences begin with the same word. Consider
rewording the sentence or use a thesaurus to find a synonym.
...ode{nil}, it should be a string or a buffer. If @code{nil}, this defaults to
the current buf...
^^
135.) Line 2539, column 45, Rule ID: COMMA_COMPOUND_SENTENCE_2[3] prio=-1
Message: Use a comma before ‘but’ if it connects two independent clauses
(unless they are closely connected and short).
Suggestion: , but
... that is not in the form of ELisp source code but something like machine
code or byte code ins...
^^^^
139.) Line 2627, column 58, Rule ID: BY_DEFAULT_COMMA[1]
Message: Did you mean: “By default,”?
Suggestion: By default,
...ion}, as defined for @code{buffer-match-p}. By default all buffers are
considered, but this can be ...
^^^^^^^^^^
140.) Line 2733, column 13, Rule ID: EN_COMPOUNDS prio=2
Message: This word is normally spelled as one.
Suggestion: keystrokes
... A key is a string consisting of one or more key strokes. The key strokes
are separated by single sp...
^^^^^^^^^^^
141.) Line 2733, column 31, Rule ID: EN_COMPOUNDS prio=2
Message: This word is normally spelled as one.
Suggestion: keystrokes
... consisting of one or more key strokes. The key strokes are separated by
single space characters. E...
^^^^^^^^^^^
142.) Line 2736, column 6, Rule ID: EN_COMPOUNDS prio=2
Message: This word is normally spelled as one.
Suggestion: keystroke
... separated by single space characters. Each key stroke is either a single
character, or the name of...
^^^^^^^^^^
143.) Line 2737, column 56, Rule ID: EN_COMPOUNDS prio=2
Message: This word is normally spelled as one.
Suggestion: keystroke
...rounded by angle brackets. In addition, any key stroke may be preceded by
one or more modifier keys...
^^^^^^^^^^
148.) Line 2913, column 9, Rule ID: LARGE_NUMBER_OF[1]
Message: Specify a number, remove phrase, or simply use “many” or “numerous”
Suggestion: many; numerous
... modes, however, you frequently have to bind a large number of keys at once,
and using @code{keymap-set} on...
^^^^^^^^^^^^^^^^^
149.) Line 2914, column 43, Rule ID:
SENT_START_CONJUNCTIVE_LINKING_ADVERB_COMMA[1]
Message: A comma may be missing after the conjunctive/linking adverb ‘Instead’.
Suggestion: Instead,
...on them all can be tedious and error-prone. Instead you can use
@code{define-keymap}, which crea...
^^^^^^^
More info: https://writing.wisc.edu/handbook/grammarpunct/conjadv/
151.) Line 2951, column 48, Rule ID: EN_UNPAIRED_BRACKETS prio=-1
Message: Unpaired symbol: ‘)’ seems to be missing
...ode{make-keymap}) instead of a sparse keymap (as from
@code{make-sparse-keymap} (@pxref{Cre...
^
154.) Line 3080, column 39, Rule ID: ENGLISH_WORD_REPEAT_RULE prio=-1
Message: Possible typo: you repeated a word
Suggestion: variable
...uments to the macro being written, so @code{(variable variable)} may be
abbreviated to just @code{variable}...
^^^^^^^^^^^^^^^^^
155.) Line 3086, column 1, Rule ID: EN_UNPAIRED_BRACKETS prio=-1
Message: Unpaired symbol: ‘)’ seems to be missing
... For example, consider this macro: @example (defmacro my-list (x y &rest
forms) (let ((x...
^
172.) Line 3167, column 41, Rule ID: EN_UNPAIRED_BRACKETS prio=-1
Message: Unpaired symbol: ‘)’ seems to be missing
...-key This function is like @code{keymap-set} (@pxref{Changing Key
Bindings,,,elisp}, but un...
^
173.) Line 3279, column 52, Rule ID: EN_A_VS_AN prio=-1
Message: Use “an” instead of ‘a’ if the following word starts with a vowel
sound, e.g. ‘an article’, ‘an hour’.
Suggestion: an
...tions or performance issues. We also provide a
@uref{https://lists.sr.ht/~pkal/compat-devel...
^
Time: 3395ms for 1271 sentences (374.4 sentences/sec)
1.) Line 1, column 14, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
\input texinfo @c -*- texinfo -*- @c %**start of header @set...
^^^^
2.) Line 28, column 21, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...category Emacs @direntry * Compat: (compat). Compatibility Library for
Emacs Lisp. @end di...
^^^^
3.) Line 72, column 15, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...ge:: * Limitations:: Support * Emacs 25.1::
Compatibility support for Emacs 25.1 * Emacs ...
^^^^^^^^^^^^^^^^^^^
4.) Line 73, column 15, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...ibility support for Emacs 25.1 * Emacs 26.1::
Compatibility support for Emacs 26.1 * Emacs ...
^^^^^^^^^^^^^^^^^^^
5.) Line 74, column 15, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...ibility support for Emacs 26.1 * Emacs 27.1::
Compatibility support for Emacs 27.1 * Emacs ...
^^^^^^^^^^^^^^^^^^^
6.) Line 75, column 15, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...ibility support for Emacs 27.1 * Emacs 28.1::
Compatibility support for Emacs 28.1 * Emacs ...
^^^^^^^^^^^^^^^^^^^
7.) Line 76, column 15, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...ibility support for Emacs 28.1 * Emacs 29.1::
Compatibility support for Emacs 29.1 @end de...
^^^^^^^^^^^^^^^^^^^
8.) Line 122, column 1, Rule ID: UPPERCASE_SENTENCE_START
Message: This sentence does not start with an uppercase letter.
Suggestion: Should
... a @example (require 'compat) @end example should be added early on. In
packages which are par...
^^^^^^
9.) Line 130, column 64, Rule ID: ALL_OF_THE[1]
Message: Consider using “all the”.
Suggestion: all the
...t is installed on a recent version of Emacs, all of the definitions are
disabled at compile time, su...
^^^^^^^^^^
10.) Line 145, column 17, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...fn) ;; Call extended `assoc' (mapcan fun seq) ;; Call
newly added `mapcan' @end example @d...
^^^^^^^^^^^^^^^^^^^^^
11.) Line 151, column 9, Rule ID: SENT_START_CONJUNCTIVE_LINKING_ADVERB_COMMA[1]
Message: A comma may be missing after the conjunctive/linking adverb ‘However’.
Suggestion: However,
... can be called directly without this macro. However in the case where
Compat provides an alterna...
^^^^^^^
More info: https://writing.wisc.edu/handbook/grammarpunct/conjadv/
12.) Line 166, column 68, Rule ID: LC_AFTER_PERIOD[1]
Message: If a new sentence starts here, add a space and start with an uppercase
letter.
Suggestion: El; el
.... Alternatively a minimal version of compat.el could be added to the core.
For now it is n...
^^
13.) Line 167, column 34, Rule ID: MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE[1]
Message: A comma is probably missing here.
Suggestion: now,
...f compat.el could be added to the core. For now it is necessary to
replicate the definition ...
^^^
More info: http://englishplus.com/grammar/00000074.htm
14.) Line 191, column 36, Rule ID: EN_A_VS_AN prio=-1
Message: Use “an” instead of ‘a’ if the following word starts with a vowel
sound, e.g. ‘an article’, ‘an hour’.
Suggestion: an
... relevant changes are made. We also provide a
@uref{https://lists.sr.ht/~pkal/compat-devel...
^
15.) Line 217, column 40, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...think should belong here, a @ref{Development, , report} would be much
appreciated. @itemize...
^^
16.) Line 217, column 40, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...think should belong here, a @ref{Development, , report} would be much
appreciated. @itemize...
^^
17.) Line 298, column 15, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...for each Emacs version. @menu * Emacs 25.1::
Compatibility support for Emacs 25.1 * Emacs ...
^^^^^^^^^^^^^^^^^^^
18.) Line 299, column 15, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...ibility support for Emacs 25.1 * Emacs 26.1::
Compatibility support for Emacs 26.1 * Emacs ...
^^^^^^^^^^^^^^^^^^^
19.) Line 300, column 15, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...ibility support for Emacs 26.1 * Emacs 27.1::
Compatibility support for Emacs 27.1 * Emacs ...
^^^^^^^^^^^^^^^^^^^
20.) Line 301, column 15, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...ibility support for Emacs 27.1 * Emacs 28.1::
Compatibility support for Emacs 28.1 * Emacs ...
^^^^^^^^^^^^^^^^^^^
21.) Line 302, column 15, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...ibility support for Emacs 28.1 * Emacs 29.1::
Compatibility support for Emacs 29.1 @end men...
^^^^^^^^^^^^^^^^^^^
22.) Line 334, column 36, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space before the full stop.
Suggestion: .
...e or more cons cells of the form @code{(start . end)}. It will have more
than one cons cell...
^^
23.) Line 334, column 39, Rule ID: UPPERCASE_SENTENCE_START
Message: This sentence does not start with an uppercase letter.
Suggestion: End
...r more cons cells of the form @code{(start . end)}. It will have more than
one cons cell whe...
^^^
24.) Line 359, column 1, Rule ID: SENT_START_CONJUNCTIVE_LINKING_ADVERB_COMMA[1]
Message: A comma may be missing after the conjunctive/linking adverb
‘Typically’.
Suggestion: Typically,
...per the value of @code{text-quoting-style}. Typically grave accent and
apostrophe in the format tr...
^^^^^^^^^
More info: https://writing.wisc.edu/handbook/grammarpunct/conjadv/
25.) Line 402, column 20, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space before the full stop.
Suggestion: .
...nds the first association @w{@code{(@var{key} . @var{value})}} by comparing
@var{key} with @...
^^
26.) Line 442, column 30, Rule ID:
SENT_START_CONJUNCTIVE_LINKING_ADVERB_COMMA[1]
Message: A comma may be missing after the conjunctive/linking adverb
‘Otherwise’.
Suggestion: Otherwise,
... case where all @var{bindings} are non-nil. Otherwise @var{bindings} are
interpreted just as they ...
^^^^^^^^^
More info: https://writing.wisc.edu/handbook/grammarpunct/conjadv/
27.) Line 455, column 27, Rule ID: EN_A_VS_AN prio=-1
Message: Use “a” instead of ‘an’ if the following word doesn’t start with a
vowel sound, e.g. ‘a sentence’, ‘a university’.
Suggestion: a
...ssor. Elements of @var{forms} can either be an list of an atom. For
example, consider the ...
^^
28.) Line 457, column 47, Rule ID: COMMA_COMPOUND_SENTENCE[1] prio=-1
Message: Use a comma before ‘and’ if it connects two independent clauses
(unless they are closely connected and short).
Suggestion: , and
...or example, consider the threading expression and it's equivalent macro
expansion: @example (...
^^^^
More info:
https://www.grammar-monster.com/lessons/commas_before_conjunctions.htm
29.) Line 465, column 3, Rule ID: DASH_RULE[2]
Message: Consider using an m-dash if you do not want to join two words.
Suggestion: —
...xample (thread-first 5 (+ 20) (/ 25) - (+ 40)) @equiv{} (+ (- (/
(+ 5 20) 25)) 40...
^
More info: https://en.wikipedia.org/wiki/Dash#Em_dash
30.) Line 473, column 29, Rule ID: AFFECT_EFFECT[16]
Message: Did you mean “side effect” (=adverse effect, unintended consequence)?
Open compounds are not hyphenated.
Suggestion: side effect
...ad-first} is not restricted to arithmetic or side-effect free code. @end
defmac @defmac thread-last ...
^^^^^^^^^^^
More info: https://www.merriam-webster.com/dictionary/side%20effect
31.) Line 479, column 27, Rule ID: EN_A_VS_AN prio=-1
Message: Use “a” instead of ‘an’ if the following word doesn’t start with a
vowel sound, e.g. ‘a sentence’, ‘a university’.
Suggestion: a
...ssor. Elements of @var{forms} can either be an list of an atom. For
example, consider the ...
^^
32.) Line 481, column 47, Rule ID: COMMA_COMPOUND_SENTENCE[1] prio=-1
Message: Use a comma before ‘and’ if it connects two independent clauses
(unless they are closely connected and short).
Suggestion: , and
...or example, consider the threading expression and it's equivalent macro
expansion: @example (...
^^^^
More info:
https://www.grammar-monster.com/lessons/commas_before_conjunctions.htm
33.) Line 489, column 3, Rule ID: DASH_RULE[2]
Message: Consider using an m-dash if you do not want to join two words.
Suggestion: —
...xample (thread-first 5 (+ 20) (/ 25) - (+ 40)) @equiv{} (+ 40 (-
(/ 25 (+ 20 5)))...
^
More info: https://en.wikipedia.org/wiki/Dash#Em_dash
34.) Line 497, column 29, Rule ID: AFFECT_EFFECT[16]
Message: Did you mean “side effect” (=adverse effect, unintended consequence)?
Open compounds are not hyphenated.
Suggestion: side effect
...ead-last} is not restricted to arithmetic or side-effect free code. @end
defmac @c copied from lispr...
^^^^^^^^^^^
More info: https://www.merriam-webster.com/dictionary/side%20effect
35.) Line 506, column 16, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Expansion
...xpand-1} will not expand it. @xref{Expansion,Expansion,,elisp}. @end defun
@c based on lisp/emacs-...
^^^^^^^^^^
36.) Line 506, column 26, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ill not expand it. @xref{Expansion,Expansion,,elisp}. @end defun @c based
on lisp/emacs-li...
^^
37.) Line 516, column 53, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space before the full stop.
Suggestion: .
... function @var{body} into @code{(declarations . exps)}. @end defun @defun
bool-vector &rest...
^^
38.) Line 516, column 56, Rule ID: UPPERCASE_SENTENCE_START
Message: This sentence does not start with an uppercase letter.
Suggestion: Exps
...nction @var{body} into @code{(declarations . exps)}. @end defun @defun
bool-vector &rest obje...
^^^^
39.) Line 534, column 6, Rule ID: AGREEMENT_SENT_START[2] prio=-1
Message: Consider using the singular form after the singular determiner “This”.
Suggestion: function
...s a list, it is modified destructively. This functions returns the sorted
@var{sequence} and compar...
^^^^^^^^^
40.) Line 642, column 21, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space on both sides of a quote symbol.
Suggestion:
... ((read-answer-short t)) (read-answer "Foo " '(("yes" ?y "perform
the action") ...
^^
41.) Line 643, column 14, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...short t)) (read-answer "Foo " '(("yes" ?y "perform the action")
("no" ?n "s...
^^
42.) Line 644, column 13, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
...("yes" ?y "perform the action") ("no" ?n "skip to the next")
("all" ?! "per...
^^^
43.) Line 645, column 14, Rule ID: WHITESPACE_RULE
Message: Possible typo: you repeated a whitespace
Suggestion:
... ("no" ?n "skip to the next") ("all" ?! "perform for the rest
without more questio...
^^
44.) Line 645, column 20, Rule ID: UPPERCASE_SENTENCE_START
Message: This sentence does not start with an uppercase letter.
Suggestion: Perform
... ?n "skip to the next") ("all" ?! "perform for the rest without
more questions") ...
^^^^^^^
45.) Line 841, column 27, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Reading
...quests more help. See @ref{Reading One Event,Reading One Event,,elisp,}.
@end defun @defun image...
^^^^^^^^
46.) Line 841, column 45, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
... See @ref{Reading One Event,Reading One Event,,elisp,}. @end defun @defun
image-property De...
^^
47.) Line 841, column 52, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , }
...ef{Reading One Event,Reading One Event,,elisp,}. @end defun @defun
image-property Defined i...
^^
48.) Line 847, column 36, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...ge.el}. This function can also be used as a generalised variable. @end
defun @defun file-attribute-...
^^^^^^^^^^^
49.) Line 978, column 43, Rule ID: LARGE_NUMBER_OF[1]
Message: Specify a number, remove phrase, or simply use “many” or “numerous”
Suggestion: many; numerous
...cs jobs. Additional added characters permit a large number of distinct
names even in one Emacs job. @end d...
^^^^^^^^^^^^^^^^^
50.) Line 1015, column 65, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space before the full stop.
Suggestion: .
...nds the first association @w{@code{(@var{key} . @var{value})}} by comparing
@var{key} with @...
^^
51.) Line 1022, column 32, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , }
...o @code{eq}. @xref{Association Lists,,,elisp,}. The compatibility version
handles the opti...
^^
52.) Line 1025, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
... @var{testfn}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
53.) Line 1025, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun compat...
^^^^^^^^^^^^
54.) Line 1026, column 10, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @defun
compat-call@ strin...
^^
55.) Line 1031, column 32, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space after the opening parenthesis.
Suggestion: [
...@var{string}. @var{regexp} defaults to @samp{[ \t\n\r]+}. @xref{Creating
Strings,,,elisp}. ...
^^
56.) Line 1040, column 32, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space after the opening parenthesis.
Suggestion: [
...@var{string}. @var{regexp} defaults to @samp{[ \t\n\r]+}. @xref{Creating
Strings,,,elisp}. ...
^^
57.) Line 1050, column 10, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space after the opening parenthesis.
Suggestion: [
...@var{string}. Both regexps default to @samp{[ \t\n\r]+}. @xref{Creating
Strings,,,elisp}. ...
^^
58.) Line 1097, column 11, Rule ID: FILE_EXTENSIONS_CASE[1]
Message: File types are normally capitalized.
Suggestion: SVG
...@code{string-version-lessp}. @item The @code{svg} library. @item The
@code{xdg} library. @end...
^^^
59.) Line 1140, column 59, Rule ID: EN_UNPAIRED_BRACKETS prio=-1
Message: Unpaired symbol: ‘"’ seems to be missing
...as current when the minibuffer was activated." @end defun @c based on
lisp/minibuffer.el @...
^
60.) Line 1166, column 9, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
...its argument is a large integer, and returns @code{t} if so, @code{nil}
otherwise. Unlike small ...
^^^^^^^
61.) Line 1173, column 9, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
...its argument is a small integer, and returns @code{t} if so, @code{nil}
otherwise. Small integer...
^^^^^^^
62.) Line 1203, column 21, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space before the full stop.
Suggestion: .
...lt{} 3 @end group @group (proper-list-p '(a b . c)) @result{} nil @end group
@end example @...
^^
63.) Line 1277, column 21, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space before the full stop.
Suggestion: .
...in @var{tree}. @example (flatten-tree '(1 (2 . 3) nil (4 5 (6)) 7))
@result{}(1 2 3 4 5 6 7...
^^
64.) Line 1305, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
65.) Line 1305, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
66.) Line 1306, column 10, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @defun
decoded-time-minut...
^^
67.) Line 1311, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
68.) Line 1311, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
69.) Line 1312, column 10, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @defun
decoded-time-hour ...
^^
70.) Line 1317, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
71.) Line 1317, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
72.) Line 1318, column 10, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @defun
decoded-time-day t...
^^
73.) Line 1323, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
74.) Line 1323, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
75.) Line 1324, column 10, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @defun
decoded-time-month...
^^
76.) Line 1329, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
77.) Line 1329, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
78.) Line 1330, column 10, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @defun
decoded-time-year ...
^^
79.) Line 1335, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
80.) Line 1335, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
81.) Line 1336, column 10, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @defun
decoded-time-weekd...
^^
82.) Line 1341, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
83.) Line 1341, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
84.) Line 1342, column 10, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @defun
decoded-time-dst t...
^^
85.) Line 1348, column 6, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
86.) Line 1348, column 26, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @defun decode...
^^^^^^^^^^^^
87.) Line 1348, column 48, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @defun
decoded-time-zone ...
^^
88.) Line 1353, column 31, Rule ID: EN_WORD_COHERENCY
Message: Do not mix variants of the same word (‘generalise’ and ‘generalize’)
within a single text.
Suggestion: generalized
...rd @var{time}. It can also be used as a @ref{generalised
variable,Generalized Variables,,elisp}. @end...
^^^^^^^^^^^
89.) Line 1353, column 51, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Generalized
...n also be used as a @ref{generalised variable,Generalized Variables,,elisp}.
@end defun @c copied fro...
^^^^^^^^^^^^
90.) Line 1354, column 10, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ef{generalised variable,Generalized Variables,,elisp}. @end defun @c copied
from lisp/emacs...
^^
91.) Line 1364, column 14, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
....texi @defun time-equal-p t1 t2 This returns @code{t} if the two time values
@var{t1} and @var{t2...
^^^^^^^
92.) Line 1392, column 38, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...tory}). @xref{Locating Files, executable-find,,elisp}, for the details of
this search. @cind...
^^
93.) Line 1439, column 31, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
... is returned. @var{predicate} can either be @code{t} (which is a synonym
for @code{equal}), @cod...
^^^^^^^
94.) Line 1482, column 43, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space on both sides of a quote symbol.
Suggestion:
...ch will result in the list @samp{("This is a " "and here's " "and this is
the end")} (only r...
^^
95.) Line 1482, column 57, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space on both sides of a quote symbol.
Suggestion:
... in the list @samp{("This is a " "and here's " "and this is the end")} (only
reversed, since...
^^
96.) Line 1486, column 56, Rule ID: ENGLISH_WORD_REPEAT_RULE prio=-1
Message: Possible typo: you repeated a word
Suggestion: nil
...tq match (text-property-search-forward 'face nil nil)) (push
(buffer-substring (prop-match-begi...
^^^^^^^
97.) Line 1501, column 59, Rule ID: ENGLISH_WORD_REPEAT_RULE prio=-1
Message: Possible typo: you repeated a word
Suggestion: nil
...match (text-property-search-forward 'shr-url nil nil)) (push
(prop-match-value match) urls)) @e...
^^^^^^^
98.) Line 1524, column 54, Rule ID: COMMA_COMPOUND_SENTENCE_2[1] prio=-1
Message: Use a comma before ‘so’ if it connects two independent clauses (unless
they are closely connected and short).
Suggestion: , so
...ction scrolls the text in the selected window so that point is displayed at
a specified verti...
^^^
99.) Line 1577, column 30, Rule ID: THIS_NNS[2]
Message: The demonstrative ‘this’ may not agree with the plural noun
‘functions’. Did you mean “these”?
Suggestion: these
...ions,,,elisp}. The compatibility version of this functions handles the case
where @var{string...
^^^^
100.) Line 1584, column 24, Rule ID: EN_COMPOUNDS prio=2
Message: This word is normally spelled with a hyphen.
Suggestion: human-readable
...nal flavor space unit Return a string with a human readable representation
of @var{file-size}. The opti...
^^^^^^^^^^^^^^
101.) Line 1592, column 11, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{M’ is not standard English. Did you mean “@code’M”
(curly apostrophe) or “@code'M” (straight apostrophe)?
Suggestion: @code’M; @code'M
...ytes and the produced suffixes are @code{k}, @code{M}, @code{G}, @code{T},
etc. @item @code{iec},...
^^^^^^^
102.) Line 1592, column 31, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{T’ is not standard English. Did you mean “@code’T”
(curly apostrophe) or “@code'T” (straight apostrophe)?
Suggestion: @code’T; @code'T
...d suffixes are @code{k}, @code{M}, @code{G}, @code{T}, etc. @item
@code{iec}, each kilobyte is 10...
^^^^^^^
103.) Line 1598, column 24, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{M’ is not standard English. Did you mean “@code’M”
(curly apostrophe) or “@code'M” (straight apostrophe)?
Suggestion: @code’M; @code'M
...ytes and the produced suffixes are @code{k}, @code{M}, @code{G}, @code{T},
etc. @end itemize The...
^^^^^^^
104.) Line 1598, column 44, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{T’ is not standard English. Did you mean “@code’T”
(curly apostrophe) or “@code'T” (straight apostrophe)?
Suggestion: @code’T; @code'T
...d suffixes are @code{k}, @code{M}, @code{G}, @code{T}, etc. @end itemize
The compatibility versi...
^^^^^^^
105.) Line 1604, column 30, Rule ID: BY_DEFAULT_COMMA[1]
Message: Did you mean: “By default,”?
Suggestion: By default,
...ment @var{unit} determines the unit to use. By default it will be an empty
string, unless @var{flav...
^^^^^^^^^^
106.) Line 1604, column 33, Rule ID: MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE[1]
Message: A comma is probably missing here.
Suggestion: default,
...t @var{unit} determines the unit to use. By default it will be an empty
string, unless @var{flav...
^^^^^^^
More info: http://englishplus.com/grammar/00000074.htm
107.) Line 1762, column 1, Rule ID: ADMIT_ENJOY_VB[1]
Message: The verb ‘Suggest’ is used with the gerund form.
Suggestion: Suggest running
.../alloc.c @defun garbage-collect-maybe factor Suggest to run garbage
collection, if @emph{enough} data ha...
^^^^^^^^^^^^^^
More info:
https://www.ef.com/english-resources/english-grammar/gerund-equals-infinitive/
108.) Line 1780, column 55, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
...tion ignores any @var{arguments} and returns @code{t}. @xref{Calling
Functions,,,elisp}. @end de...
^^^^^^^
109.) Line 1816, column 31, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space after the opening parenthesis.
Suggestion: [
...int. @example (replace-regexp-in-region "foo[ \t]+bar" "foobar") @end
example @xref{Search ...
^^
110.) Line 1824, column 46, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘string}s’ is not standard English. Did you mean “string’s”
(curly apostrophe) or “string's” (straight apostrophe)?
Suggestion: string’s; string's
...but searches for, and replaces, literal @var{string}s instead of regular
expressions. @xref{Searc...
^^^^^^^^
111.) Line 1974, column 27, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , File
... non-@code{nil}). @xref{File Name Components,File Name Components,,elisp}.
@end defun @c copi...
^^^^^
112.) Line 1974, column 48, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ref{File Name Components,File Name Components,,elisp}. @end defun @c copied
from lispref/fi...
^^
113.) Line 1979, column 31, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
...ty-p directory This utility function returns @code{t} if given
@var{directory} is an accessible d...
^^^^^^^
114.) Line 1980, column 21, Rule ID: COMMA_COMPOUND_SENTENCE[1] prio=-1
Message: Use a comma before ‘and’ if it connects two independent clauses
(unless they are closely connected and short).
Suggestion: , and
...en @var{directory} is an accessible directory and it does not contain any
files, i.e., is an e...
^^^^
More info:
https://www.grammar-monster.com/lessons/commas_before_conjunctions.htm
115.) Line 1981, column 53, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive dots
Suggestion: .; …
...irectory. It will ignore @samp{.} and @samp{..} on systems that return them
as files in a d...
^^
116.) Line 1995, column 59, Rule ID: EN_UNPAIRED_BRACKETS prio=-1
Message: Unpaired symbol: ‘)’ seems to be missing
...er-default-prompt-format} is a format string (defaulting to @samp{" (default
%s)"} that say...
^
117.) Line 2074, column 25, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , System
..." nil t)) @end lisp @xref{System Environment,System Environment,,elisp}.
@end defmac @c based o...
^^^^^^^
118.) Line 2074, column 44, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
... @xref{System Environment,System Environment,,elisp}. @end defmac @c based
on lisp/faces.e...
^^
119.) Line 2089, column 32, Rule ID: EN_A_VS_AN prio=-1
Message: Use “an” instead of ‘a’ if the following word starts with a vowel
sound, e.g. ‘an article’, ‘an hour’.
Suggestion: an
...of @var{red}, @var{green} and @code{blue} is a integer value between 0 and
65535. The spec...
^
120.) Line 2107, column 21, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Changing
...uivalent symbolic form. @xref{Changing Files,Changing Files,,elisp}. @end
defun @c copied from li...
^^^^^^^^^
121.) Line 2107, column 36, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ic form. @xref{Changing Files,Changing Files,,elisp}. @end defun @c copied
from lispref/ba...
^^
122.) Line 2135, column 8, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
...ubr.el @defun subr-primitive-p object Return @code{t} if @var{object} is a
primitive, built-in fu...
^^^^^^^
123.) Line 2144, column 8, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
....el @defun subr-native-elisp-p object Return @code{t} if @var{object} if the
object is native com...
^^^^^^^
124.) Line 2326, column 8, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
...br.el @defun list-of-strings-p object Return @code{t} if @var{object} is
@code{nil} or a list of ...
^^^^^^^
125.) Line 2342, column 39, Rule ID: ENGLISH_WORD_REPEAT_RULE prio=-1
Message: Possible typo: you repeated a word
Suggestion: label
...s.texi @defspec with-restriction start end [:label label] body This special
form saves the current bo...
^^^^^^^^^^^
126.) Line 2388, column 32, Rule ID: ENGLISH_WORD_REPEAT_RULE prio=-1
Message: Possible typo: you repeated a word
Suggestion: label
...ositions.texi @defspec without-restriction [:label label] body This special
form saves the current bo...
^^^^^^^^^^^
127.) Line 2471, column 29, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Examining
...t-text-property} (@pxref{Examining Properties,Examining
Properties,,elisp,}), but works on the @code...
^^^^^^^^^^
128.) Line 2471, column 50, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ref{Examining Properties,Examining Properties,,elisp,}), but works on the
@code{display} pro...
^^
129.) Line 2471, column 57, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , }
...mining Properties,Examining Properties,,elisp,}), but works on the
@code{display} property o...
^^
130.) Line 2482, column 11, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , Examining
...y}, for instance (@pxref{Examining Properties,Examining
Properties,,elisp,}). @end defun @c copied ...
^^^^^^^^^^
131.) Line 2483, column 11, Rule ID: DOUBLE_PUNCTUATION
Message: Two consecutive commas
Suggestion: ,
...ref{Examining Properties,Examining Properties,,elisp,}). @end defun @c
copied from lisp/sub...
^^
132.) Line 2483, column 18, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , }
...mining Properties,Examining Properties,,elisp,}). @end defun @c copied from
lisp/subr-x.el ...
^^
133.) Line 2493, column 1, Rule ID: ENGLISH_WORD_REPEAT_BEGINNING_RULE prio=-50
Message: Three successive sentences begin with the same word. Consider
rewording the sentence or use a thesaurus to find a synonym.
...ode{nil}, it should be a string or a buffer. If @code{nil}, this defaults to
the current buf...
^^
134.) Line 2538, column 23, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
...iled-function-p object This function returns @code{t} if @var{object} is a
function object that i...
^^^^^^^
135.) Line 2539, column 45, Rule ID: COMMA_COMPOUND_SENTENCE_2[3] prio=-1
Message: Use a comma before ‘but’ if it connects two independent clauses
(unless they are closely connected and short).
Suggestion: , but
... that is not in the form of ELisp source code but something like machine
code or byte code ins...
^^^^
136.) Line 2541, column 1, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
...e code instead. More specifically it returns @code{t} if the function is
built-in, or byte-compil...
^^^^^^^
137.) Line 2566, column 1, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
...{char-equal} when @code{case-fold-search} is @code{t}. @xref{Text
Comparison,,,elisp}. @end defu...
^^^^^^^
138.) Line 2596, column 30, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Don’t put a space before the full stop.
Suggestion: .
...omitted). @item A cons-cell @code{(@var{oper} . @var{expr})} where
@var{oper} is one of @tab...
^^
139.) Line 2627, column 58, Rule ID: BY_DEFAULT_COMMA[1]
Message: Did you mean: “By default,”?
Suggestion: By default,
...ion}, as defined for @code{buffer-match-p}. By default all buffers are
considered, but this can be ...
^^^^^^^^^^
140.) Line 2733, column 13, Rule ID: EN_COMPOUNDS prio=2
Message: This word is normally spelled as one.
Suggestion: keystrokes
... A key is a string consisting of one or more key strokes. The key strokes
are separated by single sp...
^^^^^^^^^^^
141.) Line 2733, column 31, Rule ID: EN_COMPOUNDS prio=2
Message: This word is normally spelled as one.
Suggestion: keystrokes
... consisting of one or more key strokes. The key strokes are separated by
single space characters. E...
^^^^^^^^^^^
142.) Line 2736, column 6, Rule ID: EN_COMPOUNDS prio=2
Message: This word is normally spelled as one.
Suggestion: keystroke
... separated by single space characters. Each key stroke is either a single
character, or the name of...
^^^^^^^^^^
143.) Line 2737, column 56, Rule ID: EN_COMPOUNDS prio=2
Message: This word is normally spelled as one.
Suggestion: keystroke
...rounded by angle brackets. In addition, any key stroke may be preceded by
one or more modifier keys...
^^^^^^^^^^
144.) Line 2747, column 34, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@kbd{S’ is not standard English. Did you mean “@kbd’S”
(curly apostrophe) or “@kbd'S” (straight apostrophe)?
Suggestion: @kbd’S; @kbd'S
...@item S o m A three key sequence of the keys @kbd{S}, @kbd{o} and @kbd{m}.
@item C-c o A two key...
^^^^^^
145.) Line 2747, column 55, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@kbd{m’ is not standard English. Did you mean “@kbd’m”
(curly apostrophe) or “@kbd'm” (straight apostrophe)?
Suggestion: @kbd’m; @kbd'm
...ey sequence of the keys @kbd{S}, @kbd{o} and @kbd{m}. @item C-c o A two key
sequence of the keys...
^^^^^^
146.) Line 2772, column 23, Rule ID: ENGLISH_WORD_REPEAT_RULE prio=-1
Message: Possible typo: you repeated a word
Suggestion: C-c
...y sequences. Examples include @kbd{f}, @kbd{C-c C-c}, @kbd{H-<left>},
@kbd{M-RET} or @kbd{C-M-<r...
^^^^^^^
147.) Line 2850, column 21, Rule ID: ENGLISH_WORD_REPEAT_RULE prio=-1
Message: Possible typo: you repeated a word
Suggestion: C-l
...{} nil @end group @group (keymap-global-set "C-l C-l" 'redraw-display)
@result{} nil @end gro...
^^^^^^^
148.) Line 2913, column 9, Rule ID: LARGE_NUMBER_OF[1]
Message: Specify a number, remove phrase, or simply use “many” or “numerous”
Suggestion: many; numerous
... modes, however, you frequently have to bind a large number of keys at once,
and using @code{keymap-set} on...
^^^^^^^^^^^^^^^^^
149.) Line 2914, column 43, Rule ID:
SENT_START_CONJUNCTIVE_LINKING_ADVERB_COMMA[1]
Message: A comma may be missing after the conjunctive/linking adverb ‘Instead’.
Suggestion: Instead,
...on them all can be tedious and error-prone. Instead you can use
@code{define-keymap}, which crea...
^^^^^^^
More info: https://writing.wisc.edu/handbook/grammarpunct/conjadv/
150.) Line 2922, column 4, Rule ID: ENGLISH_WORD_REPEAT_RULE prio=-1
Message: Possible typo: you repeated a word
Suggestion: C-c
... "n" #'forward-line "f" #'previous-line "C-c C-c" #'quit-window) @end
lisp This function cre...
^^^^^^^
151.) Line 2951, column 48, Rule ID: EN_UNPAIRED_BRACKETS prio=-1
Message: Unpaired symbol: ‘)’ seems to be missing
...ode{make-keymap}) instead of a sparse keymap (as from
@code{make-sparse-keymap} (@pxref{Cre...
^
152.) Line 3049, column 13, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , bar
... (quux (gensym "quux"))) `(let ((,bar (+ @dots{})))
@dots{}))) (defmacro m...
^^^^
153.) Line 3054, column 13, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , bar
... (cl-with-gensyms (bar baz quux) `(let ((,bar (+ @dots{})))
@dots{}))) @end example...
^^^^
154.) Line 3080, column 39, Rule ID: ENGLISH_WORD_REPEAT_RULE prio=-1
Message: Possible typo: you repeated a word
Suggestion: variable
...uments to the macro being written, so @code{(variable variable)} may be
abbreviated to just @code{variable}...
^^^^^^^^^^^^^^^^^
155.) Line 3086, column 1, Rule ID: EN_UNPAIRED_BRACKETS prio=-1
Message: Unpaired symbol: ‘)’ seems to be missing
... For example, consider this macro: @example (defmacro my-list (x y &rest
forms) (let ((x...
^
156.) Line 3089, column 13, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , x-result
...m)) (y-result (gensym))) `(let ((,x-result ,x)
(,y-result ,y)) (list ...
^^^^^^^^^
157.) Line 3089, column 23, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , x
... (y-result (gensym))) `(let ((,x-result ,x) (,y-result ,y))
(list ,x-...
^^
158.) Line 3090, column 13, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , y-result
...sym))) `(let ((,x-result ,x) (,y-result ,y)) (list
,x-result ,y-result ,x-res...
^^^^^^^^^
159.) Line 3090, column 23, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma.
Suggestion: , y
... `(let ((,x-result ,x) (,y-result ,y)) (list ,x-result
,y-result ,x-result...
^^
160.) Line 3091, column 13, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...t ,x) (,y-result ,y)) (list ,x-result ,y-result ,x-result
,y-result ...
^^
161.) Line 3091, column 23, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
... (,y-result ,y)) (list ,x-result ,y-result ,x-result ,y-result
(pr...
^^
162.) Line 3091, column 33, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...-result ,y)) (list ,x-result ,y-result ,x-result ,y-result
(progn ,@@for...
^^
163.) Line 3091, column 43, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...)) (list ,x-result ,y-result ,x-result ,y-result (progn
,@@forms)))) @en...
^^
164.) Line 3092, column 20, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...esult ,x-result ,y-result (progn ,@@forms)))) @end example In
a call like @w{@...
^^
165.) Line 3100, column 50, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...yms to avoid variable capture by @code{(progn ,@@forms)} obscures things
further. @code{cl-...
^^
166.) Line 3106, column 11, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...&rest forms) (cl-once-only (x y) `(list ,x ,y ,x ,y (progn
,@@forms)))) @en...
^^
167.) Line 3106, column 14, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...st forms) (cl-once-only (x y) `(list ,x ,y ,x ,y (progn
,@@forms)))) @end e...
^^
168.) Line 3106, column 17, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...forms) (cl-once-only (x y) `(list ,x ,y ,x ,y (progn
,@@forms)))) @end exam...
^^
169.) Line 3106, column 20, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...ms) (cl-once-only (x y) `(list ,x ,y ,x ,y (progn
,@@forms)))) @end example...
^^
170.) Line 3107, column 18, Rule ID: COMMA_PARENTHESIS_WHITESPACE
Message: Put a space after the comma, but not before the comma.
Suggestion: ,
...x y) `(list ,x ,y ,x ,y (progn ,@@forms)))) @end example @end
defmac @subsec...
^^
171.) Line 3121, column 45, Rule ID: NON_STANDARD_WORD[1]
Message: The word ‘@code{t’ is not standard English. Did you mean “@code’t”
(curly apostrophe) or “@code't” (straight apostrophe)?
Suggestion: @code’t; @code't
... If the optional argument @var{keep-pred} is @code{t}, the map stays active
as long as the user t...
^^^^^^^
172.) Line 3167, column 41, Rule ID: EN_UNPAIRED_BRACKETS prio=-1
Message: Unpaired symbol: ‘)’ seems to be missing
...-key This function is like @code{keymap-set} (@pxref{Changing Key
Bindings,,,elisp}, but un...
^
173.) Line 3279, column 52, Rule ID: EN_A_VS_AN prio=-1
Message: Use “an” instead of ‘a’ if the following word starts with a vowel
sound, e.g. ‘an article’, ‘an hour’.
Suggestion: an
...tions or performance issues. We also provide a
@uref{https://lists.sr.ht/~pkal/compat-devel...
^
Time: 3893ms for 1271 sentences (326.5 sentences/sec)
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>