DragonFly On-Line Manual Pages

Search: Section:  

MP3LINTSUM(1)         User Contributed Perl Documentation        MP3LINTSUM(1)


NAME

       mp3lintsum - Summarise mp3lint messages


SYNOPSIS

       mp3lintsum [-d] [-g] [-c] [-r] [-h] [FILE|-...]


DESCRIPTION

       mp3lintsum is used to produce a summary of messages generated by
       mp3lint(1). If there are a lot of problems, the output from mp3lint can
       be overwhelming. mp3lintsum enables you to get a rough idea of what
       needs fixing.

       mp3lintsum can summarise either by directory (the default) or one
       global summary. The summary can either consist of a count of problems
       (the default) or show messages with duplicates (caused by multiple
       files having the same problem) removed.


OPTIONS

       Running mp3lintsum with no options is equivalent to running it with
       options -d -c. If no filename is passed it reads from standard input.

       -d  Show a per-directory summary. This is the default.

       -g  Show a global summary.

       -c  Show a summary of message count. This is the default.

       -r  Remove duplicate messages. This also removes the filename and the
           "optional" section of the message (which may contain file-specific
           data).

       -h  Show a short help message.

       FILE|-
           Filename to read mp3lint output from. If not supplied or -, read
           standard input.


EXAMPLES

       mp3lint music/ | mp3lintsum
           Produce a per-directory count of messages (with a total at the
           end).

       mp3lint music/ | mp3lintsum -g -
           Just print a final total.

       mp3lint music/ | mp3lintsum -g -r
           Display one of every message that occurred, with duplicates and
           filenames stripped out.

       mp3lint music/ | mp3lintsum -d -r
           As above, but per-directory. This means a message can be printed
           more than once if it occurs in different directories.

       mp3lint music/ | tee out; mp3lintsum -g out
           As mp3lint can take a long time to run over a large collection of
           music, it can be a good idea to redirect the output to a file. This
           command displays the output of mp3lint, but also saves it to the
           file out. At the end mp3lintsum is used to provide a one-line
           summary.

       mp3lint music/ | tee /dev/stderr | mp3lintsum -g
           This is the same as above, only without leaving a file behind. It
           requires a shell and/or OS that supports or emulates /dev/stderr.
           Linux with /proc support and bash(1) both work.


BUGS

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


SEE ALSO

       mp3lint(1), mp3lint-tools(3), mp3lintskip(1), mp3lintrc(5),
       MP3::Archive(3), 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-10-31                     MP3LINTSUM(1)

Search: Section: