= How to create a build =

[[TOC(inline)]]

== Checkout JOSM ==
=== Using Eclipse ===

 * [http://www.youtube.com/watch?v=Z3OjG3nDvzA How to checkout a JOSM plugin into Eclipse].

=== Using command line tools ===
{{{
 $ cd ~/src
 $ svn co http://josm.openstreetmap.de/svn josm
 ''tons of output here''
}}}

== Create a build == 
To create a build run 
{{{
ant clean
ant dist 
}}}

This will create {{{josm-custom.jar}}} in the directory {{{./dist}}}.

== The standard REVISION file == 
If you build JOSM with JOSMs {{{build.xml}}} the distribution includes a file {{{REVISION}}}. {{{REVISION}}} is a collection of name/value-pairs, formatted in RFC822-style (i.e. {{{name: value}}}).

||Revision||The JOSM version of your local snapshot. This is equal to the SVN revision of your local snapshot.||
||Build-Date||The date the distribution was created (YY-MM-DD HH:mm:ss)||
||Is-Local-Build||{{{true}}}. Indicates that this build isn't an "offical" release provided by josm.openstreetmap.de||

== Adding custom release information == 
If you maintain a specific JOSM distribution (i.e. for Ubuntu or any other Linux flavor) you may want to modify the {{{REVISION}}} file.

Update the ant target {{{create-revision}}} in {{{build.xml}}} for your needs:
{{{
<echo file="${build.dir}/REVISION">
# automatically generated by JOSM build.xml - do not edit 			
Revision: ${version.entry.commit.revision}
Is-Local-Build: true
Build-Date: ${build.tstamp}		
</echo>		
}}}

Please '''always''' include an attribute {{{Revision}}}. Otherwise, JOSM may fail to detect dependencies to particular versions of plugins.