README ** JNA based Java API for hyphen This package contains the JNA based Java bindings for the hyphen, see: http://sourceforge.net/projects/hunspell/files/Hyphen/ for details. This java wrapper lives at: https://github.com/dedeibel/libhyphenjna See this page for dictionaries: http://wiki.services.openoffice.org/wiki/Dictionaries * Building the native binaries Before using the java API you must build some native binaries to include in the jar, to make things easy I've included the binaries from the platforms that I care about in native-lib. The binaries in native-lib were built on the various platforms using the native-build.pl script, the source for the native libs is in native-src and consists of an unmodified hunspell source tar ball and any needed diffs. I've included a script called native-build.pl which might help to build on at least Linux and Mac and 32 and 64 bit, for windows you can take it as a hint of what to do. When building the sources on your own, make sure you have "gawk" installed if you run into related errors. * Building the Java API To build hyphen.jar simply run "ant" this will produce build/jar/hyphen.jar which contains everything a standalone application could want (aside from jna.jar which can be found on the JNA page or in lib) * API See HyphenMain.java for a very simple example of how to use the API, it boils down to: Hyphen.Dictionary dictionary = Hyphen.getInstance().getDictionary(dictPath); String hyphenated = dictionary.hyphenate(word); Hyphen.getInstance() caches the loaded hunspell library, so there is no overhead in calling it more than once. getDictionary() is also internally cached, so it costs no more than a hash lookup when calling the second time. * Thanks To Flemming Frandsen who build HunspellJNA which was mostly copied here, https://github.com/dren-dk/HunspellJNA Andrzej Zydron figured out how to build libhunspell for 64 bit OSX. * Misc At the moment the package contains copies of: * jna.jar version 3.4.0 * hyphen version 3.8.3 * junit 4 * hamcrest 1.3 Benjamin Peter <benjaminpeter@arcor.de>