[[PageOutline]]

= Developer's Information =

This page is targeted at developers wishing to delve deeper into Proj4js internals.

== Git access ==

The git repository for Proj4js can be found at http://github.com/proj4js/proj4js.

Due to difficulties encountered extracting the code from the [http://docs.codehaus.org/display/MAP/Home/ MapBuilder] project, we were unable to preserve the SVN history.  However, the history will continue to be available through the MapBuilder SVN.  The relevant directories are:
 * https://svn.codehaus.org/mapbuilder/cscs
 * https://svn.codehaus.org/mapbuilder/trunk/mapbuilder/lib/util/proj4js
 * https://svn.codehaus.org/mapbuilder/tags/mapbuilder-lib-1_0-release/mapbuilder/lib/model/Proj.js

== Building Proj4js ==
=== 1.3.1 and later ===
See https://github.com/proj4js/proj4js#developing

=== 1.1.0 ===
The proj4js/build directory contains some scripts that can be use to build a single file (buildUncompressed.py) and compressed (build.py) versions of the Proj4js library.  The build process is controlled by the file library.cfg.  To build the library:
{{{
cd proj4js/build
./build.py
}}}

By default, all projection class code is included in the resulting file.  If only a subset of projections are required, then the library.cfg file can be edited to include or exclude the pieces required.  For example, if your application will only ever use EPSG:27563 and the LCC projection, library.cfg can be edited to be:
{{{
[first]
proj4js.js

[last]

[include]
projCode/lcc.js
defs/EPSG27563.js

[exclude]
defs/*
}}}

Similarly, OLprototype.cfg is the build configuration file used to create the OLprototype.js file with the OpenLayers build script.  In general, there will be no need to modify this file.

== The test suite ==

== Adding projection class code ==

== Datum Transforms ==