"Fossies" - the Fresh Open Source Software Archive

Member "detox-1.4.5/man/inline-detox.1" (15 Aug 2021, 3440 Bytes) of package /linux/privat/detox-1.4.5.tar.gz:

Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even erroneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the last Fossies "Diffs" side-by-side code changes report for "inline-detox.1": 1.4.0_vs_1.4.1.

DETOX(1) BSD General Commands Manual DETOX(1)

NAME

inline-detox — clean up filenames (stream-based)

SYNOPSIS

inline-detox [−hnLrv] [−s sequence] [−f configfile] file ...

DESCRIPTION

The inline-detox 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
inline-detox 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 inline-detox.

Deprecated Options
Deprecated Options are options that were available in earlier versions of inline-detox 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 inline-detox. 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 | inline-detox −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.tbl(5).

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 inline-detox to clean up these files.

AUTHORS

inline-detox was written by 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.

BSD February 11, 2021 BSD