Spell Check Utilities
Utilities for spell checking packages via Aspell, Hunspell or Ispell.
aspell_package_Rd_files(dir, drop = c("\\author", "\\references"), control = list(), program = NULL, dictionaries = character()) aspell_package_vignettes(dir, control = list(), program = NULL, dictionaries = character()) aspell_package_R_files(dir, ignore = character(), control = list(), program = NULL, dictionaries = character()) aspell_package_C_files(dir, ignore = character(), control = list(), program = NULL, dictionaries = character())
aspell_write_personal_dictionary_file(x, out, language = "en", program = NULL)
- a character string specifying the path to a package's root directory.
- a character vector naming additional Rd sections to drop
when selecting text via
- a list or character vector of control options for the spell checker.
- a character string giving the name (if on the system
path) or full path of the spell check program to be used, or
NULL(default). By default, the system path is searched for
aspell, hunspell and ispell (in that order), and the first one found is used.
- a character vector of names or file paths of
additional R level dictionaries to use. See
- a character vector with regular expressions to be replaced by blanks when filtering the message strings.
- a character vector, or the result of a call to
- a character string naming the personal dictionary file to write to.
- a character string indicating a language as used by Aspell.
aspell_package_C_files perform spell checking on the Rd files,
vignettes, R files, and C-level messages of the package with root
dir. They determine the respective files, apply the
appropriate filters, and run the spell checker.
aspell for details on filters.
The C-level message string are obtained from the
dir. See the section on
When using Aspell, the vignette checking skips parameters and/or
options of commands
control argument. E.g., to skip both option and parameter of
Suitable values for
ignore can also be
specified using a package defaults file which should go as
and provides defaults via assignments of suitable named lists, e.g.,
vignettes <- list(control = "--add-tex-command='mycmd op'")
for vignettes (when using Aspell) and similarly assigning to
C_files for Rd files, R
files and C level message defaults.
Maintainers of packages using both English and American spelling will find it convenient to pass control options and to Aspell and control options to Hunspell (provided that the corresponding dictionaries are installed).
Older versions of Rhad no support for R level dictionaries, and
hence provided the function
aspell_write_personal_dictionary_file to create (spell check)
program-specific personal dictionary files from words to be accepted.
The new mechanism is to use R level dictionaries, i.e.,
saveRDS. For such dictionaries specified via the
package defaults mechanism, elements with no path separator can be R
system dictionaries or dictionaries in the