{
    "mode": "man",
    "parameter": "aspell",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/aspell/1/json",
    "generated": "2026-06-02T21:25:57Z",
    "synopsis": "aspell [options] <command>",
    "sections": {
        "NAME": {
            "content": "aspell - interactive spell checker\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "aspell [options] <command>\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "aspell is a utility program that connects to the Aspell library so that it can function as an\nispell -a replacement, as an independent spell checker, as a test utility to test out  Aspell\nlibrary features, and as a utility for managing dictionaries used by the library.\n\nThe  Aspell  library contains an interface allowing other programs direct access to its func‐\ntions and therefore reducing the complex task of spell checking to simple library calls.  The\ndefault library does not contain dictionary word lists.  To add language dictionaries, please\ncheck your distro first for modified dictionaries, otherwise look here for base language dic‐\ntionaries <http://aspell.net>.\n\nThe following information describes the commands and options used by the Aspell Utility.\n\nThis manual page is maintained separately from the official documentation so it may be out of\ndate or incomplete.  The official documentation is maintained as a Texinfo manual.   See  the\n`aspell' entry in info for more complete documentation.\n",
            "subsections": []
        },
        "COMMANDS": {
            "content": "<command> is one of:\n\nusage, -?\nSend a brief Aspell Utility usage message to standard output.  This is a short summary\nlisting more common spell-check commands and options.\n\nhelp   Send a detailed Aspell Utility help message to standard output.  This  is  a  complete\nlist showing all commands, options, filters and dictionaries.\n\nversion, -v\nPrint version number of Aspell Library and Utility to standard output.\n\ncheck <file>, -c <file>\nSpell-check a single file.\n\npipe, -a\nRun Aspell in ispell -a compatibility mode.\n\nlist   Produce a list of misspelled words from standard input.\n\n[dump] config\nDump all current configuration options to standard output.\n\nconfig <key>\nSend the current value of <key> to standard output.\n",
            "subsections": [
                {
                    "name": "soundslike",
                    "content": "Output the soundslike equivalent of each word entered.\n\nmunch  Generate possible root words and affixes from an input list of words.\n\nexpand [1-4]\nExpands the affix flags of each affix compressed word entered.\n\nclean [strict]\nCleans an input word list so that every line is a valid word.\n\nmunch-list [simple] [single|multi] [keep]\nReduce the size of a word list via affix compression.\n\nconv <from> <to> [<norm-form>]\nConverts <from> one encoding <to> another.\n\nnorm (<norm-map>|<from> <norm-map> <to>) [<norm-form>]\nPerform Unicode normalization.\n\n[dump] dicts|filters|modes\nLists available dictionaries, filters, or modes.\n\ndump|create|merge master|personal|repl <wordlist>\ndump, create, or merge a master, personal, or replacement word list.\n"
                }
            ]
        },
        "DICTIONARY OPTIONS": {
            "content": "The following options may be used to control which dictionaries to use and how they behave.\n\n--master=<name>, -d <name>\nBase  name of the dictionary to use.  If this option is specified then Aspell will ei‐\nther use this dictionary or die.\n\n--dict-dir=<directory>\nLocation of the main dictionary word list.\n\n--lang=<string>, -l <string>\nLanguage to use.  It follows the same format of the  LANG  environmental  variable  on\nmost systems.  It consists of the two letter ISO 639 language code and an optional two\nletter ISO 3166 country code after a dash or underscore.  The default value  is  based\non the value of the LCMESSAGES locale.\n\n--size=<string>\nThe  preferred  size  of  the dictionary word list.  This consists of a two char digit\ncode describing the size of the list,  with  typical  values  of:  10=tiny,  20=really\nsmall, 30=small, 40=med-small, 50=med, 60=med-large, 70=large, 80=huge, 90=insane.\n\n--variety=<string>\nAny  extra information to distinguish this variety of dictionary from other dictionar‐\nies which may have the same lang and size.\n\n--jargon=<string>\nPlease use the variety option since it replaces jargon as  a  better  choice.   jargon\nwill be removed in the future.\n\n--word-list-path=<list of directories>\nSearch path for word list information files.\n\n--personal=<file>, -p <file>\nPersonal word list file name.\n\n--repl=<file>\nReplacements list file name.\n\n--extra-dicts=<list>\nExtra dictionaries to use.\n",
            "subsections": [
                {
                    "name": "--ignore-accents",
                    "content": "This option is not yet implemented.\n",
                    "long": "--ignore-accents"
                }
            ]
        },
        "CHECKER OPTIONS": {
            "content": "These options control the behavior of Aspell when checking documents.\n\n--ignore=<integer>, -W <integer>\nIgnore words <= <integer> characters in length.\n\n--ignore-case, --dont-ignore-case\nIgnore case when checking words.\n\n--ignore-repl, --dont-ignore-repl\nIgnore commands to store replacement pairs.\n\n--save-repl, --dont-save-repl\nSave the replacement word list on save all.\n\n--sug-mode=<mode>\nSuggestion <mode> = ultra|fast|normal|bad-spellers\n",
            "subsections": []
        },
        "FILTER OPTIONS": {
            "content": "These options modify the behavior of the various filters.\n\n--add-filter=<list>, --rem-filter=<list>\nAdd or remove a filter.\n\n--add-filter-path=<paths>, --rem-filter-path=<paths>\nAdd or remove paths searched for filters.\n\n--mode=<string>, -e, -H, -t, -n\nSets  the  filter mode.  Mode is one of none, url, email, html, tex or nroff.  The al‐\nternative shortcut options are '-e' for email, '-H' for Html/Sgml,  '-t'  for  Tex  or\n'-n' for Nroff.\n\n--encoding=<string>\nencoding  the  document  is expected to be in.  The default depends on the current lo‐\ncale.\n\n--add-email-quote=<list>, --rem-email-quote=<list>\nAdd or Remove a list of email quote characters.\n\n--email-margin=<integer>\nNumber of chars that can appear before the quote char.\n\n--add-html-check=<list>, --rem-html-check=<list>\nAdd or remove a list of HTML attributes to always check.   For  example,  look  inside\nalt= tags.\n\n--add-html-skip=<list>, --rem-html-skip=<list>\nAdd or remove a list of HTML attributes to always skip while spell checking.\n\n--add-sgml-check=<list>, --rem-sgml-check=<list>\nAdd or remove a list of SGML attributes to always check for spelling.\n\n--add-sgml-skip=<list>, --rem-sgml-skip=<list>\nAdd or remove a list of SGML attributes to always skip while spell checking.\n\n--sgml-extension=<list>\nSGML file extensions.\n\n--tex-check-comments, --dont-tex-check-comments\nCheck TeX comments.\n\n--add-tex-command=<list>, --rem-tex-command=<list>\nAdd or Remove a list of TeX commands.\n",
            "subsections": []
        },
        "RUN-TOGETHER WORD OPTIONS": {
            "content": "These may be used to control the behavior of run-together words.\n\n--run-together, --dont-run-together, -C, -B\nConsider run-together words valid.\n\n--run-together-limit=<integer>\nMaximum number of words that can be strung together.\n\n--run-together-min=<integer>\nMinimal length of interior words.\n",
            "subsections": []
        },
        "MISC OPTIONS": {
            "content": "Miscellaneous options that don't fall under any other category.\n\n--conf=<file name>\nMain configuration file.  This file overrides Aspell's global defaults.\n\n--conf-dir=<directory>\nLocation of main configuration file.\n\n--data-dir=<directory>\nLocation of language data files.\n\n--keyboard=<keyboard>\nUse  this keyboard layout for suggesting possible words.  These spelling errors happen\nif a user accidentally presses a key next to the intended correct key.\n\n--local-data-dir=<directory>\nAlternative location of language  data  files.   This  directory  is  searched  before\ndata-dir.\n\n--home-dir=<directory>\nDirectory Location for personal wordlist files.\n\n--per-conf=<file name>\nPersonal  configuration  file.  This file overrides options found in the global config\nfile.\n",
            "subsections": []
        },
        "ASPELL UTILITY OPTIONS": {
            "content": "These options are part of the aspell Utility and work independently of the library.\n\n--backup, --dont-backup, -b, -x\nThe aspell utility creates a backup file by making a copy and appending .bak  to  file\nname.   This only applies when the command is check <file> and the backup file is only\ncreated if any spelling modifications take place.\n\n--byte-offsets, --dont-byte-offsets\nUse byte offsets instead of character offsets.\n\n--guess, --dont-guess, -m, -P\nCreate missing root/affix combinations not in the dictionary in pipe mode.\n\n--keymapping=aspell, --keymapping=ispell\nThe keymapping to use, either aspell for the default mapping or ispell to use the same\nmapping that the Ispell utility uses.\n\n--reverse, --dont-reverse\nReverse the order of the suggestions list in pipe mode.\n\n--suggest, --dont-suggest\nSuggest  possible  replacements in pipe mode.  If false, Aspell will simply report the\nmisspelling and make no attempt at suggestions or possible corrections.\n\n--time, --dont-time\nTime the load time and suggest a time in pipe mode.\n\nIn addition Aspell will try to make sense out of Ispell's command line options so that it can\nfunction  as a drop in replacement for Ispell.  If Aspell is run without any command line op‐\ntions it will display a brief help screen and quit.\n",
            "subsections": []
        },
        "CONFIGURATION": {
            "content": "Aspell can accept options via global or personal configuration files so that you do not  need\nto  specify  them  each  time  at the command line.  The default global configuration file is\n/etc/aspell.conf or another file specified by option --conf and is checked  first.   The  de‐\nfault  per  user configuration file ~/.aspell.conf located in the $HOME directory (or another\nfile specified by option --per-conf) is checked next and overrides options set in the  global\nconfig  file.   Options specified at either the command line or via an environmental variable\noverride those specified by either configuration file.\n\nEach line of the configuration file has the format:\n\noption [value]\n\nwhere option is any one of the standard library options above  without  the  leading  dashes.\nFor example the following line will set the default language to Swiss German:\n\nlang deCH\n\nThere  may  be  any number of spaces between the option and the value, however it can only be\nspaces, i.e. there is no '=' between the option name and the value.  Comments may also be in‐\ncluded  by  preceding  them with a '#' as anything from a '#' to a newline is ignored.  Blank\nlines are also allowed.  The /etc/aspell.conf file is a good example of how to set these  op‐\ntions and the Aspell Manual has more detailed info.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "aspell-import(1), prezip-bin(1), run-with-aspell(1), word-list-compress(1)\n\nAspell  is  fully  documented in its Texinfo manual.  See the `aspell' entry in info for more\ncomplete documentation.\n",
            "subsections": []
        },
        "SUPPORT": {
            "content": "Support for Aspell can be found on the Aspell mailing lists.  Instructions  for  joining  the\nvarious  mailing  lists  (and  an  archive  of them) can be found off the Aspell home page at\n<http://aspell.net>.  Bug reports should be submitted via GitHub  Issues  rather  than  being\nposted to the mailing lists.\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "This  manual  page  was  written by Brian Nelson <pyro@debian.org> based on the Aspell User's\nManual, Copyright ©  2002  Kevin  Atkinson.   Updated  Nov  2006  by  Jose  Da  Silva  <digi‐\ntal@joescat.com>, and Dec 2006 by Kevin Atkinson <kevina@gnu.org>.\n\n\n\n\nGNU                                          2006-12-10                                    ASPELL(1)",
            "subsections": []
        }
    },
    "summary": "aspell - interactive spell checker",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "aspell-import",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/aspell-import/1/json"
        },
        {
            "name": "prezip-bin",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/prezip-bin/1/json"
        },
        {
            "name": "run-with-aspell",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/run-with-aspell/1/json"
        },
        {
            "name": "word-list-compress",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/word-list-compress/1/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Interactive spell checker.",
        "examples": [
            {
                "description": "Spell check a single file",
                "command": "aspell check {{path/to/file}}"
            },
            {
                "description": "List misspelled words from `stdin`",
                "command": "cat {{path/to/file}} | aspell list"
            },
            {
                "description": "Show available dictionary languages",
                "command": "aspell dicts"
            },
            {
                "description": "Run `aspell` with a different language (takes two-letter ISO 639 language code)",
                "command": "aspell --lang {{cs}}"
            },
            {
                "description": "List misspelled words from `stdin` and ignore words from personal word list",
                "command": "cat {{path/to/file}} | aspell --personal {{personal-word-list.pws}} list"
            }
        ]
    }
}