[mapserver-commits] r8100 - in trunk/docs: . howto
mapfile/symbology mapscript/php optimization output
references utilities
svn at osgeo.org
svn at osgeo.org
Tue Nov 25 11:32:36 EST 2008
Author: hobu
Date: 2008-11-25 11:32:36 -0500 (Tue, 25 Nov 2008)
New Revision: 8100
Added:
trunk/docs/optimization/fastcgi.txt
trunk/docs/optimization/index.txt
Removed:
trunk/docs/howto/fastcgi.txt
Modified:
trunk/docs/index.txt
trunk/docs/mapfile/symbology/construction.txt
trunk/docs/mapscript/php/by_example.txt
trunk/docs/new_users.txt
trunk/docs/optimization/mapfile.txt
trunk/docs/optimization/raster.txt
trunk/docs/optimization/vector.txt
trunk/docs/output/agg.txt
trunk/docs/output/dynamic_charting.txt
trunk/docs/references/index.txt
trunk/docs/utilities/legend.txt
trunk/docs/utilities/msencrypt.txt
trunk/docs/utilities/scalebar.txt
trunk/docs/utilities/shp2img.txt
trunk/docs/utilities/shptree.txt
trunk/docs/utilities/shptreevis.txt
trunk/docs/utilities/sortshp.txt
trunk/docs/utilities/sym2img.txt
trunk/docs/utilities/tile4ms.txt
trunk/docs/utilities/utilityreference.txt
Log:
fix up warnings, add utility section
Deleted: trunk/docs/howto/fastcgi.txt
===================================================================
--- trunk/docs/howto/fastcgi.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/howto/fastcgi.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,174 +0,0 @@
-*****************************************************************************
- FastCGI
-*****************************************************************************
-
-:Author: Frank Warmerdam
-:Contact: warmerdam at pobox.com
-:Author: Howard Butler
-:Contact: hobu.inc at gmail.com
-:Revision: $Revision$
-:Date: $Date$
-:Last Updated: 2008/07/15
-
-.. contents:: Table of Contents
- :depth: 2
- :backlinks: top
-
-=============================================================================
- Introduction
-=============================================================================
-
-FastCGI is a protocol for keeping cgi-bin style web applications running as a
-daemon to take advantage of preserving memory caches, and amortizing other
-high startup costs (like heavy database connections) over many requests.
-
-=============================================================================
- Obtaining the necessary software
-=============================================================================
-
-1. There are three pieces to the MapServer FastCGI puzzle. First, you need
- the actual FastCGI library. This can be downloaded from
- `http://www.fastcgi.com/ <http://www.fastcgi.com/>`__. This library does
- the usual *configure, make, make install* dance. One added complication
- is that it installs by default in /usr/local, and you might give the
- *configure* command a --prefix=/usr to put it in a location that is
- already visible to ldconfig.
-
-2. Assuming you are running `Apache <http://httpd.apache.org>`__, the next
- piece you need is mod_fcgi. Mod_fcgi depends on the version of Apache
- you are running, so make sure to download the correct fork
- (Apache 1.3 vs. Apache 2).
-
-3. The third and final piece is to compile MapServer with FastCGI support.
- This is pretty straightforward, and all you need to do is tell
- *configure* where the FastCGI library is installed. If you changed
- the prefix variable as described above, this would be:
-
-::
-
- ./configure [other options] --with-fastcgi=/usr
-
-With those pieces in place, the MapServer CGI (mapserv) should now be
-FastCGI-enabled. You can verify this by testing it on with the command line:
-
-::
-
- [hobu at kenyon mapserver-4.4.2]# ./mapserv -v
- MapServer version 4.4.2 OUTPUT=GIF OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP
- SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER SUPPORTS=WMS_CLIENT
- SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT SUPPORTS=FASTCGI INPUT=EPPL7
- INPUT=SDE INPUT=ORACLESPATIAL INPUT=OGR INPUT=GDAL
- INPUT=SHAPEFILE DEBUG=MSDEBUG
-
-=============================================================================
- Configuration
-=============================================================================
-
-1. Modify http.conf to load the FastCGI module.
-
- ::
-
- LoadModule fastcgi_module /usr/lib/apache/1.3/mod_fastcgi.so
-
-2. Add an Apache handler for FastCGI applications.
-
- ::
-
- AddHandler fastcgi-script fcgi
-
-3. Set FastCGI processing information
-
- ::
-
- FastCgiConfig -initial-env PROJ_LIB=/usr/local/share/proj
- -initial-env LD_LIBRARY_PATH=/usr/local/lib:/usr/local/pgsql/lib:/usr3/pkg3/oracle9/lib
- -appConnTimeout 60 -idle-timeout 60 -init-start-delay 1
- -minProcesses 2 -maxClassProcesses 20 -startDelay 5
-
-4. In your mapfile, set a PROCESSING directive to tell FastCGI to cache
- the connections and layer information on all layers for which connection
- caching is desired - ie. all slow layers.
-
- ::
-
- PROCESSING "CLOSE_CONNECTION=DEFER"
-
-
-=============================================================================
- Common Problems
-=============================================================================
-File permissions
--------------------
-Fedora Core 3 doesn't allow FastCGI to write to the process logs (when you
-use RedHat's Apache 2 rather than your own). This is described `here
-<http://www.fastcgi.com/archives/fastcgi-developers/2005-March/003638.html>`__.
-
-Also, FastCGI needs to write its socket information somewhere. This
-can be directed with the *FastCgiIpcDir* directive.
-
-=============================================================================
- FastCGI on Win32
-=============================================================================
-
-MS4W Users
-----------
-
-`MS4W (MapServer for Windows)`_ >= version 2.2.2 contains MapServer compiled with FastCGI support. MS4W version >= 2.2.8 also contains the required Apache module (mod_fcgid), and users must follow the `README instructions`_ to setup FastCGI with their application.
-
-.. _MS4W (MapServer for Windows): http://www.maptools.org/ms4w/
-.. _README instructions: http://www.maptools.org/ms4w/index.phtml?page=README_INSTALL.html#f-fastcgi
-
-
-Building fcgi-2.4.0
--------------------
-
-I used libfcgi-2.4.0 for use with Apache2 from http://www.fastcgi.com.
-
-Binary IO Patch
----------------
-
-It is critical that stdio be in binary mode when PNG and other binary images are written to it. To accomplish this for stdio handled through the FastCGI library, I had to do the following hack to libfcgi/fcgi_stdio.c within the fcgi-2.4.0 distribution.
-
-In FCGI_Accept() made he following change::
-
- if(isCGI) {
- FCGI_stdin->stdio_stream = stdin;
- FCGI_stdin->fcgx_stream = NULL;
- FCGI_stdout->stdio_stream = stdout;
- FCGI_stdout->fcgx_stream = NULL;
- FCGI_stderr->stdio_stream = stderr;
- FCGI_stderr->fcgx_stream = NULL;
-
- /* FrankWarmerdam: added so that returning PNG and other binary data
- will still work */
- #ifdef _WIN32
- _setmode( _fileno(stdout), _O_BINARY);
- _setmode( _fileno(stdin), _O_BINARY);
- #endif
-
- } else {
-
-Also, add the following just before the FCGI_Accept() function::
-
- #ifdef _WIN32
- #include <fcntl.h>
- #include <io.h>
- #endif
-
-I'm sure there is a better way of accomplishing this. If you know how, please let me know!
-
-Building libfcgi
-----------------
-
-The makefile.nt should be fine. Just ensure you have run VCVARS32.BAT (as is needed for building MapServer) and then issue the command::
-
- nmake /f makefile.nt
-
-Then the .lib and .dll will be in libfcgi/Debug?. Make sure you copy the DLL somewhere appropriate (such as your cgi-bin directory).
-
-Other Issues
-------------
-
-1) FastCGI's receive a very limited environment on win32, seemingly even more restricted than normal cgi's started by apache. Make sure that all DLLs required are either in the fastcgi directory or in windows\system32. Any missing DLLs will result in very cryptic errors in the error_log, including stuff about Overlapping read requests failing or something like that.
-
-2) Make sure you use a libfcgi.dll built against the same runtime library as your mapserv.exe (and possibly libmap_fcgi.dll) or you will suffer a world of pain! Different runtime libraries have different "environ" variables (as well as their own stdio and heaps). You can check that everything is using MSVCRT.DLL (or all using MSVCRTD.DLL) using the MS SDK Dependency Walker.
Modified: trunk/docs/index.txt
===================================================================
--- trunk/docs/index.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/index.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -17,7 +17,9 @@
output/index
ogc/index
compilation/index
-
+ optimization/index
+ utilities/index
+
Indices and tables
==================
Modified: trunk/docs/mapfile/symbology/construction.txt
===================================================================
--- trunk/docs/mapfile/symbology/construction.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/mapfile/symbology/construction.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -565,7 +565,7 @@
(see the following figure). Default is 'not set' but do not specify the string
'not set', just omit the parameter LINEJOIN.
-.. image:: ../../images/linejoin.png
+.. image:: ../../images/linejoin.jpg
Miter
follow line borders until they intersect, fill the resulting area.
@@ -579,7 +579,7 @@
None
Lines will not be connected but drawn with LINECAPP 'butt' at the respective ends.
-.. image:: ../../images/miter-linejoin.png
+.. image:: ../../images/miter-linejoin.jpg
LINEJOINMAXSIZE
+++++++++++++++
Modified: trunk/docs/mapscript/php/by_example.txt
===================================================================
--- trunk/docs/mapscript/php/by_example.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/mapscript/php/by_example.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -85,7 +85,7 @@
at the following diagram (I apologize again for the maintainer's lack of graphic
design taste).
-.. image:: ../image/phpmapscript-byexample.png
+.. image:: ../../images/phpmapscript-byexample-map.png
It all starts as everything on the Web. A browser requests a certain URL through
HTTP. The request arrives at the web server, which, in turn, delivers a file or
@@ -262,7 +262,7 @@
The output (using the europe shapefile) should look like this:
-.. image:: ../image/phpmapscript-byexample-map.png
+.. image:: ../../images/phpmapscript-byexample-map.png
Zooming and Panning
-------------------
Modified: trunk/docs/new_users.txt
===================================================================
--- trunk/docs/new_users.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/new_users.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -21,7 +21,8 @@
The request may also return images for legends, scale bars, reference maps,
and values passed as CGI variables. Here is a conceptual
-.. image:: ../images/msappdiagram.png
+.. image:: ./images/msappdiagram.png
+
of a typical MapServer application.
Copied: trunk/docs/optimization/fastcgi.txt (from rev 8098, trunk/docs/howto/fastcgi.txt)
===================================================================
--- trunk/docs/optimization/fastcgi.txt (rev 0)
+++ trunk/docs/optimization/fastcgi.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -0,0 +1,176 @@
+.. _fastcgi:
+
+*****************************************************************************
+ FastCGI
+*****************************************************************************
+
+:Author: Frank Warmerdam
+:Contact: warmerdam at pobox.com
+:Author: Howard Butler
+:Contact: hobu.inc at gmail.com
+:Revision: $Revision$
+:Date: $Date$
+:Last Updated: 2008/07/15
+
+.. contents:: Table of Contents
+ :depth: 2
+ :backlinks: top
+
+=============================================================================
+ Introduction
+=============================================================================
+
+FastCGI is a protocol for keeping cgi-bin style web applications running as a
+daemon to take advantage of preserving memory caches, and amortizing other
+high startup costs (like heavy database connections) over many requests.
+
+=============================================================================
+ Obtaining the necessary software
+=============================================================================
+
+1. There are three pieces to the MapServer FastCGI puzzle. First, you need
+ the actual FastCGI library. This can be downloaded from
+ `http://www.fastcgi.com/ <http://www.fastcgi.com/>`__. This library does
+ the usual *configure, make, make install* dance. One added complication
+ is that it installs by default in /usr/local, and you might give the
+ *configure* command a --prefix=/usr to put it in a location that is
+ already visible to ldconfig.
+
+2. Assuming you are running `Apache <http://httpd.apache.org>`__, the next
+ piece you need is mod_fcgi. Mod_fcgi depends on the version of Apache
+ you are running, so make sure to download the correct fork
+ (Apache 1.3 vs. Apache 2).
+
+3. The third and final piece is to compile MapServer with FastCGI support.
+ This is pretty straightforward, and all you need to do is tell
+ *configure* where the FastCGI library is installed. If you changed
+ the prefix variable as described above, this would be:
+
+::
+
+ ./configure [other options] --with-fastcgi=/usr
+
+With those pieces in place, the MapServer CGI (mapserv) should now be
+FastCGI-enabled. You can verify this by testing it on with the command line:
+
+::
+
+ [hobu at kenyon mapserver-4.4.2]# ./mapserv -v
+ MapServer version 4.4.2 OUTPUT=GIF OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP
+ SUPPORTS=PROJ SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER SUPPORTS=WMS_CLIENT
+ SUPPORTS=WFS_SERVER SUPPORTS=WFS_CLIENT SUPPORTS=FASTCGI INPUT=EPPL7
+ INPUT=SDE INPUT=ORACLESPATIAL INPUT=OGR INPUT=GDAL
+ INPUT=SHAPEFILE DEBUG=MSDEBUG
+
+=============================================================================
+ Configuration
+=============================================================================
+
+1. Modify http.conf to load the FastCGI module.
+
+ ::
+
+ LoadModule fastcgi_module /usr/lib/apache/1.3/mod_fastcgi.so
+
+2. Add an Apache handler for FastCGI applications.
+
+ ::
+
+ AddHandler fastcgi-script fcgi
+
+3. Set FastCGI processing information
+
+ ::
+
+ FastCgiConfig -initial-env PROJ_LIB=/usr/local/share/proj
+ -initial-env LD_LIBRARY_PATH=/usr/local/lib:/usr/local/pgsql/lib:/usr3/pkg3/oracle9/lib
+ -appConnTimeout 60 -idle-timeout 60 -init-start-delay 1
+ -minProcesses 2 -maxClassProcesses 20 -startDelay 5
+
+4. In your mapfile, set a PROCESSING directive to tell FastCGI to cache
+ the connections and layer information on all layers for which connection
+ caching is desired - ie. all slow layers.
+
+ ::
+
+ PROCESSING "CLOSE_CONNECTION=DEFER"
+
+
+=============================================================================
+ Common Problems
+=============================================================================
+File permissions
+-------------------
+Fedora Core 3 doesn't allow FastCGI to write to the process logs (when you
+use RedHat's Apache 2 rather than your own). This is described `here
+<http://www.fastcgi.com/archives/fastcgi-developers/2005-March/003638.html>`__.
+
+Also, FastCGI needs to write its socket information somewhere. This
+can be directed with the *FastCgiIpcDir* directive.
+
+=============================================================================
+ FastCGI on Win32
+=============================================================================
+
+MS4W Users
+----------
+
+`MS4W (MapServer for Windows)`_ >= version 2.2.2 contains MapServer compiled with FastCGI support. MS4W version >= 2.2.8 also contains the required Apache module (mod_fcgid), and users must follow the `README instructions`_ to setup FastCGI with their application.
+
+.. _MS4W (MapServer for Windows): http://www.maptools.org/ms4w/
+.. _README instructions: http://www.maptools.org/ms4w/index.phtml?page=README_INSTALL.html#f-fastcgi
+
+
+Building fcgi-2.4.0
+-------------------
+
+I used libfcgi-2.4.0 for use with Apache2 from http://www.fastcgi.com.
+
+Binary IO Patch
+---------------
+
+It is critical that stdio be in binary mode when PNG and other binary images are written to it. To accomplish this for stdio handled through the FastCGI library, I had to do the following hack to libfcgi/fcgi_stdio.c within the fcgi-2.4.0 distribution.
+
+In FCGI_Accept() made he following change::
+
+ if(isCGI) {
+ FCGI_stdin->stdio_stream = stdin;
+ FCGI_stdin->fcgx_stream = NULL;
+ FCGI_stdout->stdio_stream = stdout;
+ FCGI_stdout->fcgx_stream = NULL;
+ FCGI_stderr->stdio_stream = stderr;
+ FCGI_stderr->fcgx_stream = NULL;
+
+ /* FrankWarmerdam: added so that returning PNG and other binary data
+ will still work */
+ #ifdef _WIN32
+ _setmode( _fileno(stdout), _O_BINARY);
+ _setmode( _fileno(stdin), _O_BINARY);
+ #endif
+
+ } else {
+
+Also, add the following just before the FCGI_Accept() function::
+
+ #ifdef _WIN32
+ #include <fcntl.h>
+ #include <io.h>
+ #endif
+
+I'm sure there is a better way of accomplishing this. If you know how, please let me know!
+
+Building libfcgi
+----------------
+
+The makefile.nt should be fine. Just ensure you have run VCVARS32.BAT (as is needed for building MapServer) and then issue the command::
+
+ nmake /f makefile.nt
+
+Then the .lib and .dll will be in libfcgi/Debug?. Make sure you copy the DLL somewhere appropriate (such as your cgi-bin directory).
+
+Other Issues
+------------
+
+1) FastCGI's receive a very limited environment on win32, seemingly even more restricted than normal cgi's started by apache. Make sure that all DLLs required are either in the fastcgi directory or in windows\system32. Any missing DLLs will result in very cryptic errors in the error_log, including stuff about Overlapping read requests failing or something like that.
+
+2) Make sure you use a libfcgi.dll built against the same runtime library as your mapserv.exe (and possibly libmap_fcgi.dll) or you will suffer a world of pain! Different runtime libraries have different "environ" variables (as well as their own stdio and heaps). You can check that everything is using MSVCRT.DLL (or all using MSVCRTD.DLL) using the MS SDK Dependency Walker.
Added: trunk/docs/optimization/index.txt
===================================================================
--- trunk/docs/optimization/index.txt (rev 0)
+++ trunk/docs/optimization/index.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -0,0 +1,15 @@
+.. _optimization:
+
+*****************************************************************************
+ Optimization
+*****************************************************************************
+
+.. toctree::
+ :maxdepth: 2
+
+ mapfile
+ vector
+ raster
+ fastcgi
+
+
Modified: trunk/docs/optimization/mapfile.txt
===================================================================
--- trunk/docs/optimization/mapfile.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/optimization/mapfile.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,5 @@
+.. _mapfile_tuning:
+
*****************************************************************************
MapFile Tuning
*****************************************************************************
@@ -8,8 +10,6 @@
:Date: $Date$
:Last Updated: 2007/08/01
-.. sectnum::
-
.. contents:: Table of Contents
:depth: 2
:backlinks: top
Modified: trunk/docs/optimization/raster.txt
===================================================================
--- trunk/docs/optimization/raster.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/optimization/raster.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,5 @@
+.. _raster_optimization:
+
*****************************************************************************
Optimizing raster data sources
*****************************************************************************
@@ -7,8 +9,6 @@
:Date: $Date$
:Last Updated: 2008/08/08
-.. sectnum::
-
.. contents:: Table of Contents
:depth: 2
:backlinks: top
Modified: trunk/docs/optimization/vector.txt
===================================================================
--- trunk/docs/optimization/vector.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/optimization/vector.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,5 @@
+.. _vector_optimization:
+
*****************************************************************************
Optimizing vector data sources
*****************************************************************************
@@ -7,8 +9,6 @@
:Date: $Date$
:Last Updated: 2008/08/08
-.. sectnum::
-
.. contents:: Table of Contents
:depth: 2
:backlinks: top
Modified: trunk/docs/output/agg.txt
===================================================================
--- trunk/docs/output/agg.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/output/agg.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -17,7 +17,7 @@
Mapserver 5.0 will be released with a new rendering backend. This howto details
the changes and new functionality that this adds to map creation. This howto supposes
you already now the basics of mapfile syntax. If not, you should probably be reading
-`the mapfile syntax </docs/reference/mapfile>`__.
+:ref:`the mapfile syntax <mapfile>`.
Setting the OutputFormat
========================
@@ -93,7 +93,7 @@
facing north (optionally rotated by the ANGLE of the current style), or
a negative value for symbols that should follow the line orientation
-.. image:: /docs/howto/agg-rendering-specifics/linesymbolization.png
+.. image:: ../images/linesymbolization.png
* This happens by default if a line's style is given a symbol of type vector
or pixmap. To enable "shield" symbolization, i.e. a marker placed only on
@@ -133,7 +133,7 @@
that is rendered in a class where SIZE is 15 will be rendered like
-.. image:: solid-symbol-gap
+.. image:: ../images/solid-symbol-gap.png
* layers of type CIRCLE support hatch type symbol filling
* the ENCODING keyword for labels is now enforced. If unset, mapserver will
Modified: trunk/docs/output/dynamic_charting.txt
===================================================================
--- trunk/docs/output/dynamic_charting.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/output/dynamic_charting.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -35,8 +35,8 @@
Output from AGG and GD Renderers
-.. image:: ../../images/renderer-agg.png
-.. image:: ../../images/gd-renderer.png
+.. image:: ../images/renderer-agg.png
+.. image:: ../images/gd-renderer.png
Adding a Chart Layer to a Mapfile
Modified: trunk/docs/references/index.txt
===================================================================
--- trunk/docs/references/index.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/references/index.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -15,4 +15,5 @@
output/index
ogc/index
compilation/index
-
+ optimization/index
+ utilities/index
Modified: trunk/docs/utilities/legend.txt
===================================================================
--- trunk/docs/utilities/legend.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/utilities/legend.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,9 @@
+.. _legend:
+
+*****************************************************************************
+ legend
+*****************************************************************************
+
:Purpose: Creates a legend from a mapfile. Output is either PNG or GIF depending
on what version of the GD library used.
Modified: trunk/docs/utilities/msencrypt.txt
===================================================================
--- trunk/docs/utilities/msencrypt.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/utilities/msencrypt.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,10 @@
+.. _msencrypt:
+
+*****************************************************************************
+ msencrypt
+*****************************************************************************
+
+
:Purpose:
Used to create an encryption key or to encrypt portions of connection strings for
use in mapfiles (added in v4.10) . Typically you might want to encrypt portions of
Modified: trunk/docs/utilities/scalebar.txt
===================================================================
--- trunk/docs/utilities/scalebar.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/utilities/scalebar.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,9 @@
+.. _scalebar:
+
+*****************************************************************************
+ scalebar
+*****************************************************************************
+
:Purpose: Creates a scalebar from a mapfile. Output is either PNG or GIF depending
on what version of the GD library used.
Modified: trunk/docs/utilities/shp2img.txt
===================================================================
--- trunk/docs/utilities/shp2img.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/utilities/shp2img.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,10 @@
+.. _shp2img:
+
+*****************************************************************************
+ shp2img
+*****************************************************************************
+
+
:Purpose:
Creates a map image from a mapfile. Output is either PNG or GIF depending
on what version of the GD library is used. This is a useful utility to test your
Modified: trunk/docs/utilities/shptree.txt
===================================================================
--- trunk/docs/utilities/shptree.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/utilities/shptree.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,10 @@
+.. _shptree:
+
+*****************************************************************************
+ shptree
+*****************************************************************************
+
+
:Purpose: Creates a quadtree-based spatial index for a shapefile. The default
tree depth is calculated so that each tree node (quadtree cell) contains 8 shapes.
Do not use the default with point files, a value between 6 and 10 seems to work ok.
Modified: trunk/docs/utilities/shptreevis.txt
===================================================================
--- trunk/docs/utilities/shptreevis.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/utilities/shptreevis.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,10 @@
+.. _shptreevis:
+
+*****************************************************************************
+ shptreevis
+*****************************************************************************
+
+
:Purpose:
This utility can be used to view the quadtree quadrants that are part of a .qix file
(that was created with the shptree utility).
Modified: trunk/docs/utilities/sortshp.txt
===================================================================
--- trunk/docs/utilities/sortshp.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/utilities/sortshp.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,9 @@
+.. _sortshp:
+
+*****************************************************************************
+ sortshp
+*****************************************************************************
+
:Purpose:
Sorts a shapefile based on a single column in ascending or descending order.
Supports INTEGER, DOUBLE and STRING column types. Useful for prioritizing shapes
Modified: trunk/docs/utilities/sym2img.txt
===================================================================
--- trunk/docs/utilities/sym2img.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/utilities/sym2img.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,9 @@
+.. _sym2img:
+
+*****************************************************************************
+ legend
+*****************************************************************************
+
:Purpose: Creates a graphic dump of a symbol file. Output is either PNG or GIF
depending on what version of the GD library used. (this utility is not currently
included in pre-compiled packages, due to issues mentioned in `bug#506`_)
@@ -7,4 +13,4 @@
sym2img [symbolfile] [outfile]
-.. _`bug#506`: http://mapserver.gis.umn.edu/bugs/show_bug.cgi?id=506
+.. _`bug#506`: http://trac.osgeo.org/mapserver/ticket/506
Modified: trunk/docs/utilities/tile4ms.txt
===================================================================
--- trunk/docs/utilities/tile4ms.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/utilities/tile4ms.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,9 @@
+.. _tile4ms:
+
+*****************************************************************************
+ tile4ms
+*****************************************************************************
+
:Purpose:
Creates a tile index shapefile for use with MapServer's TILEINDEX feature. The program
creates a shapefile of rectangles from extents of all the shapefiles listed in [metafile]
Modified: trunk/docs/utilities/utilityreference.txt
===================================================================
--- trunk/docs/utilities/utilityreference.txt 2008-11-25 16:09:58 UTC (rev 8099)
+++ trunk/docs/utilities/utilityreference.txt 2008-11-25 16:32:36 UTC (rev 8100)
@@ -1,3 +1,10 @@
+.. _ut_ref:
+
+*****************************************************************************
+ utility Reference
+*****************************************************************************
+
+
.. contents:: Table of Contents
:depth: 2
:backlinks: top
More information about the mapserver-commits
mailing list