Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
ASPELL(1)	       Aspell Abbreviated User's Manual		     ASPELL(1)

       aspell -	interactive spell checker

       aspell [options]	_command_

       aspell is a utility program that	connects to the	Aspell library so that
       it can function as an ispell -a replacement, as	an  independent	 spell
       checker,	 as a test utility to test out Aspell library features,	and as
       a utility for managing dictionaries used	by the library.

       The Aspell library contains an interface	allowing other programs	direct
       access  to  its	functions  and	therefore reducing the complex task of
       spell checking to simple	library	calls.	The default library  does  not
       contain	dictionary  word  lists.  To add language dictionaries,	please
       check your distro first for modified dictionaries, otherwise look  here
       for base	language dictionaries <>.

       The  following  information  describes the commands and options used by
       the Aspell Utility.

       This manual page	is maintained separately from the official  documenta-
       tion  so	 it may	be out of date or incomplete.  The official documenta-
       tion is maintained as a Texinfo manual.	See the	`aspell' entry in info
       for more	complete documentation.

       _command_ is one	of:

       usage, -?
	      Send  a  brief  Aspell Utility usage message to standard output.
	      This is a	short summary listing more common spell-check commands
	      and options.

       help   Send  a detailed Aspell Utility help message to standard output.
	      This is a	complete list showing all commands,  options,  filters
	      and dictionaries.

       version,	-v
	      Print  version  number of	Aspell Library and Utility to standard

       check _file_, -c	_file_
	      Spell-check a single file.

       pipe, -a
	      Run Aspell in ispell -a compatibility mode.

       list   Produce a	list of	misspelled words from standard input.

       [dump] config
	      Dump all current configuration options to	standard output.

       config _key_
	      Send the current value of	_key_ to standard output.

	      Output the soundslike equivalent of each word entered.

       munch  Generate possible	root words and affixes from an input  list  of

       expand [1-4]
	      Expands the affix	flags of each affix compressed word entered.

       clean [strict]
	      Cleans an	input word list	so that	every line is a	valid word.

       munch-list [simple] [single|multi] [keep]
	      Reduce the size of a word	list via affix compression.

       conv _from_ _to_	[_norm-form_]
	      Converts _from_ one encoding _to_	another.

       norm (_norm-map_|_from_ _norm-map_ _to_)	[_norm-form_]
	      Perform Unicode normalization.

       [dump] dicts|filters|modes
	      Lists available dictionaries, filters, or	modes.

       dump|create|merge master|personal|repl _wordlist_
	      dump,  create,  or merge a master, personal, or replacement word

       The following options may be used to control which dictionaries to  use
       and how they behave.

       --master=_name_,	-d _name_
	      Base name	of the dictionary to use.  If this option is specified
	      then Aspell will either use this dictionary or die.

	      Location of the main dictionary word list.

       --lang=_string_,	-l _string_
	      Language to use.	It follows the same format of the  LANG	 envi-
	      ronmental	variable on most systems.  It consists of the two let-
	      ter ISO 639 language code	and an optional	two  letter  ISO  3166
	      country  code  after a dash or underscore.  The default value is
	      based on the value of the	LC_MESSAGES locale.

	      The preferred size of the	dictionary word	list.	This  consists
	      of  a  two char digit code describing the	size of	the list, with
	      typical values of: 10=tiny, 20=really small,  30=small,  40=med-
	      small, 50=med, 60=med-large, 70=large, 80=huge, 90=insane.

	      Any  extra information to	distinguish this variety of dictionary
	      from other dictionaries which may	have the same lang and size.

	      Please use the variety option since it replaces jargon as	a bet-
	      ter choice.  jargon will be removed in the future.

       --word-list-path=_list of directories_
	      Search path for word list	information files.

       --personal=_file_, -p _file_
	      Personal word list file name.

	      Replacements list	file name.

	      Extra dictionaries to use.

	      This option is not yet implemented.

       These options control the behavior of Aspell when checking documents.

       --ignore=_integer_, -W _integer_
	      Ignore words <= _integer_	characters in length.

       --ignore-case, --dont-ignore-case
	      Ignore case when checking	words.

       --ignore-repl, --dont-ignore-repl
	      Ignore commands to store replacement pairs.

       --save-repl, --dont-save-repl
	      Save the replacement word	list on	save all.

	      Suggestion _mode_	= ultra|fast|normal|bad-spellers

       These options modify the	behavior of the	various	filters.

       --add-filter=_list_, --rem-filter=_list_
	      Add or remove a filter.

       --add-filter-path=_paths_, --rem-filter-path=_paths_
	      Add or remove paths searched for filters.

       --mode=_string_,	-e, -H,	-t, -n
	      Sets  the	 filter	 mode.	Mode is	one of none, url, email, html,
	      tex or nroff.  The alternative shortcut  options	are  '-e'  for
	      email, '-H' for Html/Sgml, '-t' for Tex or '-n' for Nroff.

	      encoding the document is expected	to be in.  The default depends
	      on the current locale.

       --add-email-quote=_list_, --rem-email-quote=_list_
	      Add or Remove a list of email quote characters.

	      Number of	chars that can appear before the quote char.

       --add-html-check=_list_,	--rem-html-check=_list_
	      Add or remove a list of HTML attributes to  always  check.   For
	      example, look inside alt=	tags.

       --add-html-skip=_list_, --rem-html-skip=_list_
	      Add  or  remove  a  list of HTML attributes to always skip while
	      spell checking.

       --add-sgml-check=_list_,	--rem-sgml-check=_list_
	      Add or remove a list of SGML  attributes	to  always  check  for

       --add-sgml-skip=_list_, --rem-sgml-skip=_list_
	      Add  or  remove  a  list of SGML attributes to always skip while
	      spell checking.

	      SGML file	extensions.

       --tex-check-comments, --dont-tex-check-comments
	      Check TeX	comments.

       --add-tex-command=_list_, --rem-tex-command=_list_
	      Add or Remove a list of TeX commands.

       These may be used to control the	behavior of run-together words.

       --run-together, --dont-run-together, -C,	-B
	      Consider run-together words valid.

	      Maximum number of	words that can be strung together.

	      Minimal length of	interior words.

       Miscellaneous options that don't	fall under any other category.

       --conf=_file name_
	      Main configuration file.	This file  overrides  Aspell's	global

	      Location of main configuration file.

	      Location of language data	files.

	      Use  this	 keyboard layout for suggesting	possible words.	 These
	      spelling errors happen if	a user accidentally presses a key next
	      to the intended correct key.

	      Alternative  location of language	data files.  This directory is
	      searched before data-dir.

	      Directory	Location for personal wordlist files.

       --per-conf=_file	name_
	      Personal configuration file.  This file overrides	options	 found
	      in the global config file.

       These  options are part of the aspell Utility and work independently of
       the library.

       --backup, --dont-backup,	-b, -x
	      The aspell utility creates a backup file by making  a  copy  and
	      appending	.bak to	file name.  This only applies when the command
	      is check _file_ and the backup  file  is	only  created  if  any
	      spelling modifications take place.

       --byte-offsets, --dont-byte-offsets
	      Use byte offsets instead of character offsets.

       --guess,	--dont-guess, -m, -P
	      Create  missing root/affix combinations not in the dictionary in
	      pipe mode.

       --keymapping=aspell, --keymapping=ispell
	      The keymapping to	use, either aspell for the default mapping  or
	      ispell to	use the	same mapping that the Ispell utility uses.

       --reverse, --dont-reverse
	      Reverse the order	of the suggestions list	in pipe	mode.

       --suggest, --dont-suggest
	      Suggest  possible	 replacements  in pipe mode.  If false,	Aspell
	      will simply report the misspelling and make no attempt  at  sug-
	      gestions or possible corrections.

       --time, --dont-time
	      Time the load time and suggest a time in pipe mode.

       In  addition Aspell will	try to make sense out of Ispell's command line
       options so that it can function as a drop in  replacement  for  Ispell.
       If  Aspell  is  run  without any	command	line options it	will display a
       brief help screen and quit.

       Aspell can accept options via global or personal	configuration files so
       that  you  do  not  need	to specify them	each time at the command line.
       The default global configuration	file is	 /etc/aspell.conf  or  another
       file  specified by option --conf	and is checked first.  The default per
       user configuration file ~/.aspell.conf located in the  $HOME  directory
       (or  another  file  specified by	option --per-conf) is checked next and
       overrides options set in	the global config file.	 Options specified  at
       either the command line or via an environmental variable	override those
       specified by either configuration file.

       Each line of the	configuration file has the format:

	      option [value]

       where option is any one of the standard library options	above  without
       the  leading  dashes.   For example the following line will set the de-
       fault language to Swiss German:

	      lang de_CH

       There may be any	number of spaces between the  option  and  the	value,
       however	it can only be spaces, i.e. there is no	'=' between the	option
       name and	the value.  Comments may also be included  by  preceding  them
       with a '#' as anything from a '#' to a newline is ignored.  Blank lines
       are also	allowed.  The /etc/aspell.conf file is a good example  of  how
       to set these options and	the Aspell Manual has more detailed info.

       aspell-import(1),   prezip-bin(1),  run-with-aspell(1),	word-list-com-

       Aspell is fully documented in its Texinfo manual.  See the `aspell' en-
       try in info for more complete documentation.

       Support	for Aspell can be found	on the Aspell mailing lists.  Instruc-
       tions for joining the various mailing lists (and	an  archive  of	 them)
       can  be found off the Aspell home page at <>.  Bug re-
       ports should be submitted via GitHub Issues rather than being posted to
       the mailing lists.

       This manual page	was written by Brian Nelson <> based on
       the Aspell User's Manual, Copyright (C) 2002 Kevin  Atkinson.   Updated
       Nov  2006 by Jose Da Silva <>, and Dec 2006 by Kevin
       Atkinson	<>.

GNU				  2006-12-10			     ASPELL(1)


Want to link to this manual page? Use this URL:

home | help