[mapserver-commits] r8255 - in trunk/docs: . _templates management utilities

svn at osgeo.org svn at osgeo.org
Thu Dec 18 11:55:50 EST 2008


Author: hobu
Date: 2008-12-18 11:55:49 -0500 (Thu, 18 Dec 2008)
New Revision: 8255

Added:
   trunk/docs/contents.txt
   trunk/docs/utilities/manage.txt
Removed:
   trunk/docs/management/systemmanage.txt
Modified:
   trunk/docs/_templates/layout.html
   trunk/docs/conf.py
   trunk/docs/documentation.txt
   trunk/docs/utilities/index.txt
Log:
tweak layout, move management doc

Modified: trunk/docs/_templates/layout.html
===================================================================
--- trunk/docs/_templates/layout.html	2008-12-17 17:24:29 UTC (rev 8254)
+++ trunk/docs/_templates/layout.html	2008-12-18 16:55:49 UTC (rev 8255)
@@ -6,7 +6,7 @@
 
 <div style="padding: 10px 10px 15px 15px; background-color: white; text-align: right; float: right; vertical-align: bottom;">
 <a href="http://svn.osgeo.org/mapserver">Source</a> |
-<a href="http://trac.osgeo.org/trac">Bugs</a> |
+<a href="http://trac.osgeo.org/mapserver">Bugs</a> |
 <a href="{{ pathto('documentation') }}">Docs</a> (<a href="/MapServer.pdf">pdf</a>) |
 <a href="{{ pathto('download') }}">Download </a>
 </div>

Modified: trunk/docs/conf.py
===================================================================
--- trunk/docs/conf.py	2008-12-17 17:24:29 UTC (rev 8254)
+++ trunk/docs/conf.py	2008-12-18 16:55:49 UTC (rev 8255)
@@ -35,7 +35,7 @@
 #source_encoding = 'utf-8'
 
 # The master toctree document.
-master_doc = 'documentation'
+master_doc = 'contents'
 
 # General information about the project.
 project = u'MapServer'
@@ -165,7 +165,7 @@
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, document class [howto/manual]).
 latex_documents = [
-  ('documentation', 'MapServer.tex', ur'MapServer Documentation',
+  ('contents', 'MapServer.tex', ur'MapServer Documentation',
    ur'The MapServer Team', 'manual', False),
 ]
 

Added: trunk/docs/contents.txt
===================================================================
--- trunk/docs/contents.txt	                        (rev 0)
+++ trunk/docs/contents.txt	2008-12-18 16:55:49 UTC (rev 8255)
@@ -0,0 +1,21 @@
+.. _contents:
+
+***************************************************
+ Contents page for TOC
+***************************************************
+
+.. toctree::
+   :maxdepth: 1
+
+   new_users
+   installation/index
+   mapfile/index
+   mapscript/index
+   input/index
+   output/index
+   ogc/index
+
+   optimization/index
+   utilities/index
+   cgi/index
+   development/index
\ No newline at end of file

Modified: trunk/docs/documentation.txt
===================================================================
--- trunk/docs/documentation.txt	2008-12-17 17:24:29 UTC (rev 8254)
+++ trunk/docs/documentation.txt	2008-12-18 16:55:49 UTC (rev 8255)
@@ -1,21 +1,7 @@
 .. _documentation:
 
 ***************************************************
- MapServer Documentation
+ MapServer |release| Documentation
 ***************************************************
 
-.. toctree::
-   :maxdepth: 1
-
-   new_users
-   installation/index
-   mapfile/index
-   mapscript/index
-   input/index
-   output/index
-   ogc/index
-
-   optimization/index
-   utilities/index
-   cgi/index
-   development/index
\ No newline at end of file
+Some docs...
\ No newline at end of file

Deleted: trunk/docs/management/systemmanage.txt
===================================================================
--- trunk/docs/management/systemmanage.txt	2008-12-17 17:24:29 UTC (rev 8254)
+++ trunk/docs/management/systemmanage.txt	2008-12-18 16:55:49 UTC (rev 8255)
@@ -1,49 +0,0 @@
-File Placement
---------------
-
-MapServer requires a number of different files to execute. Except for graphics 
-that are referenced in output templates (i.e. web pages) none of the data or 
-configuration files need be accessible via a web server. File naming for  
-MapServer follows two rules:
-
-1. Files may be given using their full system path. *or*
-2. Files may be given using a relative path where the path is relative to 
-   the location of the file they are being referenced from.
-
-So, for files referenced in the Mapfile they can be given relative
-to the location of the Mapfile. Same holds true for symbol sets and font sets.
-
-Temporary  Files
-----------------
-
-MapServer also can produce a number of files (i.e. maps, legends, scalebars, etc...). 
-These files **must** be accessible using a web server. To accomplish this 
-MapServer creates these files in a scratch directory. The location of that 
-directory is given using the IMAGEPATH and IMAGEURL parameters in the web 
-section of a Mapfile. The scratch directory must be writable by the user that 
-the web server runs under, usually *nobody*. It is recommended for security 
-reasons that the web user own the scratch directory rather than making it 
-world writable. The scratch area will need to be cleaned periodically. 
-On busy sites this may need to happen several times an hour. Here's an 
-example shell script that could be run using *cron*:
-
-::
-
-    #!/bin/csh
-
-    find /usr/local/www/docs/tmp -follow -name "*.gif" -exec rm {} \;   
-
-
-Windows
-#######
-
-The following *.bat* file can be used in 'Scheduled Tasks' to remove these 
-temporary images daily:
-
-::
-
-    REM this script deletes the contents of the ms_tmp directory 
-    REM (i.e. the MapServer-created gifs)
-    
-    cd D:\ms4w\tmp\ms_tmp
-    echo Y | del *.*
\ No newline at end of file

Modified: trunk/docs/utilities/index.txt
===================================================================
--- trunk/docs/utilities/index.txt	2008-12-17 17:24:29 UTC (rev 8254)
+++ trunk/docs/utilities/index.txt	2008-12-18 16:55:49 UTC (rev 8255)
@@ -18,4 +18,5 @@
    sortshp
    sym2img
    tile4ms
+   management
    

Copied: trunk/docs/utilities/manage.txt (from rev 8246, trunk/docs/management/systemmanage.txt)
===================================================================
--- trunk/docs/utilities/manage.txt	                        (rev 0)
+++ trunk/docs/utilities/manage.txt	2008-12-18 16:55:49 UTC (rev 8255)
@@ -0,0 +1,55 @@
+.. _management:
+
+*****************************************************************************
+ Management
+*****************************************************************************
+
+File Placement
+--------------
+
+MapServer requires a number of different files to execute. Except for graphics 
+that are referenced in output templates (i.e. web pages) none of the data or 
+configuration files need be accessible via a web server. File naming for  
+MapServer follows two rules:
+
+1. Files may be given using their full system path. *or*
+2. Files may be given using a relative path where the path is relative to 
+   the location of the file they are being referenced from.
+
+So, for files referenced in the Mapfile they can be given relative
+to the location of the Mapfile. Same holds true for symbol sets and font sets.
+
+Temporary  Files
+----------------
+
+MapServer also can produce a number of files (i.e. maps, legends, scalebars, etc...). 
+These files **must** be accessible using a web server. To accomplish this 
+MapServer creates these files in a scratch directory. The location of that 
+directory is given using the IMAGEPATH and IMAGEURL parameters in the web 
+section of a Mapfile. The scratch directory must be writable by the user that 
+the web server runs under, usually *nobody*. It is recommended for security 
+reasons that the web user own the scratch directory rather than making it 
+world writable. The scratch area will need to be cleaned periodically. 
+On busy sites this may need to happen several times an hour. Here's an 
+example shell script that could be run using *cron*:
+
+::
+
+    #!/bin/csh
+
+    find /usr/local/www/docs/tmp -follow -name "*.gif" -exec rm {} \;   
+
+
+Windows
+#######
+
+The following *.bat* file can be used in 'Scheduled Tasks' to remove these 
+temporary images daily:
+
+::
+
+    REM this script deletes the contents of the ms_tmp directory 
+    REM (i.e. the MapServer-created gifs)
+    
+    cd D:\ms4w\tmp\ms_tmp
+    echo Y | del *.*
\ No newline at end of file



More information about the mapserver-commits mailing list