DragonFly On-Line Manual Pages

Search: Section:  

MP3LINTSKIP(1)        User Contributed Perl Documentation       MP3LINTSKIP(1)


NAME

       mp3lintskip - writes .mp3lintskip files from mp3lint output


SYNOPSIS

       mp3lintskip [-o] [-m] [-g] [-l] [-v] [-d path] [-D] [-h] (file|-)...


DESCRIPTION

       mp3lintskip is used with mp3lint(1) to write .mp3lintskip files to
       suppress warnings generated by mp3lint. For instance, if you have an
       album that you only have a low bitrate copy of, and cannot find a
       higher bitrate version, or you have a directory of radio plays that you
       don't care are in mono, you can use this to suppress those warnings on
       future runs of mp3lint, so you only get warned about new problems.

       Depending on the options set (-g or -l), mp3lintskip either writes to
       per-directory .mp3lintskip files, or writes a global file called
       .mp3lintskip-global in your $HOME directory. The latter can be used to
       permanently ignore certain warnings in all directories, and can be used
       for tests you don't care about or don't agree with.

       Default messages to ignore can also be set in your .mp3lintrc file, see
       mp3lintrc(5).

       WARNING: mp3lintskip works by filtering the output of mp3lint, so it
       has no effect on the -f (fix) option to mp3lint(1).


OPTIONS

       -o  Overwrite .mp3lintskip files.

       -m  Merge .mp3lintskip files. This is the default.

       -g  Write global $HOME/.mp3lintskip-global file.

       -l  Write local .mp3lintskip files per directory (default)

       -v  Verbose

       -d path
           Delete local .mp3lintskip files under path.

       -D  Delete global $HOME/.mp3lintskip-global file.

       -h  Help.

       (file|-)
           Where to read mp3lint data from. If - or not specified, uses STDIN.


EXAMPLES

       mp3lint music/ | mp3lintskip -v -
           Probably the most common usage pattern. Run mp3lint on your music
           directory, fixing all the warnings you care about, then run the
           above command to suppress all the other warnings on future runs of
           mp3lint, so you only get warned about new problems.

       mp3lint music |grep -v ':channels:mono:' |mp3lintskip -v
           As above, but filters out messages about mono tracks, so they won't
           get skipped.

       mp3lint -D -d music/
           Deletes both the global $HOME/.mp3lintskip-global file, and any
           .mp3lintskip files in music/ and any subdirectories.


FILES

       .mp3lintrc, /etc/mp3lintrc
           Configuration files, see mp3lintrc(5) for details.

       .mp3lintskip, $HOME/.mp3lintskip-global
           Files containing messages to skip.


ENVIRONMENT

       $HOME
           Used to find .mp3lintrc and .mp3lintskip-global


BUGS

       None known. Please report any found to ianb@nessie.mcc.ac.uk


SEE ALSO

       mp3lint(1), mp3lint-tools(3), mp3lintsum(1), mp3lintrc(5),
       mp3-archive-tools(1)


AUTHOR

       Ian Beckwith <ianb@nessie.mcc.ac.uk>


COPYRIGHT

       Copyright 2003 Ian Beckwith <ianb@nessie.mcc.ac.uk>

       This program is free software; you can redistribute it and/or modify it
       under the terms of the GNU General Public License as published by the
       Free Software Foundation; either version 2 of the License, or (at your
       option) any later version.

       This program is distributed in the hope that it will be useful, but
       WITHOUT ANY WARRANTY; without even the implied warranty of
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
       General Public License for more details.

       You should have received a copy of the GNU General Public License along
       with this program; if not, write to the Free Software Foundation, Inc.,
       675 Mass Ave, Cambridge, MA 02139, USA.

perl v5.20.2                      2003-12-10                    MP3LINTSKIP(1)

Search: Section: