Reworked all the svn:ignore properties. They are all set explicitely now, and nothing should be left unacounted for.

Changed SConstruct to use freetype-config.  Updated INSTALL to reflect.

Added a RAM requirement for building in the INSTALL doc.

Fixed some python styling and added some basic docstrings.

INSTALL

@@ -31,6 +31,7 @@ All of these will normally come with any modern Linux distribution.
 
 If your system does NOT have one of these installed, you will need to install the mandatory ones at the very least before proceeding further.  Instructions on how to do this will come with each individual package.
 
+Also, a minimum of 256MB of RAM is recommended for the build process.
 
 Building
 --------
@@ -64,13 +65,9 @@ BOOST_LIBS: Search path for boost library files ( /path/to/BOOST_LIBS )
     default: /usr/lib
     actual: /usr/lib
 
-FREETYPE_INCLUDES: Search path for FreeType include files ( /path/to/FREETYPE_INCLUDES )
-    default: /usr/include
-    actual: /usr/include
-
-FREETYPE_LIBS: Search path for FreeType library files ( /path/to/FREETYPE_LIBS )
-    default: /usr/lib
-    actual: /usr/lib
+FREETYPE_CONFIG: The path to the freetype-config executable. ( /path/to/FREETYPE_CONFIG )
+    default: /usr/bin/freetype-config
+    actual: /usr/bin/freetype-config
 
 PNG_INCLUDES: Search path for libpng include files ( /path/to/PNG_INCLUDES )
     default: /usr/include
@@ -152,7 +149,7 @@ If you're using the default PREFIX, you will most likely need to be root to perf
 Test
 ----
 
-There currently are no easy way to test your setup, other than write some code to generate a map.
+There currently is no easy way to test your setup, other than write some code to generate a map.
 
 One simple thing you can do is try to load the Python module, and make sure it does so without errors:
 

SConstruct

@@ -24,8 +24,7 @@ opts = Options()
 opts.Add('PREFIX', 'The install path "prefix"', '/usr/local')
 opts.Add(PathOption('BOOST_INCLUDES', 'Search path for boost include files', '/usr/include'))
 opts.Add(PathOption('BOOST_LIBS', 'Search path for boost library files', '/usr/lib'))
-opts.Add(PathOption('FREETYPE_INCLUDES', 'Search path for FreeType include files', '/opt/freetype/include/freetype2'))
-opts.Add(PathOption('FREETYPE_LIBS', 'Search path for FreeType library files', '/opt/freetype/lib'))
+opts.Add(PathOption('FREETYPE_CONFIG', 'The path to the freetype-config executable.', '/usr/bin/freetype-config'))
 opts.Add(PathOption('PNG_INCLUDES', 'Search path for libpng include files', '/usr/include'))
 opts.Add(PathOption('PNG_LIBS', 'Search path for libpng include files', '/usr/lib'))
 opts.Add(PathOption('JPEG_INCLUDES', 'Search path for libjpeg include files', '/usr/include'))
@@ -49,21 +48,22 @@ conf = Configure(env)
 
 env['CPPPATH'] = ['#agg/include', '#include']
 
-for path in [env['BOOST_INCLUDES'], env['FREETYPE_INCLUDES'], env['PNG_INCLUDES'], env['JPEG_INCLUDES'], env['TIFF_INCLUDES'], env['PGSQL_INCLUDES']]:
+for path in [env['BOOST_INCLUDES'], env['PNG_INCLUDES'], env['JPEG_INCLUDES'], env['TIFF_INCLUDES'], env['PGSQL_INCLUDES']]:
     if path not in env['CPPPATH']: env['CPPPATH'].append(path)
 
 env['LIBPATH'] = ['#agg', '#src']
 
-for path in [env['BOOST_LIBS'], env['FREETYPE_LIBS'], env['PNG_LIBS'], env['JPEG_LIBS'], env['TIFF_LIBS'], env['PGSQL_LIBS']]:
+for path in [env['BOOST_LIBS'], env['PNG_LIBS'], env['JPEG_LIBS'], env['TIFF_LIBS'], env['PGSQL_LIBS']]:
     if path not in env['LIBPATH']: env['LIBPATH'].append(path)
 
+env.ParseConfig(env['FREETYPE_CONFIG'] + ' --libs --cflags')
+
 C_LIBSHEADERS = [
     ['ltdl', 'ltdl.h', True],
     ['png', 'png.h', True],
     ['tiff', 'tiff.h', True],
     ['z', 'zlib.h', True],
-    ['jpeg', ['stdio.h','jpeglib.h'], True],
-    #['freetype', 'ft2build.h', True],
+    ['jpeg', ['stdio.h', 'jpeglib.h'], True],
     ['pq', 'libpq-fe.h', False]
 ]
 

bindings/python/mapnik_envelope.cpp

@@ -58,7 +58,7 @@ bool (Envelope<double>::*intersects_p3)(Envelope<double> const&) const = &Envelo
 void export_envelope()
 {
     using namespace boost::python;
-    class_<Envelope<double> >("Envelope",init<double,double,double,double>())
+    class_<Envelope<double> >("Envelope","A spacial envelope (i.e. bounding box) which also defines some basic operators.",init<double,double,double,double>())
         .def(init<>())
 	.def(init<const coord<double,2>&, const coord<double,2>&>())
         .add_property("minx",&Envelope<double>::minx)

bindings/python/mapnik_filter.cpp

@@ -38,7 +38,7 @@ namespace
 void export_filter()
 {
     using namespace boost::python;
-    class_<filter<Feature>,boost::noncopyable>("Filter",no_init)
+    class_<filter<Feature>,boost::noncopyable>("Filter","An expression which allows to select features.",no_init)
 	.def("__str__",&filter<Feature>::to_string);
 	;
     def("filter",&create_filter);

bindings/python/mapnik_image.cpp

@@ -32,7 +32,7 @@ char const* rawdata(const Image32& image)
 void export_image()
 {
     using namespace boost::python;
-    class_<Image32>("Image",init<int,int>())
+    class_<Image32>("Image","This class represents a 32 bit image.",init<int,int>())
     ;
     def("rawdata",&rawdata);
 }

bindings/python/mapnik_layer.cpp

@@ -104,7 +104,7 @@ void export_layer()
     	.def(vector_indexing_suite<std::vector<std::string>,true >())
     	;
     
-    class_<Layer>("Layer",no_init)
+    class_<Layer>("Layer","A map layer.",no_init)
         .def("name",&Layer::name,return_value_policy<copy_const_reference>())
         .def("params",&Layer::params,return_value_policy<reference_existing_object>())
         .def("envelope",&Layer::envelope)

src/SConscript

@@ -24,7 +24,6 @@ Import('env')
 prefix = env['PREFIX']
 
 libraries = ['agg'] + env['LIBS']
-libraries += ['freetype']
 
 linkflags = '-Wl,-rpath-link,. -Wl,-soname,libmapnik.so'