shpell 1.0 (c) 2020 Carl Svensson.
A spellchecker written in POSIX sh.

 Usage
=======
Start shpell from the command line:
  shpell [OPTION] [ARGUMENT]

When called without options, shpell will spellcheck STDIN:
  shpell < FILE
  cat FILE | shpell

Misspelled words will be printed, one per line, to STDOUT.

Options:
  -h
    Show short help.
  --help
    Show this extensive help and program information.
  -c, --check [FILE]
    Spellcheck FILE if given, otherwise STDIN. Example:
      shpell -c FILE
      cat FILE | shpell --check
  -m, --html [FILE]
    Like --check, but try to strip away HTML markup from input.
      shpell -m FILE
      cat FILE | shpell --html
  -l, --list
    List contents of personal dictionary.
  -a, --add WORD
    Add WORD to personal dictionary.
  -d, --del WORD
    Delete WORD from personal dictionary.
  --purge
    Purge entire personal dictionary.
  --license
    Print software license.

 Personal Dictionary
=====================
The personal dictionary is for adding words on a per-user basis.
Words added to the personal dictionary will be written to a file
called ".shpdict" in the user's home directory.

 Global Dictionary
===================
Since most Unix-like systems comes with at least one dictionary file,
shpell relies on this file for the bulk of its operations. The global
dictionary can also be configured on a per-user basis.

The currently configured path to the global dictionary file is:
  /usr/share/dict/words

A file called ".shpellrc" can be created in a user's home directory.
It should contain just a path to a custom global dictionary, which
will be used in place of the default. Example:
  echo "/usr/share/dict/british-english" > "$HOME/.shpellrc"

 Known issues
==============
 * Tested with English dictionaries only.
 * HTML tag stripping is rudimentary at best.
 * Files with a lot of UTF-8 punctuation marks will likely cause
   problems.

 License
=========
Usage of the works is permitted provided that this instrument is
retained with the works, so that any entity that uses the works is
notified of this instrument.
DISCLAIMER: THE WORKS ARE WITHOUT WARRANTY.
