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
--
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
diff -r a8afba7027ae runtime/doc/change.txt
--- a/runtime/doc/change.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/change.txt Sat May 22 09:35:58 2010 +0200
@@ -1139,7 +1139,7 @@
register. {not in Vi}
7. Selection and drop registers "*, "+ and "~
-Use these register for storing and retrieving the selected text for the GUI.
+Use these registers for storing and retrieving the selected text for the GUI.
See |quotestar| and |quoteplus|. When the clipboard is not available or not
working, the unnamed register is used instead. For Unix systems the clipboard
is only available when the |+xterm_clipboard| feature is present. {not in Vi}
diff -r a8afba7027ae runtime/doc/ft_sql.txt
--- a/runtime/doc/ft_sql.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/ft_sql.txt Sat May 22 09:35:58 2010 +0200
@@ -536,7 +536,7 @@
completion window is active. If the completion popup window is
not active, a normal <Right> or <Left> will be executed.
-Lets look how we can build a SQL statement dynamically. A select statement
+Let's look at how we can build a SQL statement dynamically. A select statement
requires a list of columns. There are two ways to build a column list using
the SQL completion plugin. >
One column at a time:
@@ -738,8 +738,8 @@
Many times SQL can be used with different filetypes. For example Perl, Java,
PHP, Javascript can all interact with a database. Often you need both the SQL
-completion as well as the completion capabilities for the current language you
-are editing.
+completion and the completion capabilities for the current language you are
+editing.
This can be enabled easily with the following steps (assuming a Perl file): >
1. :e test.pl
diff -r a8afba7027ae runtime/doc/gui.txt
--- a/runtime/doc/gui.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/gui.txt Sat May 22 09:35:58 2010 +0200
@@ -678,7 +678,7 @@
default toolbar is setup in menu.vim.
The display of the toolbar is controlled by the 'guioptions' letter 'T'. You
can thus have menu & toolbar together, or either on its own, or neither.
-The appearance is controlled by the 'toolbar' option. You can chose between
+The appearance is controlled by the 'toolbar' option. You can choose between
an image, text or both.
*toolbar-icon*
diff -r a8afba7027ae runtime/doc/gui_x11.txt
--- a/runtime/doc/gui_x11.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/gui_x11.txt Sat May 22 09:35:58 2010 +0200
@@ -453,8 +453,8 @@
For GTK+, Vim's configuration process requires that GTK+ be properly
installed. That is, the shell script 'gtk-config' must be in your PATH, and
you can already successful compile, build, and execute a GTK+ program. The
-reason for this is because the compiler flags (CFLAGS) and link flags
-(LDFLAGS) are obtained through the 'gtk-config' shell script.
+reason for this is that the compiler flags (CFLAGS) and link flags (LDFLAGS)
+are obtained through the 'gtk-config' shell script.
If you want to build with GTK+ 2 support pass the --enable-gtk2-check argument
to ./configure. Optionally, support for GNOME 2 will be compiled if the
diff -r a8afba7027ae runtime/doc/insert.txt
--- a/runtime/doc/insert.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/insert.txt Sat May 22 09:35:58 2010 +0200
@@ -1358,7 +1358,7 @@
- function names with additional info:
- in case of built-in functions list of possible arguments and after | type
data returned by function
- - in case of user function arguments and name of file were function was
+ - in case of user function arguments and name of file where function was
defined (if it is not current file)
- constants names
@@ -1446,8 +1446,8 @@
If you edit a file called, index.php, run the following command: >
:syntax list
-First thing you will notice is there are many different syntax groups. The
-PHP language can include elements from different languages like HTML,
+The first thing you will notice is that there are many different syntax groups.
+The PHP language can include elements from different languages like HTML,
JavaScript and many more. The syntax plugin will only include syntax groups
that begin with the filetype, "php", in this case. For example these syntax
groups are included by default with the PHP: phpEnvVar, phpIntVar,
diff -r a8afba7027ae runtime/doc/mbyte.txt
--- a/runtime/doc/mbyte.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/mbyte.txt Sat May 22 09:35:58 2010 +0200
@@ -753,7 +753,7 @@
X INPUT METHOD (XIM) BACKGROUND *XIM* *xim* *x-input-method*
-XIM is an international input module for X. There are two kind of structures,
+XIM is an international input module for X. There are two kinds of structures,
Xlib unit type and |IM-server| (Input-Method server) type. |IM-server| type
is suitable for complex input, such as CJK.
@@ -826,7 +826,7 @@
of Preedit Area and Status Area: |OnTheSpot|, |OffTheSpot|, |OverTheSpot|
and |Root|.
- Currently, GUI Vim support three style, |OverTheSpot|, |OffTheSpot| and
+ Currently, GUI Vim support three styles, |OverTheSpot|, |OffTheSpot| and
|Root|.
*. on-the-spot *OnTheSpot*
diff -r a8afba7027ae runtime/doc/netbeans.txt
--- a/runtime/doc/netbeans.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/netbeans.txt Sat May 22 09:35:58 2010 +0200
@@ -101,7 +101,8 @@
==============================================================================
3. Configuring Vim for NetBeans *netbeans-configure*
-For more help installing Vim, please read |usr_90.txt| in the Vim User Manual.
+For more help about installing Vim, please read |usr_90.txt| in the Vim User
+Manual.
On Unix:
diff -r a8afba7027ae runtime/doc/options.txt
--- a/runtime/doc/options.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/options.txt Sat May 22 09:35:58 2010 +0200
@@ -5292,7 +5292,7 @@
local to window
{not in Vi}
Show the line number relative to the line with the cursor in front of
- each line. Relative line numbers help you using the |count| you can
+ each line. Relative line numbers help you use the |count| you can
precede some vertical motion commands (e.g. j k + -) with, without
having to calculate it yourself. Especially useful in combination with
other commands (e.g. y d c < > gq gw =).
diff -r a8afba7027ae runtime/doc/os_390.txt
--- a/runtime/doc/os_390.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/os_390.txt Sat May 22 09:35:58 2010 +0200
@@ -190,7 +190,7 @@
They still do not work for the menu items themselves (like <Alt-F>O to open
the file browser).
-There is no solution for this as of yet.
+There is no solution for this yet.
==============================================================================
7. Bugs *OS390-bugs* *zOS-Bugs*
diff -r a8afba7027ae runtime/doc/os_os2.txt
--- a/runtime/doc/os_os2.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/os_os2.txt Sat May 22 09:35:58 2010 +0200
@@ -201,7 +201,7 @@
which will write your selection right into OS/2's clipboard.
-For ease of use you might want to add some maps for this commands. E.g. to
+For ease of use you might want to add some maps for these commands. E.g. to
use F11 to paste the clipboard into Vim and F12 to copy selected text to the
clipboard you would use: >
diff -r a8afba7027ae runtime/doc/os_vms.txt
--- a/runtime/doc/os_vms.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/os_vms.txt Sat May 22 09:35:58 2010 +0200
@@ -99,7 +99,7 @@
You can find more information about CTAGS on VMS at
http://www.polarhome.com/ctags/
-Advanced users may try some acrobatics in FEATURE.H file also.
+Advanced users may try some acrobatics in FEATURE.H file as well.
It is possible to compile with +xfontset +xim options too, but then you have
to set up GUI fonts etc. correctly. See :help xim from Vim command prompt.
diff -r a8afba7027ae runtime/doc/pi_netrw.txt
--- a/runtime/doc/pi_netrw.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/pi_netrw.txt Sat May 22 09:35:58 2010 +0200
@@ -456,7 +456,7 @@
On the other hand, thanks go to Jan M. for pointing out the many
vulnerabilities that netrw (and vim itself) had had in handling "crafted"
filenames. The |shellescape()| and |fnameescape()| functions were written in
-response by Bram Moolenaar to handle these sort of problems, and netrw has
+response by Bram Moolenaar to handle this sort of problems, and netrw has
been modified to use them. Still, my advice is, if the "filename" looks like
a vim command that you aren't comfortable with having executed, don't open it.
diff -r a8afba7027ae runtime/doc/quickfix.txt
--- a/runtime/doc/quickfix.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/quickfix.txt Sat May 22 09:35:58 2010 +0200
@@ -1260,7 +1260,7 @@
This can be solved by printing absolute directories in the "enter directory"
message or by printing "leave directory" messages..
-To avoid this problems, ensure to print absolute directory names and "leave
+To avoid this problem, ensure to print absolute directory names and "leave
directory" messages.
Examples for Makefiles:
diff -r a8afba7027ae runtime/doc/quotes.txt
--- a/runtime/doc/quotes.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/quotes.txt Sat May 22 09:35:58 2010 +0200
@@ -211,7 +211,7 @@
getting tired of hearing me bragging about it. Others eyes are lighting up.
(Rick Croote)
-Emacs takes way to much time to start up and run, it is to big and bulky for
+Emacs takes way too much time to start up and run, it is to big and bulky for
effective use and the interface is more confusing than it is of any help. VIM
however is short, it is fast, it is powerful, it has a good interface and it
is all purpose. (Paal Ditlefsen Ekran)
diff -r a8afba7027ae runtime/doc/repeat.txt
--- a/runtime/doc/repeat.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/repeat.txt Sat May 22 09:35:58 2010 +0200
@@ -217,7 +217,7 @@
Don't use "ucs-2" or "ucs-4", scripts cannot be in
these encodings (they would contain NUL bytes).
When a sourced script starts with a BOM (Byte Order
- Mark) in utf-8 format Vim will recognized it, no need
+ Mark) in utf-8 format Vim will recognize it, no need
to use ":scriptencoding utf-8" then.
When compiled without the |+multi_byte| feature this
diff -r a8afba7027ae runtime/doc/scroll.txt
--- a/runtime/doc/scroll.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/scroll.txt Sat May 22 09:35:58 2010 +0200
@@ -132,7 +132,7 @@
*zz*
zz Like "z.", but leave the cursor in the same column.
- Careful: If caps-lock is on, this commands becomes
+ Careful: If caps-lock is on, this command becomes
"ZZ": write buffer and exit! {not in Vi}
*z-*
@@ -193,7 +193,7 @@
5. Scrolling synchronously *scroll-binding*
Occasionally, it is desirable to bind two or more windows together such that
-when one window is scrolled, the other windows are scrolled also. In Vim,
+when one window is scrolled, the other windows are also scrolled. In Vim,
windows can be given this behavior by setting the (window-specific)
'scrollbind' option. When a window that has 'scrollbind' set is scrolled, all
other 'scrollbind' windows are scrolled the same amount, if possible. The
diff -r a8afba7027ae runtime/doc/syntax.txt
--- a/runtime/doc/syntax.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/syntax.txt Sat May 22 09:35:58 2010 +0200
@@ -712,7 +712,7 @@
highlighting for cErrInParen and cErrInBracket.
If you want to use folding in your C files, you can add these lines in a file
-an the "after" directory in 'runtimepath'. For Unix this would be
+in the "after" directory in 'runtimepath'. For Unix this would be
~/.vim/after/syntax/c.vim. >
syn sync fromstart
set foldmethod=syntax
@@ -905,7 +905,7 @@
the following to your .vimrc. >
:let g:load_doxygen_syntax=1
-There are a couple of variables that have an affect on syntax highlighting, and
+There are a couple of variables that have an effect on syntax highlighting, and
are to do with non-standard highlighting options.
Variable Default Effect ~
diff -r a8afba7027ae runtime/doc/term.txt
--- a/runtime/doc/term.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/term.txt Sat May 22 09:35:58 2010 +0200
@@ -594,7 +594,7 @@
to use the mouse in a GUI window is explained in |gui-mouse|. For scrolling
with a mouse wheel see |scroll-mouse-wheel|.
-Don't forget to enable the mouse with this commands: >
+Don't forget to enable the mouse with this command: >
:set mouse=a
Otherwise Vim won't recognize the mouse in all modes (See 'mouse').
diff -r a8afba7027ae runtime/doc/todo.txt
--- a/runtime/doc/todo.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/todo.txt Sat May 22 09:35:58 2010 +0200
@@ -1693,7 +1693,7 @@
Windows 95:
-8 Editing a file by it's short file name and writing it, makes the long file
+8 Editing a file by its short file name and writing it, makes the long file
name disappear. Setting 'backupcopy' helps.
Use FindFirstFile()->cAlternateFileName in fname_case() (George Reilly).
8 Doing wildcard expansion, will match the short filename, but result in the
@@ -3134,7 +3134,7 @@
gettext and menus work.
8 Could keep console open to run multiple commands, to avoid the need to hit
return in every console.
- Also: Look at how Emacs does runs external commands:
+ Also: Look at how Emacs does run external commands:
http://www.cs.washington.edu/homes/voelker/ntemacs.html.
8 Need a separate PopUp menu for modeless selection. Need two new commands:
Copy selection to clipboard, Paste selection (as typed text).
@@ -4675,7 +4675,7 @@
- Amiga: When 'r' protection bit is not set, file can still be opened but
gives read errors. Check protection before opening.
- When writing check for file exists but no permission, "Permission denied".
-- If file does not exists, check if directory exists.
+- If file does not exist, check if directory exists.
- MSDOS: although t_cv and t_ci are not set, do invert char under cursor.
- Settings edit mode: make file with ":set opt=xx", edit it, parse it as ex
commands.
diff -r a8afba7027ae runtime/doc/usr_04.txt
--- a/runtime/doc/usr_04.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/usr_04.txt Sat May 22 09:35:58 2010 +0200
@@ -498,7 +498,7 @@
~ change case of the character under the cursor, and move the
cursor to the next character. This is not an operator (unless
'tildeop' is set), thus you can't use it with a motion
- command. It does works in Visual mode and changes case for
+ command. It does work in Visual mode and changes case for
all the selected text then.
I Start Insert mode after moving the cursor to the first
diff -r a8afba7027ae runtime/doc/usr_22.txt
--- a/runtime/doc/usr_22.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/usr_22.txt Sat May 22 09:35:58 2010 +0200
@@ -98,7 +98,7 @@
< (etc)
The <F1> key thus brings you to a netrw directory browsing contents help page.
-Its a regular help page; use the usual |CTRL-]| to jump to tagged help items
+It's a regular help page; use the usual |CTRL-]| to jump to tagged help items
and |CTRL-O| to jump back.
To select files for display and editing: (with the cursor is atop a filename)
@@ -358,7 +358,7 @@
:buffer help
-Vim will find a best match for the name you type. If there is only one
+Vim will find the best match for the name you type. If there is only one
buffer that matches the name, it will be used. In this case "help.txt".
To open a buffer in a new window: >
diff -r a8afba7027ae runtime/doc/usr_27.txt
--- a/runtime/doc/usr_27.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/usr_27.txt Sat May 22 09:35:58 2010 +0200
@@ -77,7 +77,7 @@
Note:
The use of "\" items in search patterns depends on the 'magic' option.
- In this chapters we will assume 'magic' is on, because that is the
+ In this chapter we will assume 'magic' is on, because that is the
standard and recommended setting. If you would change 'magic', many
search patterns would suddenly become invalid.
diff -r a8afba7027ae runtime/doc/usr_30.txt
--- a/runtime/doc/usr_30.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/usr_30.txt Sat May 22 09:35:58 2010 +0200
@@ -362,7 +362,7 @@
echo "-------" ~
fi ~
-Start off by setting these option: >
+Start off by setting these options: >
:set autoindent shiftwidth=3
diff -r a8afba7027ae runtime/doc/usr_40.txt
--- a/runtime/doc/usr_40.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/usr_40.txt Sat May 22 09:35:58 2010 +0200
@@ -24,8 +24,8 @@
sequence of key strokes is translated into another sequence of key strokes.
This is a simple, yet powerful mechanism.
The simplest form is that one key is mapped to a sequence of keys. Since
-the function keys, except <F1>, have no predefined meaning in Vim, these are a
-good choice to map. Example: >
+the function keys, except <F1>, have no predefined meaning in Vim, these are
+good choices to map. Example: >
:map <F2> GoDate: <Esc>:read !date<CR>kJ
diff -r a8afba7027ae runtime/doc/usr_41.txt
--- a/runtime/doc/usr_41.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/usr_41.txt Sat May 22 09:35:58 2010 +0200
@@ -2152,7 +2152,7 @@
When defining a function, this only needs to be done once. But the filetype
plugin will be sourced every time a file with this filetype will be opened.
-This construct make sure the function is only defined once: >
+This construct makes sure the function is only defined once: >
:if !exists("*s:Func")
: function s:Func(arg)
diff -r a8afba7027ae runtime/doc/version5.txt
--- a/runtime/doc/version5.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/version5.txt Sat May 22 09:35:58 2010 +0200
@@ -7149,7 +7149,7 @@
Patch 5.6.060
Problem: Some bold characters spill over to the cell on the left, that
spill-over can remain sometimes.
-Solution: Redraw a characters when the next character was bold and needs
+Solution: Redraw a character when the next character was bold and needs
redrawing. (Robert Webb)
Files: src/screen.c
diff -r a8afba7027ae runtime/doc/version7.txt
--- a/runtime/doc/version7.txt Fri May 21 16:33:48 2010 +0200
+++ b/runtime/doc/version7.txt Sat May 22 09:35:58 2010 +0200
@@ -1243,7 +1243,7 @@
'scrolljump' can be set to a negative number to scroll a percentage of the
window height.
-The |v:scrollstart| variable has been added to help finding the location in
+The |v:scrollstart| variable has been added to help find the location in
your script that causes the hit-enter prompt.
To make it possible to handle the situation that a file is being edited that
