summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorReuben Thomas <rrt@sc3d.org>2017-02-04 16:32:03 +0000
committerGitHub <noreply@github.com>2017-02-04 16:32:03 +0000
commitd8c66065273789ffc17d3d84baf68875cd96a8ec (patch)
tree4d9d5ae81ce45a92bce7f1740c5b20843d7547b5
parentd5d7040f800a354fe932c0b02629e6a12b91b602 (diff)
parent50b7728f9f07c8794f150d7b25991d7e7164afa6 (diff)
downloadenchant-d8c66065273789ffc17d3d84baf68875cd96a8ec.tar.gz
Merge pull request #67 from rrthomas/master
Improve the README
-rw-r--r--README78
1 files changed, 32 insertions, 46 deletions
diff --git a/README b/README
index 31b0027..e70a398 100644
--- a/README
+++ b/README
@@ -1,66 +1,52 @@
libenchant -- Generic spell checking library
-Dom Lachowicz <cinamod@hotmail.com>
+Original author: Dom Lachowicz
- libenchant is licensed under the terms of the GNU LGPL included in the
-file COPYING.LIB.
+libenchant is licensed under the terms of the GNU LGPL (see the file
+COPYING.LIB), with a special exception allowing the use of proprietary
+spell-checking systems.
- The project aims to provide an efficient extensible abstraction for
-dealing with different spell checking libraries.
+Enchant aims to provide a simple but comprehensive abstraction for dealing
+with different spell checking libraries in a consistent way. A client, such
+as a text editor or word processor, need not know anything about a specific
+spell-checker, and since all back-ends are plugins, new spell-checkers can
+be added without needing any change to the program using Enchant.
- Enchant is meant to provide a generic interface into various existing
-spell checking libraries. These include, but are not limited to:
+Enchant can be configured by the user, who can even add spell-checker
+plugins if desired.
+
+Enchant currently works with the following spell-checkers:
* Hunspell (formerly Myspell)
- * Apple Spell (OS X only)
- * Aspell/Pspell
- * Ispell
+ * GNU Aspell
+ * GNU Ispell[1]
* Hspell
+ * Voikko
+ * Apple Spell (macOS only)
+ * Zemberek
* Uspell
- * Voikko (Linux only)
-
- Enchant is also meant to be used in a cross-platform environment. Part
-of this means that Enchant wants to limit its number of external dependencies
-to 0, or as close is as humanly possible. Also, any enchant consumer (i.e. a
-Word Processor) should not need to know about what backend providers Enchant
-knows about. In fact, Enchant shouldn't even need to know this information
-itself. To accomplish this, all of Enchant's providers are DLLs.
- Enchant is also meant to be used in a multi-user environment, such as Unix.
-It is preferable to have both a $USER and a $GLOBAL location for both
-provider DLLs and for dictionaries themselves, when possible. Enchant's DLL
-location algorithm takes this into account, and gives preference to the $USER
-DLLs, when found.
+Enchant is written in C and C++, and its only external dependency is glib.
-To report libenchant bugs, please visit https://github.com/AbiWord/enchant
+[1] Enchant contains a version of Ispell built as a library, which enables
+it to use Ispell dictionaries.
- This library is free software; you can redistribute it and/or modify
- it under the terms of version 2.1 of the GNU Lesser General Public License
- as published by the Free Software Foundation.
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
+Bug reports and development
+---------------------------
- You should have received a copy of the GNU Lesser General Public License
- along with this program; if not, write to the Free Software Foundation,
- Inc., 59 Temple Place, Suite 330, Boston, MA 02110-1301 USA
+To report libenchant bugs or request features, please visit
+https://github.com/AbiWord/enchant
---
+If you can't use GitHub, you can use the (low-traffic) AbiWord-devel list.
+To subscribe send a mail to:
-This library has taken insight from
+ abiword-dev-request@abisource.com
-Aspell/Pspell:
- - http://aspell.net
+and in the body of the message write "subscribe"
-Mailing lists
--------------
+An archive of the mailing lists is available at:
- There is NO mailing list used to discuss libenchant specifically as yet.
-For now please use the AbiWord-devel list. To subscribe send a mail to:
+ http://www.abisource.com/mailinglists/abiword-dev/
- abiword-dev-request@abisource.com
-And in the body of the message write "subscribe"
-An archive of the mailing lists is available at:
- http://www.abisource.com/mailinglists/abiword-dev/
+Enchant has taken insight from GNU Aspell: http://aspell.net