[Mapserver-users] Perl/Python/Ruby mapscript development documentation

[Sean Gillies]

Hi,

Following the example of the PHP-mapscript developers, we are now 
maintaining
documentation for the development mapscript in a text file.  In CVS in 
can be
found at mapscript/doc/mapscript.txt.  Language-specific appendices 
will be
at mapscript/doc/python.txt etc.  This new documentation fills the same 
role as
the README file under mapscript/php3.  Is a work in progress, but I'm 
chipping
away at it every day and we'll be caught up with the current state of 
the
development code soon.

We are trying out restructured text as a file format.  It provides just 
enough
structure that it can be parsed and rendered into XML or HTML.  During 
the
evaluation of mapscript.txt I will be regularly generating HTML from 
the text source
and putting it up at

http://users.frii.com/sgillies/examples/mapscript.html

Links to the original text source and documentation about reST and 
links to
download of reST tools are at the bottom of the page.  If users 
appreciate this
development documentation, I'll work the generation of HTML docs into 
the mapserver
nightly build.

If you have considerations that you'd like to add to Bugzilla regarding 
the
development docs, join the discussion here

http://mapserver.gis.umn.edu/bugs/show_bug.cgi?id=576

or discuss here on the list and I'll try to summarize on Bugzilla.

cheers,
Sean


--
Sean Gillies
sgillies at frii dot com
http://users.frii.com/sgillies