[mapserver-commits] r12743 - branches/branch-6-0/docs/en/mapfile trunk/docs/en/mapfile

[svn at osgeo.org]

Author: havatv
Date: 2011-11-03 03:14:52 -0700 (Thu, 03 Nov 2011)
New Revision: 12743

Modified:
   branches/branch-6-0/docs/en/mapfile/style.txt
   trunk/docs/en/mapfile/style.txt
Log:
Clarified (hopefully) the explanation of OUTLINECOLOR in the style document.

Modified: branches/branch-6-0/docs/en/mapfile/style.txt
===================================================================
--- branches/branch-6-0/docs/en/mapfile/style.txt	2011-11-03 09:49:27 UTC (rev 12742)
+++ branches/branch-6-0/docs/en/mapfile/style.txt	2011-11-03 10:14:52 UTC (rev 12743)
@@ -276,10 +276,16 @@
 
 OUTLINECOLOR [r] [g] [b] | [attribute]
     Color to use for outlining polygons and certain marker symbols
-    (ellipse, vector and truetype).  Has no effect for lines.  The
-    width of the outline can be specified using `WIDTH`.  If no WIDTH
-    is specified, an outline of one pixel will be drawn.
+    (`ellipse`, `vector` polygons and `truetype`).  Has no effect for
+    lines.  The width of the outline can be specified using `WIDTH`.
+    If no WIDTH is specified, an outline of one pixel will be drawn.
 
+    If there is a `SYMBOL` defined for the `STYLE`, the `OUTLINECOLOR`
+    will be used to create an outline for that `SYMBOL` (only
+    `ellipse`, `truetype` and polygon `vector` symbols will get an
+    outline).  If there is no `SYMBOL` defined for the `STYLE`, the
+    polygon will get an outline.
+
     - `r`, `g` and `b` shall be integers [0..255].  To specify green,
       the following is used:
 

Modified: trunk/docs/en/mapfile/style.txt
===================================================================
--- trunk/docs/en/mapfile/style.txt	2011-11-03 09:49:27 UTC (rev 12742)
+++ trunk/docs/en/mapfile/style.txt	2011-11-03 10:14:52 UTC (rev 12743)
@@ -323,10 +323,16 @@
 
 OUTLINECOLOR [r] [g] [b] | [attribute]
     Color to use for outlining polygons and certain marker symbols
-    (ellipse, vector and truetype).  Has no effect for lines.  The
-    width of the outline can be specified using `WIDTH`.  If no WIDTH
-    is specified, an outline of one pixel will be drawn.
+    (`ellipse`, `vector` polygons and `truetype`).  Has no effect for
+    lines.  The width of the outline can be specified using `WIDTH`.
+    If no WIDTH is specified, an outline of one pixel will be drawn.
 
+    If there is a `SYMBOL` defined for the `STYLE`, the `OUTLINECOLOR`
+    will be used to create an outline for that `SYMBOL` (only
+    `ellipse`, `truetype` and polygon `vector` symbols will get an
+    outline).  If there is no `SYMBOL` defined for the `STYLE`, the
+    polygon will get an outline.
+
     - `r`, `g` and `b` shall be integers [0..255].  To specify green,
       the following is used:
 
@@ -351,10 +357,10 @@
    pair: STYLE; PATTERN
 
 PATTERN [double on] [double off] [double on] [double off] ... END
-    Currently used to define a dash pattern for line work (lines,
-    polygon outlines, hatch lines, ...).  The numbers (doubles)
-    specify the lengths of the dashes and gaps of the dash pattern in
-    layer `SIZEUNITS`.
+    Used to define a dash pattern for line work (lines, polygon
+    outlines, hatch lines, ...).  The numbers (doubles) specify the
+    lengths of the dashes and gaps of the dash pattern in layer
+    `SIZEUNITS`.
     When scaling of symbols is in effect (`SYMBOLSCALEDENOM` is
     specified for the :ref:`LAYER`), the numbers specify the lengths
     of the dashes and gaps in layer `SIZEUNITS` at the map scale
@@ -375,9 +381,12 @@
           PATTERN 5.0 5.0 END
         END
 
-    Since version 6.2, `PATTERN` can be used to create dashed lines in
-    :ref:`symbol`\s of `TYPE` `hatch`.  Patterns in hatches are always
-    drawn with `LINECAP` `butt`.
+    Since version 6.2, `PATTERN` can be used to create dashed lines
+    for :ref:`symbol`\s of `TYPE` `hatch`.  Patterns for hatches are
+    always drawn with `LINECAP` `butt`.  The patterns are generated
+    relative to the edges of the polygon (an illustrated example can
+    be found in the :ref:`hatch fill section of the symbol
+    construction document <construction_hatch_fill>`).
 
     .. versionadded:: 6.0 moved from :ref:`SYMBOL`