File: ispell.el.html

INSTRUCTIONS

  Use the variable ispell-local-dictionary-alist to specify
your own dictionaries.

 Depending on the mail system you use, you may want to include these:
 (add-hook 'news-inews-hook #'ispell-message)
 (add-hook 'mail-send-hook #'ispell-message)
 (add-hook 'mh-before-send-letter-hook #'ispell-message)

  Ispell has a TeX parser and a nroff parser (the default).
The parsing is controlled by the variable ispell-parser. Currently it is just a "toggle" between TeX and nroff, but if more parsers are added it will be updated. See the variable description for more info.

TABLE OF CONTENTS

  ispell-word
  ispell-region
  ispell-buffer
  ispell-message
  ispell-comments-and-strings
  ispell-comment-or-string-at-point
  ispell-continue
  ispell-complete-word
  ispell-complete-word-interior-frag
  ispell-change-dictionary
  ispell-kill-ispell
  ispell-pdict-save
  ispell-skip-region-alist

Commands in ispell-region: Character replacement: Replace word with choice. May query-replace.
 : Accept word this time.
i: Accept word and insert into personal dictionary. a: Accept word for this session. A: Accept word and place in buffer-local dictionary. r: Replace word with typed-in value. Rechecked. R: Replace word with typed-in value. Query-replaced in buffer. Rechecked.
?: Show these commands
x: Exit spelling buffer. Move cursor to original point. X: Exit spelling buffer. Leaves cursor at the current point, and permits
     the check to be completed later.
q: Quit spelling session (Kills ispell process). l: Look up typed-in replacement in alternate dictionary. Wildcards okay. u: Like i, but the word is lower-cased first. m: Place entered value in personal dictionary, then recheck current word. C-l: redraws screen C-r: recursive edit C-z: suspend Emacs or iconify frame

Buffer-Local features: There are a number of buffer-local features that can be used to customize
 ispell for the current buffer. This includes language dictionaries,
 personal dictionaries, parsing, and local word spellings. Each of these
 local customizations are done either through local variables, or by
 including the keyword and argument(s) at the end of the buffer (usually
 prefixed by the comment characters). See the end of this file for
 examples. The local keywords and variables are:

 ispell-dictionary-keyword language-dictionary
     uses local variable ispell-local-dictionary
 ispell-pdict-keyword personal-dictionary
     uses local variable ispell-local-pdict
 ispell-parsing-keyword mode-arg extended-char-arg
 ispell-words-keyword any number of local word spellings

Region skipping:
 Place new regular expression definitions of regions you prefer not to
 spell check in ispell-skip-region-alist. Mode-dependent features can
 be added to latex by modifying ispell-tex-skip-alists.
 ispell-message contains some custom skipping code for e-mail messages.

BUGS:
 Need a way to select between different character mappings without separate
   dictionary entries.
 Multi-byte characters if not defined by current dictionary may result in the
   evil "misalignment error" in some versions of Emacs.
 On some versions of Emacs, growing the minibuffer fails.
   see ispell-help-in-bufferp.
 Recursive edits (?C-r or ?R) inside a keyboard text replacement check (?r)
   can cause misalignment errors.

Defined variables (89)

ispell--aspell-found-dictionariesAn alist of identified aspell dictionaries.
ispell-alternate-dictionaryAlternate plain word-list dictionary for spelling help.
ispell-aspell-data-dirData directory of Aspell.
ispell-aspell-dict-dirDictionary directory of Aspell.
ispell-aspell-dictionary-alistAn alist of parsed Aspell dicts and associated parameters.
ispell-async-processpNon-nil means that the OS supports asynchronous processes.
ispell-buffer-local-nameContains the buffer name if local word definitions were used.
ispell-buffer-session-localwordsList of words accepted for session in this buffer.
ispell-change-dictionary-hookHook run after changing dictionary.
ispell-check-commentsSpelling of comments checked when non-nil.
ispell-check-onlyIf non-nil, ‘ispell-word’ does not try to correct the word.
ispell-checking-messageNon-nil when we’re checking a mail message.
ispell-choices-win-default-heightThe default size of the ‘*Choices*’ window, including the mode line.
ispell-cmd-argsCommand-line arguments to pass to a synchronous Ispell subprocess.
ispell-complete-word-dictPlain word-list dictionary used for word completion.
ispell-current-dictionaryThe name of the current dictionary, or nil for the default.
ispell-current-personal-dictionaryThe name of the current personal dictionary, or nil for the default.
ispell-dictionaryDefault dictionary to use if ‘ispell-local-dictionary’ is nil.
ispell-dictionary-alistAn alist of dictionaries and their associated parameters.
ispell-dictionary-base-alistBase value for ‘ispell-dictionary-alist’.
ispell-dictionary-keywordThe keyword for a local dictionary to use.
ispell-dicts-name2locale-equivs-alistAlist with known matching locales for standard dict names.
ispell-enchant-dictionary-alistAn alist of parsed Enchant dicts and associated parameters.
ispell-encoding8-commandCommand line option prefix to select encoding if supported, nil otherwise.
ispell-extra-argsIf non-nil, a list of extra switches to pass to the Ispell program.
ispell-filterOutput filter from piped calls to Ispell.
ispell-filter-continueControl variable for Ispell filter function.
ispell-following-wordNon-nil means ‘ispell-word’ checks the word around or after point.
ispell-format-wordFormatting function for displaying word being spell checked.
ispell-format-word-functionFormatting function for displaying word being spell checked.
ispell-grep-commandName of the grep command for search processes.
ispell-grep-optionsString of options to use when running the program in ‘ispell-grep-command’.
ispell-have-new-lookNon-nil means use the ‘-r’ option (regexp) when running ‘look’.
ispell-help-in-bufferpNon-nil means display interactive keymap help in a buffer.
ispell-help-timeoutThe number of seconds to display the help text.
ispell-highlight-faceFace used for Ispell highlighting.
ispell-highlight-pHighlight spelling errors when non-nil.
ispell-html-skip-alistsLists of start and end keys to skip in HTML buffers.
ispell-hunspell-dict-paths-alistAlist of parsed Hunspell dicts and associated affix files.
ispell-hunspell-dictionary-alistAlist of parsed Hunspell dicts and associated parameters.
ispell-initialize-spellchecker-hookNormal hook run on spellchecker initialization.
ispell-keep-choices-winIf non-nil, keep the ‘*Choices*’ window for the entire spelling session.
ispell-last-program-nameLast value of ‘ispell-program-name’. Internal use.
ispell-lazy-highlightControls the lazy-highlighting of spelling errors.
ispell-library-directoryDirectory where ispell dictionaries reside.
ispell-local-dictionaryIf non-nil, the dictionary to be used for Ispell commands in this buffer.
ispell-local-dictionary-alistList of local or customized dictionary definitions.
ispell-local-dictionary-overriddenNon-nil means the user has explicitly set this buffer’s Ispell dictionary.
ispell-local-pdictA buffer local variable containing the current personal dictionary.
ispell-look-commandName of the look command for search processes.
ispell-look-optionsString of command options for ‘ispell-look-command’.
ispell-look-pNon-nil means use ‘look’ rather than ‘grep’.
ispell-menu-mapKey map for ispell menu.
ispell-message-dictionary-alistList used by ‘ispell-message’ to select a new dictionary.
ispell-message-fcc-skipQuery before saving Fcc message copy if attachment larger than this value.
ispell-message-text-endText beyond which ‘ispell-message’ will not spell-check.
ispell-minor-keymapKeymap used for Ispell minor mode.
ispell-minor-modeNon-nil if ISpell minor mode is enabled.
ispell-minor-mode-hookHook run after entering or leaving ‘ispell-minor-mode’.
ispell-output-bufferBuffer used for reading output of a synchronous Ispell subprocess.
ispell-overlayOverlay variable for Ispell highlighting.
ispell-parserIndicates whether ispell should parse the current buffer as TeX Code.
ispell-parsing-keywordThe keyword for overriding default Ispell parsing.
ispell-pdict-keywordThe keyword for defining buffer local dictionaries.
ispell-pdict-modified-pNon-nil means personal dictionary has modifications to be saved.
ispell-personal-dictionaryFile name of your personal spelling dictionary, or nil.
ispell-processThe process object for Ispell.
ispell-process-directoryThe directory where ‘ispell-process’ was started.
ispell-program-nameProgram invoked by M-$ and M-x ispell-region commands.
ispell-query-replace-choicesCorrections made throughout region when non-nil.
ispell-query-replace-markerMarker for ‘query-replace’ processing.
ispell-quietlyNon-nil means suppress messages in ‘ispell-word’.
ispell-really-aspellNon-nil if we can use Aspell extensions.
ispell-really-enchantNon-nil if we can use Enchant extensions.
ispell-really-hunspellNon-nil if we can use Hunspell extensions.
ispell-recursive-edit-markerMarker for return point from recursive edit.
ispell-region-endMarker that allows spelling continuations.
ispell-session-bufferBuffer used for passing input to a synchronous Ispell subprocess.
ispell-silently-savepWhen non-nil, save personal dictionary without asking for confirmation.
ispell-skip-htmlIndicates whether ispell should skip spell checking of SGML markup.
ispell-skip-region-alistAlist expressing beginning and end of regions not to spell check.
ispell-skip-tibDoes not spell check ‘tib’ bibliography references when non-nil.
ispell-tex-skip-alistsLists of regions to be skipped in TeX mode.
ispell-tib-ref-beginningRegexp matching the beginning of a Tib reference.
ispell-tib-ref-endRegexp matching the end of a Tib reference.
ispell-update-post-hookA normal hook invoked from the ispell command loop.
ispell-use-framepop-pWhen non-nil ispell uses framepop to display choices in a dedicated frame.
ispell-use-ptys-pWhen non-nil, Emacs uses ptys to communicate with Ispell.
ispell-words-keywordThe keyword for local oddly-spelled words to accept.

Defined functions (89)

check-ispell-version(&optional INTERACTIVEP)
ispell()
ispell--\w-filter(CHAR)
ispell--call-enchant-lsmod(&rest ARGS)
ispell--get-extra-word-characters(&optional LANG)
ispell--make-\w-expression(CHARS)
ispell--make-filename-or-URL-re()
ispell--run-on-word(WORD)
ispell-accept-buffer-local-defs()
ispell-accept-output(&optional TIMEOUT-SECS TIMEOUT-MSECS)
ispell-add-per-file-word-list(WORD)
ispell-aspell-add-aliases(ALIST)
ispell-aspell-find-dictionary(DICT-NAME)
ispell-begin-skip-region(SKIP-ALIST)
ispell-begin-skip-region-regexp()
ispell-begin-tex-skip-regexp()
ispell-buffer()
ispell-buffer-local-dict(&optional NO-RELOAD)
ispell-buffer-local-parsing()
ispell-buffer-local-words()
ispell-buffer-with-debug(&optional APPEND)
ispell-call-process(&rest ARGS)
ispell-call-process-region(&rest ARGS)
ispell-change-dictionary(DICT &optional ARG)
ispell-check-version(&optional INTERACTIVEP)
ispell-command-loop(MISS GUESS WORD START END)
ispell-comment-or-string-at-point()
ispell-comments-and-strings(&optional START END)
ispell-complete-word(&optional INTERIOR-FRAG)
ispell-complete-word-interior-frag()
ispell-completion-at-point()
ispell-continue()
ispell-correct-p(&optional FOLLOWING)
ispell-create-debug-buffer(&optional APPEND)
ispell-display-buffer(BUFFER)
ispell-error-checking-word(WORD)
ispell-filter(PROCESS OUTPUT)
ispell-find-aspell-dictionaries()
ispell-find-enchant-dictionaries()
ispell-find-hunspell-dictionaries(&optional DICTIONARY)
ispell-get-aspell-config-value(KEY)
ispell-get-casechars()
ispell-get-coding-system()
ispell-get-decoded-string(N)
ispell-get-extended-character-mode()
ispell-get-ispell-args()
ispell-get-line(START END IN-COMMENT)
ispell-get-many-otherchars-p()
ispell-get-not-casechars()
ispell-get-otherchars()
ispell-get-word(FOLLOWING &optional EXTRA-OTHERCHARS)
ispell-help()
ispell-highlight-spelling-error(START END &optional HIGHLIGHT REFRESH)
ispell-highlight-spelling-error-generic(START END &optional HIGHLIGHT REFRESH)
ispell-highlight-spelling-error-overlay(START END &optional HIGHLIGHT)
ispell-horiz-scroll()
ispell-hunspell-add-multi-dic(DICT)
ispell-hunspell-fill-dictionary-entry(DICT)
ispell-ignore-fcc(START END)
ispell-init-process()
ispell-internal-change-dictionary()
ispell-kill-ispell(&optional NO-ERROR CLEAR)
ispell-looking-at(STRING)
ispell-lookup-words(WORD &optional LOOKUP-DICT)
ispell-message()
ispell-mime-multipartp(&optional LIMIT)
ispell-mime-skip-part(BOUNDARY)
ispell-minor-check()
ispell-minor-mode(&optional ARG)
ispell-non-empty-string(STRING)
ispell-parse-hunspell-affix-file(DICT-KEY)
ispell-parse-output(OUTPUT &optional ACCEPT-LIST SHIFT)
ispell-pdict-save(&optional NO-QUERY FORCE-SAVE)
ispell-print-if-debug(FORMAT &rest ARGS)
ispell-process-line(STRING SHIFT)
ispell-process-status()
ispell-region(REG-START REG-END &optional RECHECKP SHIFT)
ispell-send-replacement(MISSPELLED REPLACEMENT)
ispell-send-string(STRING)
ispell-set-spellchecker-params()
ispell-show-choices()
ispell-skip-region(KEY)
ispell-skip-region-list()
ispell-start-process()
ispell-tex-arg-end(&optional ARG)
ispell-valid-dictionary-list()
ispell-with-safe-default-directory(&rest BODY)
ispell-word(&optional FOLLOWING QUIETLY CONTINUE REGION)
lookup-words(WORD &optional LOOKUP-DICT)

Defined faces (0)