{"id":18343448,"url":"https://github.com/cosimo/perl5-text-hunspell","last_synced_at":"2025-04-06T07:32:33.636Z","repository":{"id":1055152,"uuid":"887775","full_name":"cosimo/perl5-text-hunspell","owner":"cosimo","description":"Bring new life into Text-Hunspell, the Perl 5 glue to hunspell spell checker","archived":false,"fork":false,"pushed_at":"2022-07-15T11:05:42.000Z","size":352,"stargazers_count":4,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-21T19:05:09.614Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://metacpan.org/pod/Text::Hunspell","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cosimo.png","metadata":{"files":{"readme":"README","changelog":"Changes","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2010-09-04T12:55:33.000Z","updated_at":"2022-07-15T10:13:11.000Z","dependencies_parsed_at":"2022-08-16T11:55:17.475Z","dependency_job_id":null,"html_url":"https://github.com/cosimo/perl5-text-hunspell","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosimo%2Fperl5-text-hunspell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosimo%2Fperl5-text-hunspell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosimo%2Fperl5-text-hunspell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosimo%2Fperl5-text-hunspell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cosimo","download_url":"https://codeload.github.com/cosimo/perl5-text-hunspell/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247450531,"owners_count":20940934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T20:36:05.580Z","updated_at":"2025-04-06T07:32:33.269Z","avatar_url":"https://github.com/cosimo.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"NAME\n\nText::Hunspell - Perl interface to the Hunspell library\n\nDESCRIPTION\n\nText::Hunspell is an interface to the GNU Hunspell library.  GNU Hunspell is a\nFree and Open Source spell checker.  The Text::Hunspell module is a thin XS\nwrapper around the Hunspell C++ Library.  Hopefully this is obvious, but you\nMUST have the Hunspell library installed on your system as a .so library,\nbefore installing this module.  You also MUST have any hunspell dictionary\ninstalled for \"make test\" to pass.  \n\nHunspell's location is http://hunspell.sourceforge.net\n\nSee BUILD NOTES and CURRENT ISSUES below before reporting any bugs.\n\nThis module has been built and passed all tests on the following platforms:\n\n    perl 5.8.8 on Linux, gcc version 4.0.1 \n    hunspell 1.2.8 or higher\n    Mandriva Linux 2006\n    Knoppix Linux (Debian Linux)\n\nPlease read SUPPORT below if you have trouble building Text::Hunspell.\n\n\nINSTALLATION\n\nWindows users see below.\n\n1) Install Hunspell and a Dictionary\n\n    Make sure you have a current version of Hunspell installed.\n    You must install both the Hunspell program and a dictionary.\n    They are distributed as separate packages. The dictionary can be\n    copied anywhere, since at startup the full path of the .dic/.aff files\n    will be givern to hunspell.\n\n    Hunspell and the dictionary packages contain README files that include\n    installation instructions.  Here's a basic overview:\n\n    Hunspell must be installed first, then install the dictionary file and finally\n    install the Text::Hunspell module.\n\n    Hunspell installation example:\n    1. download and untar hunspell\n    2. cd hunspell\n    3. ./configure\n    4. ./make\n    5. cd ./src/hunspell\n    6. ./configure\n    7. make\n    8. copy makeso.sh file here\n    9. sh makeso.sh and do manually the copy and 2 link commands\n       as described at the end of makeso.sh\n   10. cd ../tools\n   11. ./configure\n   12. make\n\n \n    If you used a --prefix option to install Hunspell in a non-standard location you\n    will need to adjust your path to include $PREFIX/bin.  The configure script\n    for the dictionary needs to find programs installed in the previous step.\n\n\n    At this point you should be able to run Hunspell in interactive mode.\n    For example:\n    cd hunspell/src/tools\n    ./example full_path_aff full_path_dic file_to test\n\n\n2) Build and install this Text::Hunspell module.\n\n    $ perl Makefile.PL\n    $ make\n    $ make test\n    # make install\n\n\n    If you installed Hunspell in a non-standard location (for example, if\n    you don't have root access) then you will need to tell Makefile.PL where to\n    find the library.\n\n    For example, if Hunspell was installed in $HOME/local (--prefix=$HOME/local)\n    and the perl module should be installed in the perl library $HOME/perl_lib:\n\n    $ perl Makefile.PL PREFIX=$HOME/perl_lib \\\n    CCFLAGS=-I$HOME/local/include \\\n    LIBS=\"-L$HOME/local/lib -lhunspell\"\n\n    $ LD_RUN_PATH=$HOME/local/lib make\n    $ make test\n    $ make install\n\n    Perl must have been buit with thread support in order to work with Text::Hunspell.\n\nWINDOWS USERS\n\nRandy Kobes has provided a PPM and the following instructions for installing\nText::Hunspell on Windows.  Thanks very much Randy.\n\nFor installing on Win32, first get and install the \"Full installer\"\nexecutable at\n\n   http://hunspell.net/win32/\n\nthis will install Hunspell into a location such as C:\\Program Files\\Hunspell. You\nwill also need to fetch and install at least one of the precompiled\ndictionaries found on the same page.\n\nMake sure that the path to the Hunspell bin directory (e.g. C:\\Program\nFiles\\Hunspell\\bin\\) is in your PATH environment variable.  For help with\nsetting your path see \"set environment variables\" in the Windows Help\nUtility.  You may need to reboot or open a new shell window after setting\nyour path.  The Hunspell .dll file must be located in the PATH before using\nText::Hunspell.\n\nThen, to install Text::Hunspell, type at a DOS prompt (all on one line)\n\n   C:\\\u003e ppm install http://theoryx5.uwinnipeg.ca/ppms/Text-Hunspell.ppd\n\nfor an ActivePerl 8xx version, or\n\n   C:\\\u003e ppm install http://theoryx5.uwinnipeg.ca/ppmpackages/Text-Hunspell.ppd\n\nfor an ActivePerl 6xx version.\n\nIf you wish to build Text::Hunspell from source:\n\nIf you want to build Text::Hunspell yourself, you'll need a C compiler, which\nmust be the same one that your Perl is built with (for ActivePerl, this means\nVC++ 6). Assuming you have that, in addition to the \"Full installer\" binary\npackage at http://hunspell.net/win32/, you'll also need to get and install the\nhunspell-dev package (also located at http://hunspell.net/win32/), which contains\nthe necessary .lib and .h files needed to compile the Perl module.\n\nLike above, make sure the PATH environment variable points to the location of\nthe installed Hunspell .dll file before building Text::Hunspell.\n\nInstallation then proceeds as described for the Unix version:\n\n   perl Makefile.PL\n   nmake\n   nmake test\n   nmake install\n\nwith the additional requirement of passing to 'perl Makefile.PL' the\nnecessary arguments (e.g. INC and LIBS) to specify the locations of the lib\nand header files, if these were installed in a non-standard location. Make\nsure that if a non-standard location was used that this is added to your PATH\nenvironment variable before running the tests.\n\n\nSUPPORT\n\nBefore contacting me with problems building Text::Hunspell please try and debug\nas much as possible.\n\nFor example, if \"make test\" fails, then run in verbose mode:\n\n   make test TEST_VERBOSE=1\n\nThat may show at what test is failing.  It's easy to run the test\nscript manually -- and you can even edit and add a few print statements to\naid in debugging.\n\nFor example:\n\n   perl -Iblib/lib -Iblib/arch t/test.t | less\n\nUse of LD_RUN_PATH, CCFLAGS and LIBS as above may also help if the build\nprocess fails.\n\nRemember that you *must* have the English dictionary installed for tests to\npass (sorry, have to check against some dictionary).  Also, you may need to\nset your LANG variable to \"en_US\" so that the English dictionary is selected.\n\nIf all else fails, use the request tracker at:\n\n  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Text-Hunspell\n\n\nBUILD NOTES / CURRENT ISSUES\n\nA number of people have reported the\n\n    $speller-\u003estore_replacement()\n\ntest failing on some platforms.  I don't know why.  Search google to find out\nwhy I don't know why.  The code (from what I can tell) looks like it should be\nreturning an error value, but fails on some platforms.  Until I can get a\nbetter answer I'm going to assume Hunspell is broken and ignore the return value\nin t/test.t.  So don't test the return value in your code, either.\n\nSome users of OS X have reported the test failing after calling clear_session().\nThe test is suppose to see if a word added to the session is removed after calling\nclear_session().  It's another error I have not been able to reproduce on the machines\nI tested on.\n\n\n\"Pax\" provided these notes:\n\n    I just got Text::Hunspell to build and work under OpenBSD 3.7 and thought you\n    might like a tiny suggestion: in the README, you might note that under this\n    operating system you need to add -lstdc++ to the list of libraries you link\n    against, e.g.:\n\n            $ perl Makefile.PL \\\n                   PREFIX=/usr/local INSTALLDIRS=site \\\n                   CCFLAGS=-I/usr/local/include \\\n                   LIBS=\"-L/usr/local/lib -lhunspell -lstdc++\"\n\n    If you don't do this, then any attempt to use Text::Hunspell will throw\n    thousands of unresolved symbol errors trying to load your shared object.\n    This is against libhunspell in /usr/local/lib installed from the hunspell\n    port in the OpenBSD 3.7 ports tree, FWIW.\n\n\nA number of Solaris uses have reported the need to set:\n\n    LDFLAGS='-L/usr/local/lib -R/usr/local/lib'\n\nand also having to copy libstdc++* to /usr/lib.  YMMV.\n\n\nChanges compared to Hunspell::text\n\nhunspell.h was modified, since classe Hunspell was heavily modified between\n1.2.8 and 1.4.x, among others methods spell and suggest got new parameters,\nthat causes the function name to get modified from U _ZN8Hunspell5spellEPKc to\nU _ZN8Hunspell5spellEPKcPiPPc \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosimo%2Fperl5-text-hunspell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcosimo%2Fperl5-text-hunspell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosimo%2Fperl5-text-hunspell/lists"}