updated for version 7.0070
diff --git a/runtime/doc/spell.txt b/runtime/doc/spell.txt
index 0f359a4..906e5cc 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 Apr 20
+*spell.txt* For Vim version 7.0aa. Last change: 2005 Apr 23
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -160,16 +160,19 @@
1. Obtain the xx_YY.aff and xx_YY.dic files from Myspell.
2. Make a copy of these files to xx_YY.orig.aff and xx_YY.orig.dic.
3. Change the xx_YY.aff and xx_YY.dic files to remove bad words, add missing
- words, etc.
-4. Use |:mkspell| to generate the Vim spell file and try it out.
+ words, define word characters with FOL/LOW/UPP, etc. The distributed
+ "src/spell/*.diff" files can be used.
+4. Set 'encoding' to the desired encoding and use |:mkspell| to generate the
+ Vim spell file.
+5. Try out the spell file with ":set spell spelllang=xx_YY".
When the Myspell files are updated you can merge the differences:
-5. Obtain the new Myspell files as xx_YY.new.aff and xx_UU.new.dic.
-6. Use Vimdiff to see what changed: >
+1. Obtain the new Myspell files as xx_YY.new.aff and xx_UU.new.dic.
+2. Use Vimdiff to see what changed: >
vimdiff xx_YY.orig.dic xx_YY.new.dic
-7. Take over the changes you like in xx_YY.dic.
+3. Take over the changes you like in xx_YY.dic.
You may also need to change xx_YY.aff.
-8. Rename xx_YY.new.dic to xx_YY.orig.dic and xx_YY.new.aff to xx_YY.new.aff.
+4. Rename xx_YY.new.dic to xx_YY.orig.dic and xx_YY.new.aff to xx_YY.new.aff.
==============================================================================
9. Spell file format *spell-file-format*
@@ -272,5 +275,38 @@
reduces the speed. It's a good idea to put all the often used words in the
word list with the affixes prepended/appended.
+ *spell-affix-chars*
+The affix file should define the word characters when using an 8-bit encoding
+(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*
+Three lines in the affix file are needed. Simplistic example:
+
+ FOL áëñáëñ
+ LOW áëñáëñ
+ UPP áëñÁËÑ
+
+All three lines must have exactly the same number of characters.
+
+The "FOL" line specifies the case-folded characters. These are used to
+compare words while ignoring case. For most encodings this is identical to
+the lower case line.
+
+The "LOW" line specifies the characters in lower-case. Mostly it's equal to
+the "FOL" line.
+
+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".
+
+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.
+
+ *E763*
+All spell files for the same encoding must use the same word characters,
+otherwise they can't be combined without errors.
+
vim:tw=78:sw=4:ts=8:ft=help:norl: