Move WML-hacking tools from top-level utils directory to data/tools.

This is a clutter-reduction step, separating the packaging and code-integrity 
checks from the stuff for maintaining mainline campaigns.

I've also added documentation comments to some scripts.

data/tools/find-unused-images

@@ -1,5 +1,7 @@
 #!/bin/sh
 
+# NOTE: THIS TOOL IS DEPRECATED.  DO NOT RELY ON IT.
+
 # attempt to identify images that are not used
 # this is a helper script for the Battle for Wesnoth project
 # see http://www.wesnoth.org/

data/tools/find-unused-sounds

@@ -1,5 +1,9 @@
 #!/bin/sh
 
+# NOTE: THIS TOOL IS DEPRECATED.  DO NOT RELY ON IT.
+
+# Find sound files that are shipped but not used in mainline campaigns.
+
 # Changing the commas to newlines is a hack to handle the lists used in data/sound-utils.cfg.
 find -name '*.cfg' | xargs egrep '\.wav|\.ogg' | tr ',' '\n' | perl -e 'while(<>){/([a-zA-Z0-9_-]*(\.ogg|\.wav))/; print "$1\n";}' | sort | uniq > tmp-referenced-sounds-list
 

data/tools/random_map.pl

@@ -4,10 +4,10 @@
 # Copyright 2003 J.R. Blain
 # Released under the gnu gpl v2 or later.
 # 
-# Todo: Insert proper gpl notice here.
-#
-# 
-# todo: clean it up some, add some comments, make it produce
+# Todo: 
+# Insert proper gpl notice here.
+# Make it do the new map multi-letter map format
+# clean it up some, add some comments, make it produce
 # WML for the map, some form of interface (perl-gtk?) to allow
 # setting map parameters.
 # Reorganize settings variables to make more sense, remove

utils/README

@@ -0,0 +1,7 @@
+This is a directory of miscellaneous developer tools for Battle Of Wesnoth,
+mostly to support packaging, code integrity checks, and control of the
+Wesnoth campaign server.
+
+Tools that work on data (WML, maps, images, sounds) no longer belong here.  
+Go to data/tools for those.
+

utils/campaign_delete.pl

@@ -1,4 +1,6 @@
 #!/usr/bin/perl
+#
+# Delete a specified campaign from the campaign server.
 
 use wml;
 use wml_net;

utils/campaign_passphrase.pl

@@ -1,4 +1,7 @@
 #!/usr/bin/perl
+#
+# Set the passphrase for a campaign on the Wesnoth campaign server.
+# You must know the old passphrase.
 
 use wml;
 use wml_net;

utils/campaigns_client.pl

@@ -1,4 +1,6 @@
 #!/usr/bin/perl
+#
+# List and download campaigns from the Wesnoth command server.
 
 use wml;
 use wml_net;