[mapserver-commits] r8375 - trunk/docs

svn at osgeo.org svn at osgeo.org
Fri Jan 2 10:12:14 EST 2009 

Author: jmckenna
Date: 2009-01-02 10:12:14 -0500 (Fri, 02 Jan 2009)
New Revision: 8375

Modified:
   trunk/docs/introduction.txt
Log:
several changes, including adding readable labels for refs, fixing old links, and improving the Getting Help section

Modified: trunk/docs/introduction.txt
===================================================================
--- trunk/docs/introduction.txt	2009-01-02 15:09:01 UTC (rev 8374)
+++ trunk/docs/introduction.txt	2009-01-02 15:12:14 UTC (rev 8375)
@@ -68,8 +68,6 @@
 Anatomy of a MapServer Application
 -------------------------------------------------------------------------------
 
-Some text goes here.
-
 .. figure:: ./images/architecture.png
     :alt: MapServer Basic Architecture
     
@@ -91,7 +89,7 @@
   supported, this is discussed further below in `Adding data to your site`_.
   
   .. seealso::
-    :ref:`Vector Input Reference <vector>` :ref:`Raster Input Reference <raster>`
+    :ref:`Vector Input Reference <vector>` and :ref:`Raster Input Reference <raster>`
  
 * **HTML Pages** - the interface between the user and MapServer .  
   They normally sit in Web root.  In it's simplest form, MapServer can be called 
@@ -213,8 +211,8 @@
 <http://httpd.apache.org/>`__ or Microsoft Internet Information Server, on the
 machine on which you are installing MapServer. OSGeo4W contains Apache
 already, but you can reconfigure things to use IIS if you need to.
-Alternatively, :ref:`MS4W <windows>` can be used to install MapServer on
-Windows.
+Alternatively, `MS4W <http://www.maptools.org/ms4w/index.phtml>`__ can be 
+used to install MapServer on Windows.
 
 If you are on a Windows machine, and you don't have a HTTP server installed,
 you may want to check out `MS4W <http://www.maptools.org/ms4w/index.phtml>`__,
@@ -228,7 +226,7 @@
 installing pre-compiled MapServer builds on Mac OS X and Linux.
 
 You will also need a Web browser, and a text editor (vi, emacs, notepad,
-homesite) to modify your html and :ref:`Mapfiles <mapfile>`.
+homesite) to modify your html and :ref:`mapfiles <mapfile>`.
 
 Skills
 ...............................................................................
@@ -253,9 +251,9 @@
 The .map file is the basic configuration file for data access and styling for
 MapServer. The file is an ASCII text file, and is made up of different
 objects. Each object has a variety of parameters available for it. All .map
-file (or mapfile) parameters are documented at :ref:`mapfile`. A simple
-mapfile example displaying only one layer follows, as well as the map image
-output:
+file (or mapfile) parameters are documented in the :ref:`mapfile reference 
+<mapfile>`. A simple mapfile example displaying only one layer follows, as well 
+as the map image output:
 
 .. code-block:: mapfile
 
@@ -533,7 +531,7 @@
 * :ref:`LAYER` s can be stored in files and included to any number of applications
 * :ref:`STYLE` s can also be stored and included in multiple applications
 
-The following is an example of using :ref:`mapfile <mapfile>` :ref:`includes
+The following is an example of using mapfile :ref:`includes
 <include>` to include a layer definition in a separate file:
 
 If 'shadedrelief.lay' contains:
@@ -623,7 +621,7 @@
 Unless you are adding layers that fall within the same geographic area as the 
 demo, modify :ref:`MAP` EXTENT 
 to match the extent of your data.  To determine the extent of your data, you can 
-use `ogrinfo <http://www.remotesensing.org/gdal/ogr/ogr_utilities.html>`__.  
+use `ogrinfo <http://www.gdal.org/ogrinfo.html>`__.  
 If you have access to a GIS, you could use that as well.  The :ref:`MAP` EXTENT needs to 
 be in the units of your output projection.
 	
@@ -648,7 +646,7 @@
 `MapInfo <http://www.mapinfo.com/>`__, delimited text files, and more formats with 
 :ref:`ogr`.
 
-See :ref:`vector` for examples on how to add different 
+See the :ref:`Vector Data reference <vector>` for examples on how to add different 
 geographic data sources to your MapServer project.    
 
 Raster Data
@@ -659,8 +657,8 @@
 GRASS, Jpeg2000, ArcInfo Grids, and `more formats
 <http://www.gdal.org/formats_list.html>`__. If you do compile MapServer with
 GDAL, which includes tiff support, do not compile with native tiff support, as
-this will cause a conflict. More specific information can be found in
-:ref:`raster`.
+this will cause a conflict. More specific information can be found in the
+:ref:`Raster Data reference <raster>`.
 
 Projections
 ...............................................................................
@@ -726,7 +724,7 @@
 Interfaces
 ...............................................................................
 
-Talk about OpenLayers http://openlayers.org
+See: OpenLayers http://openlayers.org
 
 Data Optimization
 ...............................................................................
@@ -747,9 +745,9 @@
   to display a small area.  By breaking the data up into tiles and creating a 
   tile index, MapServer only needs to open up and search the data files of 
   interest.  Shapefile data can be broken into smaller tiles and then a 
-  tileindex shapefile can be created using 
-  :ref:`tile4ms`  A shapefile :ref:`tileindex` 
-  for raster files can also be created.
+  tileindex shapefile can be created using the 
+  :ref:`tile4ms <tile4ms>` utility.  A :ref:`tileindex <tileindex>` 
+  shapefile for raster files can also be created.
           
 * **Pre-Classify Your Data** - MapServer allows for the use of quite 
   complex :ref:`EXPRESSIONs <expressions>` 
@@ -761,58 +759,56 @@
   string comparison for the class EXPRESSION.
 
 * **Pre-Process Your Images** - Do resource intensive processing up front.  
-  See :ref:`raster` for more info.
+  See the :ref:`Raster Data reference <raster>` for more info.
 
 * **Generalize for Overview** - create a more simple, generalized data layer 
   to display at small scales, and then use scale-dependent layers utilizing 
   :ref:`LAYER` MINSCALE and 
   LAYER MAXSCALE to show more detailed data layers as the user zooms in.  
   This same concept applies to images.  
-
+  
+.. seealso::
+    :ref:`optimization`
+  
 How do I get Help?
 -------------------------------------------------------------------------------
 
 Documentation
 ...............................................................................
 
+* Official MapServer documentation lives here on this :ref:`site <documentation>`.
 
-List Archives
-...............................................................................
-
-`Archive <http://lists.osgeo.org/pipermail/mapserver-users/>`__ of MapServer Users 
-list.  Check here before posting a question to the listserv, your question has 
-likely been asked before...
-
-`Public, Searchable Archive of MapServer-Users <http://www.nabble.com/MapServer-f1214.html>`__ is available also.
+* User contributed documentation exists on the MapServer `Wiki 
+  <http://trac.osgeo.org/mapserver/wiki/>`__.
 	
-Ask for help
+Users Mailing List
 ...............................................................................
 
-Users Listserv
-...............................................................................
-
 Register and post questions to the 
-`MapServer Users <http://lists.osgeo.org/mailman/listinfo/mapserver-users/>`__ listserv.   
-Questions to the list are usually answered quickly and often by the developers themselves.  A few things to remember:  
+`MapServer Users <http://lists.osgeo.org/mailman/listinfo/mapserver-users/>`__ 
+listserv.  Questions to the list are usually answered quickly and often by the 
+developers themselves.  A few things to remember:  
 
-1. Search the archives for your answer first, people get tired of answering
-the same questions over and over.
+1. `Search the archives <http://www.nabble.com/MapServer-f1214.html>`__ for 
+   your answer first, people get tired of answering
+   the same questions over and over.
 2. Provide version and configuration information for your MapServer
-installation, and relevant snippets of your map and template files.
+   installation, and relevant snippets of your map and template files.
 3. Always post your responses back to the whole list, as opposed to just the
-person who replied to your question.
+   person who replied to your question.
 
 IRC
 ...............................................................................
 
-mapserver users and developers can be found on Internet Relay Chat.  The
+MapServer users and developers can be found on Internet Relay Chat.  The
 channel is #mapserver on irc.freenode.net.  
 
 
 Gallery
 ...............................................................................
 
-`Examples <http://ms.gis.umn.edu/gallery/galleryfolder_view>`__ of MapServer sites
+See `examples <http://ms.gis.umn.edu/gallery/galleryfolder_view>`__ of 
+existing MapServer applications.
 
 Tutorial
 ...............................................................................
@@ -822,7 +818,8 @@
 Test Suite 
 ...............................................................................
 
-`Demonstration <http://noah.dnr.state.mn.us/mapserver_demos/tests46/>`__ of some MapServer functionality
+Download the `MapServer Test Suite <http://noah.dnr.state.mn.us/mapserver_demos/tests46/>`__ 
+for a demonstration of some MapServer functionality.
 
 Books 
 ...............................................................................

More information about the mapserver-commits mailing list