php-src/ext/pspell
Peter Kokot 92ac598aab Remove local variables
This patch removes the so called local variables defined per
file basis for certain editors to properly show tab width, and
similar settings. These are mainly used by Vim and Emacs editors
yet with recent changes the once working definitions don't work
anymore in Vim without custom plugins or additional configuration.
Neither are these settings synced across the PHP code base.

A simpler and better approach is EditorConfig and fixing code
using some code style fixing tools in the future instead.

This patch also removes the so called modelines for Vim. Modelines
allow Vim editor specifically to set some editor configuration such as
syntax highlighting, indentation style and tab width to be set in the
first line or the last 5 lines per file basis. Since the php test
files have syntax highlighting already set in most editors properly and
EditorConfig takes care of the indentation settings, this patch removes
these as well for the Vim 6.0 and newer versions.

With the removal of local variables for certain editors such as
Emacs and Vim, the footer is also probably not needed anymore when
creating extensions using ext_skel.php script.

Additionally, Vim modelines for setting php syntax and some editor
settings has been removed from some *.phpt files.  All these are
mostly not relevant for phpt files neither work properly in the
middle of the file.
2019-02-03 21:03:00 +01:00
..
tests Trim trailing whitespace in tests 2018-10-14 12:07:20 -03:00
config.m4 Remove unused Git attributes ident 2018-07-25 00:53:25 +02:00
config.w32 Sync leading and final newlines in source code files 2018-10-14 12:56:38 +02:00
CREDITS
php_pspell.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
pspell.c Remove local variables 2019-02-03 21:03:00 +01:00
README Sync leading and final newlines in source code files 2018-10-14 12:56:38 +02:00

README file for pspell (spellchecker) module for PHP
----------------------------------------------------

The latest release of pspell is always available from

  http://aspell.net/

This module was developed and tested with aspell-.31.1 and pspell-.11.0.2,
although slightly earlier (and hopefully later) versions of those libraries
should work as well.

General notes
-------------

Please, note that somewhere around version .27.x (I believe) aspell stopped
working with the aspell module for php. This is due to the fact that the
author changed things around a bit, and suggested that people link to pspell
in the future rather than to aspell. That's exactly what this module is for.
It has the same basic functionality as aspell (and more features are being
added). I did not want to modify existing aspell module, because it would
break things for those who are using older aspell, or result in very ugly code.
Rather, I wrote a new module - pspell.


Building pspell on a Unix system
--------------------------------

In order to use pspell, you need to have *both* aspell and pspell libraries
installed, and they have to be compatible with each other. Get the latest
release of both at the URL given above.

I expect the libraries to be in /usr/local (that's the default when you
cofigure pspell and aspell with their 'configure' scripts woth no parameters).
If that location is different, please specify it in --with-pspell=PATH, where
PATH is the path you specified for pspell libraries.

Notes on personalized dictionaries
----------------------------------

It is now possible to have personalized dictionaries with pspell. This is
achieved by opening a dictionary with pspell_new_personal() rather than
pspell_new() and specifying the custom dictionary as the first parameter.
The parameter probably should begin with '/' because otherwise it will
be relative to $HOME, which is probably set to "/root". This is probably not
what you want because you need write access for nobody to be able to write
to a dictionary. Once the dictionary is open, you can use
pspell_add_to_personal() to add words to the wordlist and finally
pspell_save_wordlist() to save it.

Note that at this moment pspell_save_wordlist() will return TRUE, even if
there was an error. This will be changed once pspell library is fixed.