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.