+* Spell checker for Sylpheed-Claws
+
+ a. Requirements
+ b. Configuration and installation
+ c. Usage
+ d. Known problems
+
+ a. Requirements
+ ---------------
+
+ The spell checker in sylpheed requires the Portable Spell Checker
+ Interface Library pspell (http://pspell.sourceforge.net), version
+ 0.12.2 or newer.
+
+ You will need also the actual spell checker. There are two alternatives:
+
+ i) ispell (http://fmg-www.cs.ucla.edu/fmg-members/geoff/ispell.html),
+ which is found on quasi every distribution. You have then to
+ install the pspell-ispell module found at the pspell site.
+
+ ii) aspell (http://aspell.sourceforge.net). This spell checker
+ must be installed after installing pspell. The version tested
+ is .33.7 alpha. It has three different suggestion modes (fast
+ -default- , normal, bad spellers), has the ability to learn
+ from mistakes (default).
+
+ And, last but not least, do not forget to install the dictionaries. Check
+ the corresponding spell checker home page for more information on this.
+
+ b. Configuring Sylpheed
+ -----------------------
+
+ Spell checking is enabled if you configure sylpheed appropriately. Add
+ the option '--enable-pspell' when configuring. E.g.:
+
+ ./configure --enable-pspell
+
+ The configure script needs 'pspell-config' in your path. If it is
+ in weird places, use '--with-pspell-prefix' to tell the path to
+ pspell-config. E.g., if pspell-config is really
+ /foo/bar/pspell-config, then use:
+
+ ./configure --enable-pspell --with-pspell-prefix=/foo/bar
+
+ If you have problems with not found includes or libraries, check
+ first where these are located, and add either options:
+
+ --with-pspell-includes=/foo/bar/include
+
+ or
+
+ --with-pspell-libs=/foo/bar/lib
+
+ as appropriate.
+
+ Configure script summarizes the options compiled in. Check that
+ configure lists 'Pspell = yes'.
+
+ Then proceed as usual, with 'make' and 'make install'.
+
+ c. Usage
+ --------
+
+ NOTE: if you upgraded from 0.7.0claws, please reselect your default
+ dictionary in the preferences.
+
+ After successful compiling, you need to tell sylpheed where your
+ dictionaries reside. First run 'pspell-config pkgdatadir' on the
+ shell to get their path.
+
+ Then run sylpheed and go to Configuration -> Common preferences ->
+ Spell Checker. Check the box 'Enable spell checker (EXPERIMENTAL)' and
+ use the file selector ('...' button) to select the path where the
+ dictionaries reside. Within the file selector, go to that directory
+ and select *any* file in the file lists. Click ok. You should then
+ be able to select your default dictionary.
+
+ When composing, misspelled words are highlighted. Click on any
+ highlighted word with the right mouse button to get a list of
+ suggestions. The first entry of the menu just displays the unknown
+ word. Selecting "Accept in this session" (or hitting MOD1-Space,
+ where MOD1 is usually the ALT key), will ignore this word and accept
+ it in this message. Selecting the next entry "Add to dictionary", which
+ is bound to MOD1-Enter combination will add the unknown word to the
+ dictionary to learn it. The next entries are the suggested words.
+ The first 15 suggestions can be accessed typing one of the first letters
+ of latin alphabet (if this does not suit your language, please send
+ a mail to melvin.hadasht@free.fr). If you are using an aspell
+ dictionary, you can use its 'learn from mistake' feature, by pressing
+ the MOD1 key and selecting the suggestion (with the keyboard or with
+ the mouse). See pspell manual ยง4.7.1 for an explanation of this
+ feature.
+
+ If you click with the right mouse button everywhere else, or if you
+ shift-right-click even on a misspelled word, you get the
+ configuration menu. 'Check all' highlights all misspelled words.
+ With this menu, you can also change the dictionary while editing.
+ FInally, you can change the suggestion mode misktakes 'feature'
+ (useful only with aspell).
+
+ Spell checking can also be done using keyboard shortcuts. In the
+ "Edit" menu of the compose window, there are two menus "Check backwards
+ misspelled word" and "Forward to next misspelled word". Add to them
+ appropriate keyboard shortcuts. "Check backwards misspelled word"
+ checks backwards from cursor position for the first misspelled word.
+ If it finds one, it displays the suggestions lists which can be handled
+ with the keyboard as described before. When the suggestion menu is
+ closed, the cursor returns to its original position to be able to
+ continue editing. The "Forward to next misspelled word" do the same
+ thing in the other direction but moves the cursor at the end of the
+ misspelled word. This way, you can spell check easily a whole message
+ starting from its beginning and using the "Forward to next misspelled
+ word" keyboard short cut.
+
+
+ d. Known problems
+ -----------------
+
+ i) libtool
+
+ The only real known problems until now are configuration and
+ compilation problems due to libtool interaction with pspell.
+
+ If you do not compile pspell/aspell/pspell-ispell yourself, you
+ need to install them with their devel packages.
+
+ Pspell work with dynamic linking of libraries and thus uses the
+ libltdl library of libtool. If you have weird problems when
+ configuring showing 'libtool', chances are the libtool used when
+ compiling the pspell package is not compatible with what you have
+ on your system. The best solution, is to install the latest
+ libtool AND compile yourself pspell package. I can't help more
+ than that in this issue.
+
+ After successfully compiled and used sylpheed with spell checking,
+ the same problem can appear if you upgrade your libtool to a
+ version which libltdl is incompatible to your older one. The
+ symptoms are a crash when starting to compose. Disabling spell
+ checking avoids the problem. The solution should be to recompile pspell.
+
+ ii) New installed ispell dictionary are not detected
+
+ Installing a new ispell dictionary needs an additional step. Go
+ to the 'pkgdatadir' and run 'make-ispell-pwli'. You may need to
+ su root.
+
+* simplify subject string
+ It is possible to remove parts of string from the subject line.
+ Example: [Sylpheed-claws-users] This is a test
+ becomes: This is a test
+ This is a per folder property. Right click on a folder and select
+ property, enable Simplify Subject RegExp check box. Example
+ regexp for the above is: \[Sylpheed-claws-(devel|users)\]
+ Another example for the Sylpheed mailing list (not claws!) is:
+ \[sylpheed:[0-9]{5}\]
projects / claws.git / blobdiff