Polished comments.

diff --git a/cf/images b/cf/images
index baf88bbfe82cf903519567b6e2ae618b914be6f3..0f4a331dae4a33d0e2103555063b048c678ed807 100644 (file)
--- a/cf/images
+++ b/cf/images
@@ -5,11 +5,11 @@
 ImageLib {
 
 # Default tracing level (0 to disable)
-Trace          0
+Trace                  0
 
-# Limits for image allocation. ImageMaxDim must be less than 1<<16.
-ImageMaxDim    0xffff
-ImageMaxBytes  256M
+# Limits for image allocation
+ImageMaxDim            0xffff          # Maximum width/height (at most 64k-1)
+ImageMaxBytes          256M            # Maximum size in bytes
 
 }
 
@@ -17,36 +17,35 @@ ImageMaxBytes       256M
 
 ImageSig {
 
-# Sherlock use regions based image comparision to find similar images.
-# First of all imagesim analyser extracts various regions features
-#  needed for comparisions. Sets of these features are called 
-# "image signatures" and they are stored in attributes 'H'.
+# To find similar images, Sherlock uses comparison based on regions.
+# First of all, the imagesim analyser extracts various region features.
+# Sets of these features are called "image signatures" and they are stored
+# in the `H' attribute of image objects.
 
-# Signatures are later processed by chewer to build an effective
-# search structure finally used by search server. See Indexer and Search
+# Signatures are later processed by the indexer to build an effective
+# search structure finally used by the search server. See Indexer and Search
 # sections for more options.
 
-
 # Minimum image size to apply segmentation. Smaller images are always
-# compared with simple "average" method (see ImageSig.CompareMethod).
-MinWidth       16
-MinHeight      16
+# compared by the simple "average" method (see ImageSig.CompareMethod).
+MinWidth               16
+MinHeight              16
 
-# List of subdivision thresholds in first phase of segmentation.
-# Lower the values to increase average number of regions and vice versa.
+# List of subdivision thresholds in the first phase of segmentation.
+# Lower the values to increase the average number of regions and vice versa.
 PreQuantThresholds     6 12 15 20 25 25 30 30 40 40 50 50 60 60 60
 
-# Settings for second phase of segmentation - usually not so important.
-# We use iterative algorithm to improve average error from the first phase.
+# Settings for the second phase of segmentation -- usually not so important.
+# We use an iterative algorithm to improve the average error from the first phase.
 # We stop the process after PostQuantMaxSteps or if we get only PostQuantThreshold
-# percentual improvement in comparision with the previous step.
+# percentual improvement over the previous step.
 PostQuantMinSteps      2
 PostQuantMaxSteps      10
 PostQuantThreshold     1
 
 # BorderBonus and BorderSize parameters can increase or decrease the weight
 # of image pixels near the borders. Weight of all pixels more than BorderSize * MIN(cols, rows)
-# pixels far from the edges is 128. Then this value continuously decrese/increse up to 128+BorderSize.
+# pixels far from the edges is 128. Then this value continuously decreses/increses up to 128+BorderSize.
 BorderSize             0.4
 BorderBonus            -50
 
@@ -58,7 +57,7 @@ InertiaScale          2 0.5 0.05
 # set it to zero to disable the algorithm completely.
 TexturedThreshold      0.32
 
-# Signatures comparision method (integrated|fuzzy|average):
+# Signature comparison method:
 #
 #   integrated
 #      based on: James Z. Wang, Jia Li and Gio Wiederhold,
@@ -75,15 +74,15 @@ TexturedThreshold   0.32
 #
 CompareMethod          integrated
 
-# Array of multiplicative constants in feature vectors distance computation
+# Array of multiplicative constants in feature vector distance computation
 # (L, u, v, LH, HL, HH, I1, I2, I3, X, Y). Each one must be an integer in range 0..15, default is 4.
 CompareFeaturesWeights 4 6 6 4 4 4 4 4 4 4 4
 
 }
 
-######## Duplicates finder ######################################################
+######## Duplicate finder #######################################################
 
 ImageDup {
-# Image duplicates do not work yet.
+# Detection of image duplicates does not work yet.
 }