[mapserver-commits] r10084 - branches/branch-5-6/docs/en/development/rfc

[svn at osgeo.org]

Author: assefa
Date: 2010-04-08 19:53:57 -0400 (Thu, 08 Apr 2010)
New Revision: 10084

Modified:
   branches/branch-5-6/docs/en/development/rfc/ms-rfc-58.txt
Log:
Updated with notes from review

Modified: branches/branch-5-6/docs/en/development/rfc/ms-rfc-58.txt
===================================================================
--- branches/branch-5-6/docs/en/development/rfc/ms-rfc-58.txt	2010-04-08 22:53:26 UTC (rev 10083)
+++ branches/branch-5-6/docs/en/development/rfc/ms-rfc-58.txt	2010-04-08 23:53:57 UTC (rev 10084)
@@ -27,7 +27,7 @@
 to its complexity libxml2 already included in MapServer was selected for xml generating.
  
 
-Functionnalities
+Functionality
 -------------------------------------------------------------------------------
 
 KML driver can work in two modes: vector mode generates standard KML output where 
@@ -66,11 +66,11 @@
 
 KML_MAXFEATURECOUNT
 Maximum number of features rendered as KML vector, if number of features rendered 
-in one layer is greater than maximum feature count, layer is rasterized and renderer 
+in one layer is greater than maximum feature count, layer is rasterized and the renderer 
 generates ground overlay KML element.
 
 KML_DUMPATTRIBUTES
-Option whether or not to create KML description element "baloon" containing shape 
+Option whether or not to create KML description element "balloon" containing shape 
 attributes. Default is yes, possible values 0, no, or list of attributes separated 
 by comma.
 Example: KML_DUMPATTRIBUTES "NAME,SIZE"
@@ -88,7 +88,7 @@
 Specifies whether to allow the LinearRing to follow the terrain.
 http://code.google.com/apis/kml/documentation/kmlreference.html#extrude
 
-Options are specified in layer metadata.
+Options are specified in the layer meta data.
 
 LAYER
 ...
@@ -102,8 +102,8 @@
 Projection
 -------------------------------------------------------------------------------
 
-Google  Earth accepts only WGS84 Lat Lon coordinates, using mapfile projection 
-epsg:4326 is the only alternative. Driver tests mapfile projection and generates 
+Google  Earth accepts only WGS84 Lat Lon coordinates, using map file projection 
+epsg:4326 is the only alternative. Driver tests the map file projection and generates 
 error when projection doesn't match.
 
 
@@ -122,33 +122,33 @@
 Line shape 
 ~~~~~~~~~~
 
-- is transformed into kml element LineString, supported attributes: 
-color, width. 
+- is transformed into kml element LineString, supported attributes are color, width. 
 
 Polygon shape 
 ~~~~~~~~~~~~~
 
-- is transformed into KML element Polygon, supported attributes: 
-outline color, color, width.
+- is transformed into KML element Polygon, supported attributes are outline color, color, width.
 
 Symbol
 ~~~~~~
  
 - is rendered and stored in separate file and transformed into KML element 
-Icon.
+  Icon.
 
 Label
 ~~~~~
  
 - is transformed into placemark name. To ensure binding shape and label, 
-labelcache should be switched off.  Label position LL is also recommended.
+  labelcache should be switched off.  Label position LL is also recommended.
 
-LAYER
-...
-LABELCACHE OFF
-END
+.. code-block:: guess
 
+    LAYER
+    ...
+    LABELCACHE OFF
+    END
 
+
 Raster layers are not supported yet
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -204,7 +204,14 @@
 --------------------------------------------------------------------------------
 
 - instead of KML_DUMPATTRIBUTES we could possibly use the gml/ows_include_items
+- error messages should be clarified for the projection and exact wording should be put in the RFC
+- clearly define what control the user will have over KML styling (the description balloon, icon styles, and Google Earth TOC) 
 
 
 Voting History
 --------------------------------------------------------------------------------
+
+Adopted 2010/04/08 on the condition that this RFC should be cleaned and upadted with more details.
+This allows to move the source code from the sand box to trunk
+with +1 from DanielM, SteveL, TamasS, AssefaY, TomK, JeffM
+with +0 from SteveW