add warnings, mostly about the CGI commands/substitutions/wrappers

- don't use shell wrappers - CGI commands and runsubs are not available for mapscript - antialias document is irrelevant for mapserver >= 6.0
MapServer · Aug 27, 2013 · ff28660 · ff28660
1 parent 92c1514
commit ff28660
Show file tree

Hide file tree

Showing 6 changed files with 33 additions and 8 deletions.
diff --git a/en/cgi/controls.txt b/en/cgi/controls.txt
@@ -7,7 +7,6 @@
  MapServer CGI Controls
 *****************************************************************************
 
-
 Variables
 =========
 
@@ -484,6 +483,13 @@ mapfile parameters through a URL involves changing class expressions
 on-the-fly.  `VALIDATION` can be used to control run-time substition
 (see :ref:`RUNSUB`).  Try it out.
 
+.. warning::
+
+  This functionality is only available via the :ref:`mapserv` CGI application.
+  Within MapScript this is easy to do by yourself since the developer has
+  complete control over how input is handled.
+
+
 
 Using MapServer version >= 5
 ----------------------------

diff --git a/en/cgi/runsub.txt b/en/cgi/runsub.txt
@@ -22,9 +22,13 @@ Introduction
 
 Run-time substitution for the MapServer CGI has been around since version 4.0
 and it's use has continued to expand. In short, it allows you to alter portions
-of a mapfile based on data passed via a CGI request. This functionality is only
-available via the standard CGI application. Within MapScript this is easy to do
-since the developer has complete control over how input is handled.
+of a mapfile based on data passed via a CGI request.
+
+.. warning::
+
+  This functionality is only available via the :ref:`mapserv` CGI application.
+  Within MapScript this is easy to do by yourself since the developer has
+  complete control over how input is handled.
 
 
 

diff --git a/en/cgi/wrapper.txt b/en/cgi/wrapper.txt
@@ -21,6 +21,12 @@ This document presents a simple shell script that can be used to "wrap" the
 MapServer CGI, in order to avoid having to specify the 'map' parameter (or any 
 other chosen parameters) in your MapServer URLs.
 
+.. warning:: Using a wrapper script is inefficient as it implies spawing two
+             processes (shell+mapserv) instead of only one (mapserv), and 
+             should not be used on production installations. Refer to 
+             :ref:`online_resource_wms` for examples of how to setup similar
+             functionality directly by using webserver configuration options.
+
 Script Information
 ------------------
 

diff --git a/en/development/rfc/ms-rfc-93.txt b/en/development/rfc/ms-rfc-93.txt
@@ -77,7 +77,7 @@ Note: due to upcoming changes to text rendering, Truetype symbols and labels ren
 be added in the future.
 
 2.2 Exposing Feature Properties
------------------------------
+-------------------------------
 
 A new layer element (UTFDATA) is added to allow the creation of simple JSON templates using MapServer
 expression syntax identical to what is used with classObj->text class text syntax. UTFDATA is of type
@@ -168,7 +168,7 @@ Here is an image rendered as a JSON with UTFGrid renderer:
     "         ##$$$$$$$###    ''''''(",
     "          ###########'''''''''''",
     "    %%%%#############'''''''''''"
-]
+   ]
 
 And now we get the following keys and datas if we use the UTFITEM with the postal code as the key :
 
@@ -238,12 +238,12 @@ The layer object documentation will need to be updated to reflect the new parame
 additions to talk about configuration options associated with the new output format.
 
 10. Bug ID
----------
+----------
 
 None assigned.
 
 11. Voting history
------------------
+------------------
 
 None
 

diff --git a/en/ogc/mapscript.txt b/en/ogc/mapscript.txt
@@ -30,6 +30,10 @@ This makes it possible to dynamically configure a map object based on
 information in the original request, and to capture the output of processing
 requests for further post-processing.  
 
+.. warning:: :ref:`cgi_controls` and :ref:`runsub` are **not** applied when
+             using mapscript WxS wrappers. It is up to the mapscript code
+             you are writing to apply any mapfile modifications.
+
 =============================================================================
  Python Examples
 =============================================================================

diff --git a/en/output/antialias.txt b/en/output/antialias.txt
@@ -10,6 +10,11 @@
 :Date: $Date$
 :Last Updated: 2009/01/17
 
+.. warning:: This document is outdated. Since version 6.0, MapServer will
+             produce aliased output for the "gd/" drivers, and antialiased
+             output for the "agg/" and "cairo/" ones
+
+
 .. note:: For quality antialiased output from mapserver, it is **highly**
           recommended to use the :ref:`AGG <agg>` rendering. This document
           applies only if you whish to stick to the GD rendering, or if you