Resubmit version 0.4 03/02/06
Written and maintained by Felix Suwald
Web Site: http://www.suwald.com/resubmit/resubmit.html


What Is It?
-----------
Resubmit is used to correct faulty entries in FreeDB.
It is a Perl script and depends on KMail or nail and is intended for
use with Konqueror (KDE) while browsing freedb.org, but command line
works too!
With one click a new message will be prepared, reddy for resubmission.
All words will have first character uppercase, but this behavoir can be
altered (see the configuration file). Corrections can be made before
sending the message to freedb.org.
Resubmit is now intended to be used without Kmail, but usage with Kmail
works in the same way. A text editor will now open to edit the entry,
saved in ~/.cddb/category/cddbid and nail will send the message as soon
as one clicks *Yes* in the Kdialog pop-up window. To use this feature,
one needs to give a valid reply-to mail address in the config file,
which resides in /etc/resubmit/resubmit.conf or locally in
~/.resubmit/resubmit.conf. You may do it befor installing resubmit.
A new feature is, that resubmit may ask to put all first chracters in
uppercase. Default is not to ask. See the resubmit.config file!
There is an option to be used with command line: resubmit -c cddbid,
e.g. resubmit -c d60c800f and all categories will be checked, if
occupied! In this way it is easy to find out which category is not used
yet, if one wants to submit (how ever) a new entry.


Installation
------------
There is no installation required for the program itself.
It is suggested to create a link in your /usr/local/bin (or whatever)
directory. Either type (as root)

# make install

or do it step by step by hand:

# ln -s /path/to/resubmit /usr/bin/resubmit

Now one should be able to start the script by typing resubmit only.

If one wants to use the kontext-menu while browsing freedb.org with
Konqueror, you need to place the desktop file resubmit.desktop in
your KDE settings (e.g. ~/.kde/share/apps/konqueror/servicemenus).
If a symbolic link has been created, one does not need to change the
resubmit.desktop file, else change the line

Exec=resubmit %U

to

Exec=/path/to/my_resubmit.name %U


Calling resubmit
----------------
One can use it either from command line typing

resubmit http://www.freedb.org/freedb/category/entry

e.g.

resubmit http://www.freedb.org/freedb/misc/d60c800f

or, if the kdesktop file is installed, by right-clicking on the freedb
link to the source entry --> choose Actions --> resubmit FreeCDDB entry!


Using resubmit
--------------
Please use resubmit with caution. It may not work always. If it fails,
try the command line to find the errors. Fix them and send the problem
description to me!
Please respect the naming rules you can find in the freedb-FAQ:

http://www.freedb.org/modules.php?name=Sections&sop=viewarticle&artid=26#2-2

Please respect the work of other users.
Please respect the artists and that there are other languages than
(us-)english with different habits and rules to write titles.


Author's Comment
----------------
It happened quite often, that I got CDDB entries full of typos (while
using RipIT). Then I looked up for that artist in http://www.freedb.org/
and thought about a way, to easily resubmit all those bad entries. The
answer is this script. Maybe you check your favourite artists from time
to time, and correct wrong entries. This would be a great job for the
community.

Felix Suwald, Zürich, Switzerland

Please send bugs/comments/whishes to: resubmit[_at_]suwald[_dot_]com
Hey, don't hesitate! One may even write in French or German!