[mapserver-commits] r8686 - trunk/docs/tutorial

[svn at osgeo.org]

Author: jmckenna
Date: 2009-03-08 18:03:42 -0400 (Sun, 08 Mar 2009)
New Revision: 8686

Modified:
   trunk/docs/tutorial/example1-1.txt
Log:
fix image and example

Modified: trunk/docs/tutorial/example1-1.txt
===================================================================
--- trunk/docs/tutorial/example1-1.txt	2009-03-08 21:53:26 UTC (rev 8685)
+++ trunk/docs/tutorial/example1-1.txt	2009-03-08 22:03:42 UTC (rev 8686)
@@ -7,13 +7,14 @@
 Map With A Single Layer
 -----------------------
 
-image:: http://biometry.gis.umn.edu/cgi-bin/mapserv.exe?map=/ms4w/apps/tutorial/htdocs/example1-1.map&layer=states&mode=map
+.. image:: http://biometry.gis.umn.edu/cgi-bin/mapserv.exe?map=/ms4w/apps/tutorial/htdocs/example1-1.map&layer=states&mode=map
 
 MapServer can create an image and dump it to a local directory or send it directly to the requesting web browser, as in this example. You can view it without the need for an html page, just enter this URL: `http://&lt;insert hostname or IP address here&gt;/cgi-bin/mapserv.exe?map=/ms4w/apps/tutorial/htdocs/example1-1.map&layer=states&mode=map<http://localhost/cgi-bin/mapserv.exe?map=/ms4w/apps/tutorial/htdocs/example1-1.map&layer=states&mode=map>`__ (Remember to replace "<insert hostname or IP address here>" with your web server's name, e.g. "localhost", or its IP address, e.g. "127.0.0.1").
 
 This URL can be broken into three parts: the first part, http://&lt;insert hostname or IP address here&gt;/cgi-bin/mapserv.exe?, calls the MapServer CGI program. If you invoke it as is you will get this familiar message:
 
 ::
+
      No query information to decode. QUERY_STRING is set, but empty.
 
 The next three parts are what make up the query string.  The query string contains the CGI parameters (variables and their values), with each parameter separated by an ampersand (&amp;). So, looking at the query string, the first parameter "map" has a value "/ms4w/apps/tutorial/htdocs/example1-1.map"--this tells the MapServer CGI program (mapserv or mapserv.exe) what mapfile to process/parse. The next parameter &quot;layer=states&quot;, tells mapserv.exe to "turn on" the states layer--recall that we named our layer object "states".  The last parameter, &quot;mode=map&quot;, tells mapserv.exe what to do with the output from the mapfile. In this case it tells mapserv.exe to dump the image directly to the web browser (the client), without first creating a temporary image on the server. The MapServer &quot;mode&quot; CGI variable takes values other than &quot;map&quot;. For example if you use &quot;mode=browse&quot;, MapServer will dump the image to a temporary directory on the server. The browse mode will not work now but we'll come back to it again later.