tweak comments (merge from dvbr6 with minor clarification)

git-svn-id: https://svn.osgeo.org/grass/grass/trunk@31523 15284696-431f-4ddb-bdfa-cd5b030d7da7

raster/r.watershed/ram/close_maps2.c

@@ -46,7 +46,9 @@ close_array_seg (void)
 		        flag = 1;
 		        while (flag) { 
 			    G_get_color(r,&red,&green,&blue, &colors);
-			    if((blue*.11 + red*.30 + green*.59) < 100) { 
+			    /* if existing rule is too dark then append a new
+					rule to override it */
+			    if((blue*.11 + red*.30 + green*.59) < 100) {
 				G_set_color(r, rd, gr, bl, &colors);
 			        flag = 0;
 		            }
@@ -69,7 +71,8 @@ close_array_seg (void)
 	}
 	G_percent(r-1,max,3); /* finish it */
       }
-      else G_debug(1, "Too many subbasins to reasonably check neighboring color spread");
+      else G_debug(1, "Too many subbasins to reasonably check for color brightness");
+        /* using the existing stack of while/for/for/for/while loops ... */
    }
 
     /* stream segments map */

raster/r.watershed/seg/close_maps2.c

@@ -38,7 +38,9 @@ close_array_seg (void)
 		        flag = 1;
 		        while (flag) { 
 			    G_get_color(r,&red,&green,&blue, &colors);
-			    if((blue*.11 + red*.30 + green*.59) < 100) { 
+			    /* if existing rule is too dark then append a new
+					rule to override it */
+			    if((blue*.11 + red*.30 + green*.59) < 100) {
 				G_set_color(r, rd, gr, bl, &colors);
 			        flag = 0;
 		            }
@@ -59,7 +61,8 @@ close_array_seg (void)
 	}
 	G_percent(r-1,max,3); /* finish it */
       }
-      else G_debug(1, "Too many subbasins to reasonably check neighboring color spread");
+      else G_debug(1, "Too many subbasins to reasonably check for color brightness");
+        /* using the existing stack of while/for/for/for/while loops ... */
    }
 
     /* stream segments map */