On 22/05/10 09:43, Dominique Pellé wrote:
Hi
Attached patch fixes grammatical errors in the Vim help files.
I found those errors using LanguageTool (http://www.languagetool.org/)
which can be downloaded with...
$ cvs -z3
-d:pserver:[email protected]:/cvsroot/languagetool
co -P JLanguageTool
This is how I ran it on the Vim help files with options to discard rules
which gave frequent false positives:
$ cd vim/runtime/doc
$ cat *txt | perl -pe 's/\n/ /; s/\. /.\n/g; s/[ \t]+/ /g; s/^ *[-o]?
+//' | java -jar /home/pel/sb/JLanguageTool/dist/LanguageTool.jar -d
EN_QUOTES,WHITESPACE_RULE,EN_UNPAIRED_BRACKETS,ARTICLE_MISSING,COMMA_PARENTHESIS_WHITESPACE,UPPERCASE_SENTENCE_START,WORD_REPEAT_RULE,DOUBLE_PUNCTUATION,EN_A_VS_AN,THREE_NN,PHRASE_REPETITION,THIS_NNS
...
323.) Line 31804, column 16, Rule ID: MASS_AGREEMENT[2]
Message: Possible agreement error - use third-person verb forms for
singular and mass nouns: 'makes'.
Suggestion: makes
...this filetype will be opened. This construct make sure the function
is only defined once:> :i...
^^^^
...
Although it gives many false positives when checking Vim help files,
it's still useful. Perhaps someone better than I am in vim script
could come up with a useful Vim plugin to integrate languagetool
in Vim?
-- Dominique
Also a couple of false negatives:
At line 829 of mbyte.txt,
- Currently, GUI Vim support three style, |OverTheSpot|, |OffTheSpot| and
+ Currently, GUI Vim support three styles, |OverTheSpot|, |OffTheSpot| and
"GUI Vim" is a singular (and a proper noun, which explains that it
slipped by): the verb following it should be "supports", not "support".
At line 102 of os_vms.txt:
-Advanced users may try some acrobatics in FEATURE.H file also.
+Advanced users may try some acrobatics in FEATURE.H file as well.
I would haved added the article "the" before FEATURE.H (whose all-caps
style surprises me, but maybe that's a VMS thing), and maybe used "too"
rather than "as well".
Similarly at lines 9-10 of the same file:
You can reach this information file by typing :help VMS in Vim command
prompt.
...on the Vim command line.
(with "the", and there is no real prompt), or maybe
...in Vim's command-line mode
(to avoid confusion with the shell command used to invoke Vim).
Someone might have to go over all the Vim help with a "copywriter's
mind" (or maybe two people: one to correct and another one to re-read)
but it would be arduous work, and for little gratification.
Best regards,
Tony.
--
Machines certainly can solve problems, store information, correlate,
and play games -- but not with pleasure.
-- Leo Rosten
--
You received this message from the "vim_use" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php
