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

[svn at osgeo.org]

Author: tamas
Date: 2010-09-30 19:59:55 +0000 (Thu, 30 Sep 2010)
New Revision: 10562

Modified:
   trunk/docs/en/mapfile/layer.txt
Log:
Document the additions related to RFC-61 (#3544)

Modified: trunk/docs/en/mapfile/layer.txt
===================================================================
--- trunk/docs/en/mapfile/layer.txt	2010-09-30 19:12:47 UTC (rev 10561)
+++ trunk/docs/en/mapfile/layer.txt	2010-09-30 19:59:55 UTC (rev 10562)
@@ -473,9 +473,38 @@
 
 
 STYLEITEM [attribute]
-    Item to use for feature specific styling. This is *very* experimental and 
-    OGR only at the moment.
+    Item to use for feature specific styling. The style information may be 
+    represented by a separate attribute (style string) attached to the feature.
+    MapServer supports the following style string representations:
+    
+    - **MapServer STYLE definition** - The style string can be represented as a 
+      MapServer :ref:`STYLE` block according to the following example:
+    
+      .. code-block:: mapfile
 
+          STYLE BACKGROUNDCOLOR 128 0 0 COLOR 0 0 208 END
+
+    - **MapServer CLASS definition** - By specifying the entire :ref:`CLASS` 
+      instead of a single style allows to use further options (like setting 
+      expressions, label attributes, multiple styles) on a per feature basis.
+
+    - **OGR Style String** - MapServer support rendering the OGR style string 
+      format according to the `OGR - Feature Style Specification`_ documentation.
+      Currently only a few data sources support storing the styles along with the 
+      features (like MapInfo, AutoCAD DXF, Microstation DGN), however those styles 
+      can easily be transferred to many other data sources as a separate attribute 
+      by using the `ogr2ogr`_ command line tool as follows:
+
+      .. code-block:: mapfile
+
+          ogr2ogr -sql "select *, OGR_STYLE from srclayer" "dstlayer" "srclayer"      
+      
+.. _`OGR - Feature Style Specification`: http://www.gdal.org/ogr/ogr_feature_style.html
+.. _`ogr2ogr`: http://www.gdal.org/ogr2ogr.html
+             
+    We can specify the value: "AUTO" in order to have the driver to retrieve the 
+    style information. Currently only the OGR driver supports the "AUTO" setting,  
+
 .. index::
     pair: SYMBOLSCALEDENOM; LAYER