Added comments to the greyscale scripts

greyscale_report.sh

 #!/bin/bash
+
+#
+# Fully independent from the quack.sh script.
+#
+# Generates a report of outputs from greyscale_stats.sh.
+# Lists the images with the most absolute white and absolute black pixels.
+# Lists the number of unique greyscale values in the images.
+#
+# Usage
+# * Generate a log from a collection of images with
+#   find myimages/ -name "*.tif" -exec ./greyscale_stats.sh {} \; > myimages.log
+# * Generate a report with
+#   ./greyscale_report.sh myimages.log
+#
+# Optional usage
+# * Ignore 5% of the outer edges of the images when calculating stats by only
+#   analyzing the inner 90% of the images.
+#   find myimages/ -name "*.tif" -exec ./greyscale_stats.sh {} 90 \; > myimages.log
+# * Generate a report suitable for displaying in a browser
+#   ./greyscale_report.sh myimages.log html
+#
+
+# TODO: This should definitely be configurable in an external file ala quack.sh
 TOPX=20
 WEBROOT="http://pc254.sb.statsbiblioteket.dk/quack/tilbud2/"
 

greyscale_stats.sh

 #!/bin/bash
 
+# 
+# Simple statistical analysis of greyscale images.
+# Extracts key stats for darkest and brightest intensity, intended
+# for use with greyscale_report.sh
+#
+# Requirements
+# * ImageMagick
+#
+
 # Input: A greyscale image
 # Output: Name pixel_count unique_greyscales #darkest_pixels darkest_pixels_percent darkest_greyscale #brightest_pixels brightest_pixels_percent lightest_greyscale