Add explanatory comments to maintainer scripts.

debian/postinst

@@ -1,7 +1,21 @@
 #!/bin/sh
+# Post-install script for ‘bsdgames’ package.
+#
+# Man page: ‘dh_installdeb(1)’
 
 set -e
 
+# Summary of ways this script can be called:
+#   * <postinst> ‘configure’ <most-recently-configured-version>
+#   * <old-postinst> ‘abort-upgrade’ <new version>
+#   * <conflictor-postinst> ‘abort-remove’
+#     ‘in-favour’ <package> <new-version>
+#   * <deconfigured-postinst> ‘abort-deconfigure’
+#     ‘in-favour’ <failed-install-package> <version>
+#     ‘removing’ <conflicting-package> <version>
+# For details, see <URL:http://www.debian.org/doc/debian-policy/> or
+# the ‘debian-policy’ package.
+
 SCOREFILES="
 	/var/games/bsdgames/atc_score
 	/var/games/bsdgames/battlestar.log

debian/postrm

@@ -1,7 +1,22 @@
 #!/bin/sh
+# Post-remove script for ‘bsdgames’ package.
+#
+# Man page: ‘dh_installdeb(1)’
 
 set -e
 
+# Summary of ways this script can be called:
+#   * <postrm> ‘remove’
+#   * <postrm> ‘purge’
+#   * <old-postrm> ‘upgrade’ <new-version>
+#   * <disappearer's-postrm> ‘disappear’ <overwriter> <overwriter-version>
+#   * <new-postrm> ‘failed-upgrade’ <old-version>
+#   * <new-postrm> ‘abort-install’
+#   * <new-postrm> ‘abort-install’ <old-version>
+#   * <new-postrm> ‘abort-upgrade’ <old-version>
+# For details, see <URL:http://www.debian.org/doc/debian-policy/> or
+# the ‘debian-policy’ package.
+
 SCOREFILES="
 	/var/games/bsdgames/atc_score
 	/var/games/bsdgames/battlestar.log

debian/preinst

@@ -1,7 +1,18 @@
 #!/bin/sh
+# Pre-install script for ‘python-coverage’.
+#
+# Man page: ‘dh_installdeb(1)’
 
 set -e
 
+# Summary of ways this script can be called:
+#   * <new-preinst> ‘install’
+#   * <new-preinst> ‘install’ <old-version>
+#   * <new-preinst> ‘upgrade’ <old-version>
+#   * <old-preinst> ‘abort-upgrade’ <new-version>
+# For details, see the Debian Policy §6.5 in the ‘debian-policy’ package
+# or on the web at <URL:http://www.debian.org/doc/debian-policy/>.
+
 SCOREFILES="
 	/var/games/bsdgames/atc_score
 	/var/games/bsdgames/battlestar.log

debian/prerm

@@ -0,0 +1,24 @@
+#! /bin/sh
+# Pre-remove script for ‘bsdgames’ package.
+#
+# Man page: ‘dh_installdeb(1)’
+
+set -e
+
+# Summary of ways this script can be called:
+#   * <prerm> ‘remove’
+#   * <old-prerm> ‘upgrade’ <new-version>
+#   * <new-prerm> ‘failed-upgrade’ <old-version>
+#   * <conflictor-prerm> ‘remove’
+#     ‘in-favour’ <package> <new-version>
+#   * <deconfigured-prerm> ‘deconfigure’
+#     ‘in-favour’ <package-being-installed> <version>
+#     ‘removing’ <conflicting-package> <version>
+# For details, see <URL:http://www.debian.org/doc/debian-policy/> or
+# the ‘debian-policy’ package.
+
+
+# dh_installdeb will replace this with shell code automatically
+# generated by other debhelper scripts.
+
+#DEBHELPER#