Bug#447014: ITP: detox -- utility to cleanup filenames from problematic characters

[Steve Greenland <steveg@moregruel.net>]

On 17-Oct-07, 07:01 (CDT), Patrick Schoenfeld <schoenfeld@in-medias-res.com> wrote: 
>   Description     : utility to cleanup filenames from problematic characters

I won't claim that's incorrect, but it's awkward. Perhaps:

   Description: utility to replace problematic characters in filenames

> Detox is a utility designed to clean up filenames. It replaces difficult to
> work with characters, such as spaces, with standard equivalents. It will also
> clean up filenames with UTF-8 or Latin-1 (or CP-1252) characters in them.
> 
> * Removal or replacement of upper ASCII Latin-1 (ISO 8859-1) characters
> * Removal or replacement of UTF-8 encoded Unicode characters
> * Removal or replacement of spaces and other potentially tricky characters, such as (, ), and @
> * Removal of any "-"s at the beginning of the filename
> * Removal or replacement of CGI escaped ASCII characters, i.e. %20 becomes " " (which then becomes "_").
> * Trimming of excessive "_" and "-"s.
> * Directory recursion, dry runs, verbose listings.
> .
> It's designed with safety in mind. It won't overwrite to a file that already exists,
> and it doesn't touch special files normally (but it can be asked to).

Please see the section 5.6.13 of the Debian policy manual. The long
description needs to begin each line with a space, and blank lines
need a period. For your bulleted lines, you need two (or more) leading
spaces. Also, the bulleted items need to either all be sentences
(beginning with a capitalized letter and ending with a period) or not
(not). Finally, watch out for the 80 char line-length.

Regards,
Steve

-- 
Steve Greenland
    The irony is that Bill Gates claims to be making a stable operating
    system and Linus Torvalds claims to be trying to take over the
    world.       -- seen on the net