id3ren  (C) Copyright 1998 by Robert Alto (badcrc()tscnet.com)
        (C) Copyright 2001 Christophe Bothamy (cbothamy()free.fr)

=======
License
=======

    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.


============
Introduction
============
id3ren is used to rename batches of mp3 files by reading the ID3 tag
at the end of the file which contains the song name, artist, album, year,
and a comment.  

The secondary function of id3ren is a tagger, which can create, modify, 
or remove ID3 tags. The id3 fields can be set on the command line, 
entered interactively, or "guessed" from the path and the filename.

If you have questions, comments, or bug reports, contact cbothamy()free.fr
To get the latest version please visit http://cbothamy.free.fr/projects/id3ren/

Please refer to the USAGE file for the meaning of the different options.
Please refer to the FEATURES file to learn more on new features of id3ren.

=====
Notes
=====
- id3ren is developed and tested on linux, but it should work as is
  on any unix system.

- Windows support is discontinued. It may still work, but it has not been tested
  id3ren is known to compile fine with cygwin.

- Config files should only contain the exact same options as specified on
  the command line.  You can use # at the beginning of a line for a comment.
  Spaces at the beginning of a line are ignored.  NOTE: There is no more
  syntax difference between a config file option and a command line option.

- id3ren first reads all command line options.  If it doesn't find the
  "-nocfg" command line option, it looks for config files in this order:
  1) Reads environment variable ID3REN which should contain the complete
     path to a config file.  If variable doesn't exist or file not found
     then...
  2) Reads environment variable HOME and look for $HOME/.id3renrc.
     If variable doesn't exist or file not found then...
  3) It looks for /etc/id3renrc. 

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  150     217  69.1% -lh5- 1487 Oct 22  2002 id3ren-1.1b0/Docs/AUTHORS
[generic]                 1350    2810  48.0% -lh5- e068 Oct 22  2002 id3ren-1.1b0/Docs/ChangeLog
[generic]                 6992   17983  38.9% -lh5- 8f29 Oct 22  2002 id3ren-1.1b0/Docs/COPYING
[generic]                 1098    2872  38.2% -lh5- 983f Oct 22  2002 id3ren-1.1b0/Docs/FEATURES
[generic]                  105     135  77.8% -lh5- fb3c Oct 22  2002 id3ren-1.1b0/Docs/FEEDBACK
[generic]                  284     579  49.1% -lh5- 0984 Oct 22  2002 id3ren-1.1b0/Docs/INSTALL
[generic]                  304     489  62.2% -lh5- 8281 Oct 22  2002 id3ren-1.1b0/Docs/PORTS
[generic]                 1416    2889  49.0% -lh5- 52a9 Oct 22  2002 id3ren-1.1b0/Docs/README
[generic]                  351     627  56.0% -lh5- cd82 Oct 22  2002 id3ren-1.1b0/Docs/THANKS
[generic]                  118     153  77.1% -lh5- 084a Oct 22  2002 id3ren-1.1b0/Docs/TODO
[generic]                 1863    5932  31.4% -lh5- 25d3 Oct 22  2002 id3ren-1.1b0/Docs/USAGE
[generic]                44416  107480  41.3% -lh5- 75d5 Oct 17  2006 id3ren-1.1b0/id3ren
[generic]                  634    1125  56.4% -lh5- 86ae Oct 22  2002 id3ren-1.1b0/src/id3misc.h
[generic]                 6242   26247  23.8% -lh5- 02fa Oct 17  2006 id3ren-1.1b0/src/id3ren.c
[generic]                 1120    2416  46.4% -lh5- 4872 Oct 22  2002 id3ren-1.1b0/src/id3ren.h
[generic]                 4002   14836  27.0% -lh5- 30cc Oct 22  2002 id3ren-1.1b0/src/id3tag.c
[generic]                  625    1146  54.5% -lh5- 1d35 Oct 22  2002 id3ren-1.1b0/src/id3tag.h
[generic]                  114     203  56.2% -lh5- eb71 Oct 22  2002 id3ren-1.1b0/samples/id3ren.rc
[generic]                  104     187  55.6% -lh5- 48d0 Oct 22  2002 id3ren-1.1b0/samples/id3renrc
[generic]                 1687    5698  29.6% -lh5- 64e3 Oct 22  2002 id3ren-1.1b0/src/id3file.c
[generic]                  902    2010  44.9% -lh5- 15d1 Oct 22  2002 id3ren-1.1b0/src/id3file.h
[generic]                 1291    3001  43.0% -lh5- 63b4 Oct 22  2002 id3ren-1.1b0/src/id3genre.h
[generic]                 1201    2878  41.7% -lh5- aa47 Oct 17  2006 id3ren-1.1b0/src/id3misc.c
[generic]                  255     558  45.7% -lh5- 9add Oct 17  2006 id3ren-1.1b0/src/Makefile
[generic]                  191     313  61.0% -lh5- 2547 Oct 22  2002 id3ren-1.1b0/src/Makefile.win32
[generic]                   56      77  72.7% -lh5- 3fc4 Oct 22  2002 id3ren-1.1b0/src/win32.bat
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        26 files   76871  202861  37.9%            Feb  6 08:38