<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<!--[if !mso]><style>v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style><![endif]--><style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Consolas;
panose-1:2 11 6 9 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman",serif;
color:black;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
p
{mso-style-priority:99;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
font-size:12.0pt;
font-family:"Times New Roman",serif;
color:black;}
pre
{mso-style-priority:99;
mso-style-link:"HTML Preformatted Char";
margin:0in;
margin-bottom:.0001pt;
font-size:10.0pt;
font-family:"Courier New";
color:black;}
p.emailquote, li.emailquote, div.emailquote
{mso-style-name:emailquote;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:1.0pt;
border:none;
padding:0in;
font-size:12.0pt;
font-family:"Times New Roman",serif;
color:black;}
span.HTMLPreformattedChar
{mso-style-name:"HTML Preformatted Char";
mso-style-priority:99;
mso-style-link:"HTML Preformatted";
font-family:"Consolas",serif;
color:black;}
span.EmailStyle21
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body bgcolor="white" lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">If a block contains a significant set of keywords itself or is otherwise complex then it probably should have its own page.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">I don’t think I’d list SCALE specifically, it’s been deprecated since 5.0 and it still gets a shout out in the SCALEDENOM section. If anything I’d remove reference
to it altogether.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">The CGI parameters are independent of the mapfile configuration. They use a different parser… A few of the CGI parameters can be directly mapped to mapfile settings
(e.g. mapex => extent, layer => layer STATUS) and I could see making note of that in the CGI documentation if not already. Others (e.g. mode) are controlling the behavior of the MapServer CGI application and have no connection to the mapfile.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:windowtext">From:</span></b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:windowtext"> Seth G [mailto:sethg@geographika.co.uk]
<br>
<b>Sent:</b> Thursday, June 29, 2017 7:29 AM<br>
<b>To:</b> Lime, Steve D (MNIT) <steve.lime@state.mn.us>; Stephen Woodbridge <woodbri@swoodbridge.com>; mapserver-dev@lists.osgeo.org<br>
<b>Subject:</b> Re: [mapserver-dev] Mapfile keywords questions<o:p></o:p></span></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<p>Thanks Steve for all the details. <o:p></o:p></p>
<p>I'm not sure why I had SCALETOKEN in the list. Maybe however this block deserves its own page in the docs?<o:p></o:p></p>
<p>SCALE is referred to on the <a href="http://mapserver.org/mapfile/map.html">http://mapserver.org/mapfile/map.html</a> page, but only as part of the newer SCALEDENOM keyword. Should it be added as its own keyword, with a deprecated tag? Also are all the keywords
listed at <a href="http://mapserver.org/cgi/controls.html">http://mapserver.org/cgi/controls.html</a> Mapfile keywords, or are they a separate but similar set?<o:p></o:p></p>
<p class="MsoNormal" style="margin-bottom:12.0pt">I'm happy to take care of creating a ticket for updating the docs, and fix these where appropriate.<br>
<br>
Regards,<br>
<br>
Seth<o:p></o:p></p>
<div>
<p class="MsoNormal">On 29/06/2017 13:53, Lime, Steve D (MNIT) wrote:<o:p></o:p></p>
</div>
<blockquote style="margin-top:5.0pt;margin-bottom:5.0pt">
<div>
<p class="MsoNormal">Agreed. I guess I can do it... there are a couple of instance where doc updates probably aren't warranted IMHO (simple, compfilter). That's up for debate...<br>
<br>
Re:LATLON... More info, that parameter takes a projection string. It allows you to override the default geographic projection used by MapServer.<br>
<br>
--Steve<o:p></o:p></p>
<div class="MsoNormal" align="center" style="text-align:center">
<hr size="2" width="98%" align="center">
</div>
<div id="x_divRplyFwdMsg">
<p class="MsoNormal"><b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif">From:</span></b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif"> mapserver-dev
<a href="mailto:mapserver-dev-bounces@lists.osgeo.org"><mapserver-dev-bounces@lists.osgeo.org></a> on behalf of Stephen Woodbridge
<a href="mailto:woodbri@swoodbridge.com"><woodbri@swoodbridge.com></a><br>
<b>Sent:</b> Wednesday, June 28, 2017 1:02:16 PM<br>
<b>To:</b> <a href="mailto:mapserver-dev@lists.osgeo.org">mapserver-dev@lists.osgeo.org</a><br>
<b>Subject:</b> Re: [mapserver-dev] Mapfile keywords questions</span> <o:p></o:p></p>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
</div>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.0pt">Hmmm, sounds like there should be two tickets opened:<br>
<br>
1. one for code changes at <a href="https://github.com/mapserver/mapserver/issues">
https://github.com/mapserver/mapserver/issues</a><br>
2. one for doc changes at <a href="https://github.com/mapserver/docs/issues">https://github.com/mapserver/docs/issues</a><br>
<br>
-Steve W<br>
<br>
On 6/28/2017 1:21 PM, Lime, Steve D (MNIT) wrote:<br>
> Hi Seth: Results of my research... Thanks for sharing yours. I think you've identified a few places where some cleanup is warranted. --Steve<br>
> <br>
> *RELATIVETO - I don't believe this is in use. Should be removed.<br>
> <br>
> *COMPFILTER - My take is that COMPFILTER, while part of the enhancement, is not actually functional in any meaningful way so it's not worth documenting beyond RFC 113 at this point.<br>
> <br>
> *GRATICULE - more research needed here. I'm not regular user of graticule/grid functionality, but it has not been formally deprecated.<br>
> <br>
> *SCALETOKEN - is documented in detail here: <a href="http://mapserver.org/mapfile/layer.html">
http://mapserver.org/mapfile/layer.html</a>.<br>
> <br>
> *LATLON - this is processed at the map level as a shortcut to define a second geographic projection independent of the map->projection. Presumably something like "LATLON TRUE". It is used in some places in the CGI and template handling for projection to geographic
coordinates. Probably should examine the need for it as it is not documented anywhere...<br>
> <br>
> *JAVASCRIPT - I don't believe the token is needed. I imagine it was a holdover when the thought was that block of javascript could defined within a mapfile. Instead referencing an external file was pursued.<br>
> <br>
> *SCALE - This is valid within the map object and is a parameter for CGI/FCGI and documented here:
<a href="http://mapserver.org/mapfile/map.html">http://mapserver.org/mapfile/map.html</a>. The idea is/was to set an explicit scale, center point and size and then let MapServer compute a matching extent rather than the other way around.<br>
> <br>
> *INDEX - I don't believe this is in use. Should be removed.<br>
> <br>
> *SIMPLE - This is a valid TYPE value within a SYMBOL object. It's actually the default value (e.g. a pixel) and is never set explicitly - hence the lack of documentation.<br>
> <br>
> *TITLE - still a valid property for a class but deprecated. Should be considered for removal.<br>
> <br>
> *VALUES - Part of the SCALETOKEN implementation and is covered there.<br>
> <br>
> *COLORRANGE and DATARANGE - We've always considered that functionality experimental and ripe for refactoring and haven’t wanted to encourage their use. Lame, but that's my story... ;-)<br>
> <br>
> *BANDSITEM - I don't believe this is in use. Should be removed. The bandsitem and bandsitemindex still exist as part of the layer object but are unused...<br>
> <br>
> *OVERLAYSYMBOL - It's a deprecated CLASS-level keyword from the pre-STYLE days. It sets the SYMBOL property of the second style. It's there for backwards compatibility only.<br>
> <br>
> *EQUALS - token is valid within the context of MapServer expression parsing. Represents geometry (GEOS) equality...<br>
> <br>
> *MULTIPLE, SINGLE - I don't see why we need these keywords when we have ONE-TO-ONE and ONE-TO-MANY. We're lucky MS_ONE_TO_ONE = MS_SINGLE, etc... and that should be fixed in loadJoin()...<br>
> <br>
> *LINECAP - I concur with the missing triangle option.<br>
> <br>
> -----Original Message-----<br>
> From: mapserver-dev [<a href="mailto:mapserver-dev-bounces@lists.osgeo.org">mailto:mapserver-dev-bounces@lists.osgeo.org</a>] On Behalf Of Seth G<br>
> Sent: Friday, June 23, 2017 6:33 PM<br>
> To: <a href="mailto:mapserver-dev@lists.osgeo.org">mapserver-dev@lists.osgeo.org</a><br>
> Subject: [mapserver-dev] Mapfile keywords questions<br>
> <br>
> Hi list,<br>
> <br>
> I'm trying to get the definitive list of current Mapfile keywords and<br>
> syntax for a Mapfile parser I'm working on<br>
> (<a href="https://github.com/geographika/mappyfile">https://github.com/geographika/mappyfile</a>).<br>
> <br>
> I've gone through the MapServer docs, and also the sourcecode and have a<br>
> few keywords that aren't documented and I'm not sure are still used. If<br>
> anyone has any details on the list below it would be very useful. I can<br>
> open issues if necessary and update docs.<br>
> <br>
> RELATIVETO - mentioned in<br>
> <a href="https://github.com/mapserver/mapserver/issues/1547">https://github.com/mapserver/mapserver/issues/1547</a> (from 2006) and is in<br>
> the maplexer.l file. It is not in the test mapfile created when the<br>
> issue was resolved<br>
> (<a href="https://trac.osgeo.org/mapserver/attachment/ticket/1547/test_points.map">https://trac.osgeo.org/mapserver/attachment/ticket/1547/test_points.map</a>).<br>
> So it may never have been used?<br>
> <br>
> COMPFILTER - <a href="http://www.mapserver.org/development/rfc/ms-rfc-113.html">
http://www.mapserver.org/development/rfc/ms-rfc-113.html</a> -<br>
> not used? Looks interesting! Should be added to<br>
> <a href="http://www.mapserver.org/mapfile/composite.html">http://www.mapserver.org/mapfile/composite.html</a> ?<br>
> <br>
> GRATICULE - used to be a LAYER CONNECTION type, but now deprecated?<br>
> <br>
> SCALETOKEN - should be in <a href="http://www.mapserver.org/mapfile/layer.html">
http://www.mapserver.org/mapfile/layer.html</a><br>
> Documented in <a href="http://www.mapserver.org/output/kerneldensity.html">http://www.mapserver.org/output/kerneldensity.html</a><br>
> <br>
> LATLON - in maplexer.l but not sure where this would be used in a Mapfile.<br>
> <br>
> JAVASCRIPT - it is a token in maplexer.l, but not sure where this would<br>
> be needed (javascript is in quotes as part of the GEOTRANSFORM options)<br>
> <br>
> SCALE - again a token, but I can only find it as a LAYER processing<br>
> option - PROCESSING "SCALE=AUTO"<br>
> <br>
> INDEX - not sure what this keyword is for (and hard to search for..)<br>
> <br>
> SIMPLE, TITLE, VALUES - all in maplexer.l but not in docs.<br>
> <br>
> COLORRANGE and DATARANGE - should be added to the STYLE doc page -<br>
> currently only documented at <a href="http://mapserver.org/output/kerneldensity.html">
http://mapserver.org/output/kerneldensity.html</a><br>
> <br>
> Some keywords only seem valid as part of Mapscript rather than a<br>
> Mapfile: BANDSITEM, OVERLAYSYMBOL, EQUALS, MULTIPLE, SINGLE (I think the<br>
> last 2 are PHP join types only?)<br>
> <br>
> Also some non-quoted values also seem to be missing from the docs:<br>
> <br>
> LINECAP - <a href="http://www.mapserver.org/mapfile/style.html?highlight=linecap">
http://www.mapserver.org/mapfile/style.html?highlight=linecap</a><br>
> - should TRIANGLE be a documented option? It is in maplexer.l and also<br>
> mentioned at<br>
> <a href="http://www.mapserver.org/mapfile/symbology/construction.html#sym-construction">
http://www.mapserver.org/mapfile/symbology/construction.html#sym-construction</a><br>
> <br>
> Regards,<br>
> <br>
> Seth<br>
> <br>
> <br>
<br>
<br>
---<br>
This email has been checked for viruses by Avast antivirus software.<br>
<a href="https://www.avast.com/antivirus">https://www.avast.com/antivirus</a><br>
<br>
_______________________________________________<br>
mapserver-dev mailing list<br>
<a href="mailto:mapserver-dev@lists.osgeo.org">mapserver-dev@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/mapserver-dev">https://lists.osgeo.org/mailman/listinfo/mapserver-dev</a><o:p></o:p></span></p>
</div>
<p class="MsoNormal"><br>
<br>
<br>
<o:p></o:p></p>
<pre>_______________________________________________<o:p></o:p></pre>
<pre>mapserver-dev mailing list<o:p></o:p></pre>
<pre><a href="mailto:mapserver-dev@lists.osgeo.org">mapserver-dev@lists.osgeo.org</a><o:p></o:p></pre>
<pre><a href="https://lists.osgeo.org/mailman/listinfo/mapserver-dev">https://lists.osgeo.org/mailman/listinfo/mapserver-dev</a><o:p></o:p></pre>
</blockquote>
<p class="MsoNormal"><br>
<br>
<o:p></o:p></p>
<pre>-- <o:p></o:p></pre>
<pre>web: <a href="http://geographika.co.uk">http://geographika.co.uk</a><o:p></o:p></pre>
<pre>twitter: @geographika<o:p></o:p></pre>
</div>
</body>
</html>