README 
======

This is a plugin for extracting shapes from PDF files.
Generally useful if you have a map in PDF file and want to automate data extraction.
This plugin is available under the GPL licence (version 2.0 or later).
Uses PDFBox library to parse PDF files, see https://pdfbox.apache.org for more info.


Layout
======
+- src                                source of the plugin
+- images                             images the plugin needs
+- resources                          resources the plugin needs
+- libs								  libraries the plugin needs (pdfbox ...)

  README                                this file

  license                               GPL version 3 license text
  build.xml                             deployment build file

  
Build
=====  
A JOSM plugin is built as a single jar. We use ant to build.

See build.xml in this directory and update the plugin specific properties in the
configuration section.
  

Maintaining versions
====================
There are two versions maintained with each plugin:
   1) the main version
      This is the lowest JOSM version required by this plugin.
      You have to manually set the plugins main version in the build script.
      Set the property plugin.main.version in build.xml accordingly. 

   2) the build version
      The build version is unique for every build of the plugin. It is equal
      to the SVN revision of your plugin directory. 

 Both the main version and the build version are included in properties of the plugins
 manifest:
    Plugin-Version      the build version
    Plugin-Mainversion  the main version

 JOSM automatically detects whether a plugin needs to be upgraded. It compares the build
 version of the currently installed plugin jar with the build version of the plugin jar in 
 the SVN. The main version is irrelevant for this process.  
 
 Making your plugin available to JOSM users
 ===========================================
 When a plugin jar is checked into SVN a script updates the plugins list on the JOSM wiki:
   https://josm.openstreetmap.de/wiki/Plugins
 JOSM retrieves the list of available plugins and their build versions from this list.

            commit      publish               read
                       meta data              meta data 
      Build  ==>  SVN  =======>  JOSM Wiki   <======= JOSM 
                   ^ 
                   ==================================
                            fetch current plugin jar 
 
 Note that you have to manually publish (commit) your plugin jar. There is no nightly build
 in place. Everything else (pulishing meta data, updating plugins in the client) is then handled 
 by automatic processes. 

Hints for eclipse
=================
. Building:
  . add to buildpath|libraries: josm-custom.jar, fontbox-...jar, jempbox...jar, pdfbox...jar
  . build with ant, if any resources have changed (at least after svn update); eclipse cant handle build of resources, etc
. Run / Debug
  . main class: org.openstreetmap.josm.gui.MainApplication (found in josm-custom.jar)

See also
========
* Developing Plugins 
  https://josm.openstreetmap.de/wiki/DevelopersGuide/DevelopingPlugins
  
* List of JOSM Plugins
  https://josm.openstreetmap.de/wiki/Plugins