summaryrefslogtreecommitdiff
path: root/runtime/doc/spell.txt
diff options
context:
space:
mode:
authorBram Moolenaar <Bram@vim.org>2005-08-23 21:02:42 +0000
committerBram Moolenaar <Bram@vim.org>2005-08-23 21:02:42 +0000
commit6f16eb817ba8b32c012e910e83bad98f1fe17f05 (patch)
tree9e21f9e8f0426644aa7abf3a8d622ade73c0a881 /runtime/doc/spell.txt
parent7862282f2edc76533c5c0dcf49b57bf747a30ebc (diff)
downloadvim-git-6f16eb817ba8b32c012e910e83bad98f1fe17f05.tar.gz
updated for version 7.0135
Diffstat (limited to 'runtime/doc/spell.txt')
-rw-r--r--runtime/doc/spell.txt81
1 files changed, 53 insertions, 28 deletions
diff --git a/runtime/doc/spell.txt b/runtime/doc/spell.txt
index 04b313249..2a859a9d7 100644
--- a/runtime/doc/spell.txt
+++ b/runtime/doc/spell.txt
@@ -1,4 +1,4 @@
-*spell.txt* For Vim version 7.0aa. Last change: 2005 Aug 22
+*spell.txt* For Vim version 7.0aa. Last change: 2005 Aug 23
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -145,7 +145,8 @@ z? For the word under/after the cursor suggest correctly
different).
When a word was replaced the redo command "." will
repeat the word replacement. This works like "ciw",
- the good word and <Esc>.
+ the good word and <Esc>. This does NOT work for Thai
+ and other languages without spaces between words.
*:spellr* *:spellrepall* *E752* *E753*
:spellr[epall] Repeat the replacement done by |z?| for all matches
@@ -435,8 +436,7 @@ then Vim will try to guess.
into one en.spl file.
Up to eight regions can be combined. *E754* *755*
The REP and SAL items of the first .aff file where
- they appear are used. |spell-affix-REP|
- |spell-affix-SAL|
+ they appear are used. |spell-REP| |spell-SAL|
This command uses a lot of memory, required to find
the optimal word tree (Polish, Italian and Hungarian
@@ -602,15 +602,6 @@ used to modify the basic words to get the full word list. This significantly
reduces the number of words, especially for a language like Polish. This is
called affix compression.
-The format for the affix and word list files is mostly identical to what
-Myspell uses (the spell checker of Mozilla and OpenOffice.org). A description
-can be found here:
- http://lingucomponent.openoffice.org/affix.readme ~
-Note that affixes are case sensitive, this isn't obvious from the description.
-
-Vim supports a few extras. Hopefully Myspell will support these too some day.
-See |spell-affix-vim|.
-
The basic word list and the affix file are combined and turned into a binary
spell file. All the preprocessing has been done, thus this file loads fast.
The binary spell file format is described in the source code (src/spell.c).
@@ -620,6 +611,19 @@ The preprocessing also allows us to take the Myspell language files and modify
them before the Vim word list is made. The tools for this can be found in the
"src/spell" directory.
+The format for the affix and word list files is based on what Myspell uses
+(the spell checker of Mozilla and OpenOffice.org). A description can be found
+here:
+ http://lingucomponent.openoffice.org/affix.readme ~
+Note that affixes are case sensitive, this isn't obvious from the description.
+
+Vim does not use the TRY item, it is ignored. For making suggestions the
+possible characters in the words are used.
+
+Vim supports quite a few extras. They are described below |spell-affix-vim|.
+Attempts have been made to keep this compatible with other spell checkers, so
+that the same files can be used.
+
WORD LIST FORMAT *spell-dic-format*
@@ -635,6 +639,7 @@ A very short example, with line numbers:
8 bedel/P
9 kado/1
10 cadeau/2
+ 11 TCP,IP
The first line contains the number of words. Vim ignores it, but you do get
an error message if it's not there. *E760*
@@ -659,7 +664,7 @@ The word with all upper-case characters will always be OK.
AlS AlS ALS als Als ALs aLs aLS
The KEP affix ID can be used to specifically match a word with identical case
-only, see below |spell-affix-KEP|.
+only, see below |spell-KEP|.
Note in line 5 to 7 that non-word characters are used. You can include
any character in a word. When checking the text a word still only matches
@@ -671,6 +676,11 @@ letters that indicate the affixes that can be used with this word. These are
specified with SFX and PFX lines in the .aff file. See the Myspell
documentation.
+In line 12 the word "TCP/IP" is defined. Since the slash has a special
+meaning the comma is used instead. This is defined with the SLASH item in the
+affix file, see |spell-SLASH|. Note that without this SLASH item the
+word will be "TCP,IP".
+
*spell-affix-vim*
A flag that Vim adds and is not in Myspell is the flag defined with KEP in the
affix file. This has the meaning that case matters. This can be used if the
@@ -701,8 +711,8 @@ word characters (as specified with ENC). This is because the system where
":mkspell" is used may not support a locale with this encoding and isalpha()
won't work. For example when using "cp1250" on Unix.
- *E761* *E762* *spell-affix-FOL*
- *spell-affix-LOW* *spell-affix-UPP*
+ *E761* *E762* *spell-FOL*
+ *spell-LOW* *spell-UPP*
Three lines in the affix file are needed. Simplistic example:
FOL áëñ ~
@@ -722,6 +732,10 @@ The "UPP" line specifies the characters with upper-case. That is, a character
is upper-case where it's different from the character at the same position in
"FOL".
+An exception is made for the German sharp s ß. The upper-case version is
+"SS". In the FOL/LOW/UPP lines it should be included, so that it's recognized
+as a word character, but use the ß character in all three.
+
ASCII characters should be omitted, Vim always handles these in the same way.
When the encoding is UTF-8 no word characters need to be specified.
@@ -754,7 +768,7 @@ These characters are defined with MIDWORD in the .aff file:
AFFIXES
- *spell-affix-PFX* *spell-affix-SFX*
+ *spell-PFX* *spell-SFX*
The usual PFX (prefix) and SFX (suffix) lines are supported (see the Myspell
documentation or the Aspell manual:
http://aspell.net/man-html/Affix-Compression.html).
@@ -793,7 +807,7 @@ Example:
This allows for "wordutil" and "wordutils" but not "wordutilize".
- *spell-affix-PFXPOSTPONE*
+ *spell-PFXPOSTPONE*
When an affix file has very many prefixes that apply to many words it's not
possible to build the whole word list in memory. This applies to Hebrew (a
list with all words is over a Gbyte). In that case applying prefixes must be
@@ -809,7 +823,7 @@ but in lower case. Thus when the chop string is used to allow the following
word to start with an upper case letter.
-WORDS WITH A SLASH *spell-affix-SLASH*
+WORDS WITH A SLASH *spell-SLASH*
The slash is used in the .dic file to separate the basic word from the affix
letters that can be used. Unfortunately, this means you cannot use a slash in
@@ -824,7 +838,7 @@ Of course, the letter used should itself not appear in any word! The letter
must be ASCII, thus a single byte.
-KEEP-CASE WORDS *spell-affix-KEP*
+KEEP-CASE WORDS *spell-KEP*
In the affix file a KEP line can be used to define the affix name used for
keep-case words. Example:
@@ -834,7 +848,7 @@ keep-case words. Example:
See above for an example |spell-affix-vim|.
-RARE WORDS *spell-affix-RAR*
+RARE WORDS *spell-RAR*
In the affix file a RAR line can be used to define the affix name used for
rare words. Example:
@@ -847,7 +861,7 @@ a typing mistake anyway. When the same word is found as good it won't be
highlighted as rare.
-BAD WORDS *spell-affix-BAD*
+BAD WORDS *spell-BAD*
In the affix file a BAD line can be used to define the affix name used for
bad words. Example:
@@ -862,14 +876,14 @@ This can be used to exclude words that would otherwise be good. For example
Once a word has been marked as bad it won't be undone by encountering the same
word as good.
- *spell-affix-NEEDAFFIX*
+ *spell-NEEDAFFIX*
The NEEDAFFIX flag is used to require that a word is used with an affix. The
word itself is not a good word. Example:
NEEDAFFIX + ~
-COMPOUND WORDS *spell-affix-compound*
+COMPOUND WORDS *spell-compound*
A compound word is a longer word made by concatenating words that appear in
the .dic file. To specify which words may be concatenated a character is
@@ -988,6 +1002,17 @@ Above another way to restrict compounding was mentioned above: adding "nocomp"
after an affix causes all words that are made with that affix not be be used
for compounding. |spell-affix-nocomp|
+
+UNLIMITED COMPOUNDING *spell-NOBREAK*
+
+For some languages, such as Thai, there is no space in between words. This
+looks like all words are compounded. To specify this use the NOBREAK item in
+the affix file, without arguments:
+ NOBREAK ~
+
+Vim will try to figure out where one word ends and a next starts. When there
+are spelling mistakes this may not be quite right.
+
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>><<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
NOTE: The following has not been implemented yet, because there are no word
lists that support this.
@@ -1028,7 +1053,7 @@ lists that support this.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>><<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
-REPLACEMENTS *spell-affix-REP*
+REPLACEMENTS *spell-REP*
In the affix file REP items can be used to define common mistakes. This is
used to make spelling suggestions. The items define the "from" text and the
@@ -1046,7 +1071,7 @@ anyway. You can include whole words if you want to, but you might want to use
the "file:" item in 'spellsuggest' instead.
-SIMILAR CHARACTERS *spell-affix-MAP*
+SIMILAR CHARACTERS *spell-MAP*
In the affix file MAP items can be used to define letters that are very much
alike. This is mostly used for a letter with different accents. This is used
@@ -1062,7 +1087,7 @@ Each letter must appear in only one of the MAP items. It's a bit more
efficient if the first letter is ASCII or at least one without accents.
-SOUND-A-LIKE *spell-affix-SAL*
+SOUND-A-LIKE *spell-SAL*
In the affix file SAL items can be used to define the sounds-a-like mechanism
to be used. The main items define the "from" text and the "to" replacement.
@@ -1086,7 +1111,7 @@ There are a few special items:
"1" has the same meaning as "true". Any other value means "false".
-SIMPLE SOUNDFOLDING *spell-affix-SOFOFROM* *spell-affix-SOFOTO*
+SIMPLE SOUNDFOLDING *spell-SOFOFROM* *spell-SOFOTO*
The SAL mechanism is complex and slow. A simpler mechanism is mapping all
characters to another character, mapping similar sounding characters to the