[mapserver-commits] r11682 - trunk/docs/en/mapfile

[svn at osgeo.org]

Author: havatv
Date: 2011-05-12 08:18:37 -0700 (Thu, 12 May 2011)
New Revision: 11682

Modified:
   trunk/docs/en/mapfile/style.txt
Log:
update of the gap explanation

Modified: trunk/docs/en/mapfile/style.txt
===================================================================
--- trunk/docs/en/mapfile/style.txt	2011-05-12 14:19:38 UTC (rev 11681)
+++ trunk/docs/en/mapfile/style.txt	2011-05-12 15:18:37 UTC (rev 11682)
@@ -96,8 +96,8 @@
 GAP [double]
     `GAP` specifies the distance between `SYMBOL`\s (center to center)
     for decorated lines and polygon fills in layer `SIZEUNITS`.  For
-    polygon fills, `GAP` specifies the spacing between `SYMBOL`\s in both
-    the X and the Y direction.
+    polygon fills, `GAP` specifies the distance between `SYMBOL`\s in
+    both the X and the Y direction.
     For lines, the centers of the `SYMBOL`\s are placed on the line.
     As of MapServer 5.0 this also applies to PixMap symbols.
 
@@ -112,12 +112,23 @@
     - For lines, a positive `GAP` value aligns the symbols' X axis
       relative to the X axis of the output device.
     - For lines, a `GAP` of 0 (the default value) will cause the symbols
-      not to be drawn.
+      to be rendered edge to edge
+    - For polygons, a missing `GAP` or a `GAP` of 0 will cause the
+      symbols to be rendered edge to edge.
 
-    The symbol can be rotated using `ANGLE`.
+    Symbols can be rotated using `ANGLE`.
 
     .. versionadded:: 6.0 moved from :ref:`SYMBOL`
 
+    .. note::
+
+      The behaviour of `GAP` has not been stable over time.  It has
+      specified the amount of space between the symbols, and also
+      something in between the amount of space between the symbols and
+      the center to center distance.  The goal is to have `GAP`
+      specify the center to center distance, but in version 6.0 it is
+      the amount of space between the symbols that is specified.
+
 GEOMTRANSFORM [bbox|end|labelpnt|labelpoly|start|vertices]
     Used to indicate that the current feature will be transformed
     before the actual style is applied. Introduced in version 5.4.