diff --git a/configure b/configure
index 07d221b3..81e2f432 100755
--- a/configure
+++ b/configure
@@ -1,5 +1,22 @@
 #!/bin/sh
 
+#
+# This script creates config/environments/*.js files using
+# config/environments/*.js.example files as input and performing
+# settings substitutions.
+#
+# It relies on a known format of the .js.example files which haven't
+# been made easier to parse to still let humans copy them manually and
+# do further editing or leave them as such to get the same setup as before
+# the introduction of this script.
+#
+# The script is a work in progress. Available switches are printed
+# by invoking with the --help switch. More switches will be added
+# as the need/request for them arises.
+#
+# --strk(2012-07-23)
+#
+
 usage() {
   echo "Usage: $0 [OPTION]"
   echo