DETOX
Section: User Commands (1)
Page Index
BSD mandoc
NAME
inline-detox
- clean up filenames (stream-based)
SYNOPSIS
[-
hnLrv
]
[-
s sequence
]
[-
f configfile
]
file ...
DESCRIPTION
The
utility can remove spaces and other such annoyances from streams.
It'll also translate or cleanup Latin-1 (ISO 8859-1) characters encoded
in 8-bit ASCII, Unicode characters encoded in UTF-8, and CGI escaped characters.
Basically it's detox, but does not operate on files.
Sequences
is driven by a configurable series of filters, called a sequence.
Sequences are covered in more detail in
detoxrc(5)
and are discoverable with the
-
L
option. Some examples of default sequences are
iso8859_1
and
utf_8
Options
The main options:
- -f configfile
-
Use
configfile
instead of the default configuration files for loading translation
sequences. No other config file will be parsed.
- -h -help
-
Display helpful information.
- -L
-
List the currently available sequences. When paired with
-v
this option shows what filters are used in each sequence and any
properties applied to the filters.
- -r
-
Recurse into subdirectories.
- -s sequence
-
Use
sequence
instead of default.
- -v
-
Be verbose about which files are being renamed.
- -V
-
Show the current version of
.
Deprecated Options
Deprecated Options are options that were available in earlier versions
of
but have lost their meaning and are being phased out.
- --remove-trailing
-
Removes _ and - after .'s in filenames. This was first provided in
the 0.9 series of
.
After the introduction of sequences, it lost its meaning, as you could
now determine the properties of wipeup through a particular sequence's
configuration. It presently forces all instances of the wipeup filter
to use remove trailing, regardless of what's actually in the config
files.
FILES
- detoxrc
-
The system-wide detoxrc file.
- ~/.detoxrc
-
A user's personal detoxrc. Normally it extends the system-wide
detoxrc, unless
-f
has been specified, in which case, it is ignored.
- iso8859_1.tbl
-
The default ISO 8859-1 translation table.
- unicode.tbl
-
The default Unicode (UTF-8) translation table.
EXAMPLES
- echo "Foo Bar" | -s iso8859_1 -v
-
Will run the sequence
iso8859_1
listing any changes and returning the result to STDOUT.
SEE ALSO
detox(1),
detoxrc(5),
detox.tbl5.
HISTORY
detox
was originally designed to clean up files that I had received from
friends which had been created using other operating systems. It's
trivial to create a filename with spaces, parenthesis, brackets, and
ampersands under some operating systems. These have special meaning
within FreeBSD and Linux, and cause problems when you go to access
them. I created
to clean up these files.
AUTHORS
was written by
An Doug Harple .
BUGS
Long options don't work under Solaris or Darwin.
An error in the config file will cause a segfault as it's going to
print the offending word within the config file.