+#
+# MAIN ADMINISTRATIVE DATABASE UPDATE TOOL
+#
+# Usage:
+# ./update-master-info [-d RSYNCDESTDIR] [-O OCEAN ... | -a]
+#
+# Usual usages:
+#
+# After editing source-info.txt to add commodities, or
+# changing db-idempotent-update (eg to change the schema):
+# ./update-master-info -d ~ftp/users/ijackson/yarrg/
+# This will update everything except the ocean topologies.
+#
+# To take account of new islands, or to fix a mistake in
+# assigning island(s) to archipelago(es), or to add support
+# for a new ocean:
+# ./update-master-info -d ~ftp/users/ijackson/yarrg/ -O Midnight
+#
+# After a fix to a mistake on a YPPedia chart page, correcting
+# only inter-island-distances:
+# ./update-master-info -O Midnight
+#
+# After changing the algorithms for topology determination
+# or YPPedia scraping:
+# ./update-master-info -a
+# and check that nothing unexpected changes.
+#
+# To just make backups of the databases into the rsync directory:
+# ./update-master-info -b -d ~ftp/users/ijackson/yarrg/ -a
+# ./update-master-info -b -d ~ftp/users/ijackson/yarrg/ -O ...
+
+# This is part of the YARRG website. YARRG is a tool and website
+# for assisting players of Yohoho Puzzle Pirates.
+#
+# Copyright (C) 2009 Ian Jackson <ijackson@chiark.greenend.org.uk>
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as
+# published by the Free Software Foundation, either version 3 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 Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+# Yohoho and Puzzle Pirates are probably trademarks of Three Rings and
+# are used without permission. This program is not endorsed or
+# sponsored by Three Rings.