leaflet-js 0.6.beta4

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NDc5OWQ2N2Q2OWIxNDE2YWI0YzA3ZjQzMDE3MzE0ZjkyZWY3YjVlYg==
+  data.tar.gz: !binary |-
+    YWJmZGZkOGRhMTAyYTYxMjQyYmM3ZjE1ODVhYzAwNzYwZmUwYWYyOQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    MWZkY2UyYzJkNWJkNDFlOWNiZDE0MWFiYTliNDM2NzA0NmY0ZTUwNDRlNjJh
+    MGZlOTgyNjQyNTcwMDA0MTQwNTJhMDQyNGZiNWJkZWRkNjJiYjI5ZjQzYTVi
+    ZDEwMWExODYxYTIxNzBiODNjYTRjZDRhODc5ZDUwNTgwY2FlOTQ=
+  data.tar.gz: !binary |-
+    ZDI0OTgwOGIwOGY1ZTc4MTFlYjZkZmQ4MTQ4ZmRiM2E1ZGQ4NWUzZGFiMDYx
+    NjNhYTA1YzI1NDdjOWNkMzk3ZGI5NTNlMTgwODFhZjdhZDdjNzVjYTNiMGNk
+    MWU5ZWY4MmNkNzk3ZjczNTc0ZDg0ZTAyMzA3YjgzZWJmNjQ4MmY=

data/CHANGELOG.rdoc

@@ -0,0 +1,32 @@
+= leaflet-js Changelog
+
+=== 0.6.beta4 (May 2, 2013)
+* Unix is case senstive!
+
+=== 0.6.beta2 (April 30, 2013)
+* Update to latest version of leaflet (0.6 master)
+* Add in leaflet label
+* Add in leaflet draw
+
+=== 0.6.beta1 (April 30, 2013)
+* Update to latest version of leaflet (0.6 master)
+* Add in leaflet label
+* Add in leaflet draw
+
+=== 0.4.beta1 (May 6, 2012)
+* Update to latest version of leaflet (0.4 master)
+
+=== 0.3.beta4 (February 3, 2012)
+* Copy images to vendor/assets/images so they are precompiled correctly.
+* Copy stylesheets to vendor/assets/stylesheets and then update.
+* Modify stylesheets to use asset_path for background images so that 
+  precompiling works correctly.
+
+=== 0.3.beta3 (January 17, 2012)
+* Remove zerista_layer.js to remove depedency on jQuery.
+
+=== 0.3.beta2 (January 17, 2012)
+* Withdrawn
+
+=== 0.3.beta1 (January 16, 2012)
+* First release, wraps the current master version of Leaflet 0.3 which is not yet released.

data/LICENSE

@@ -0,0 +1,21 @@
+  Copyright (c) 2008-2011 Charlie Savage and contributors
+  Copyright (c) 2002-2007 Sean Chittenden and contributors
+  Copyright (c) 2001 Wai-Sun "Squidster" Chia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in 
+the Software without restriction, including without limitation the rights to 
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies 
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.rdoc

@@ -0,0 +1,54 @@
+= Leaflet JS Rails
+
+== Overview
+leaflet-js wraps the Leaflet Javascript library in an asset gem so it can
+easily be used with Rails.  It also includes the Leaflet.Label and Leaflet.Draw
+plusins.  For more information about the Leaflet library, please visit http://leafletjs.com.
+
+== Installation
+
+In your Gemfile, add this line:
+
+gem "leaflet-js"
+
+Then, run bundle install. You're done!
+
+== Usage
+
+Leaflet provides javascript, css and image assets.  To use these assets in your project, either 
+require the files below from your erb files or add them to your top level application.js and css files.
+
+Leaflet provides the following assets:
+
+=== Javascripts
+
+leaflet.js
+leaflet.draw.js
+leaflet.label.js
+
+=== Stylesheets
+
+leaflet.css
+leaflet.ie.css
+leaflet.draw.css
+leaflet.draw.ie.css
+leaflet.label.css
+
+=== Images
+
+layers.png
+marker-icon.png
+marker-icon@2x.png
+market-shadow.png
+spritesheet.png
+
+== Support
+
+If you have any questions about leaflet, please refer them to the Leaflet maintainers at
+http://leafletjs.com.  If you have any questions about how leaflet-js wraps
+leaflet, then please refer to https://github.com/cfis/leaflet-js.
+
+== License
+
+See LICENSE for license information about leaflet-js.  Please note that the Leaflet project
+has its own LICENSE file also.

data/Rakefile

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+require "rubygems"
+require "rubygems/package_task"
+
+GEM_NAME = "leaflet-js"
+
+# Read the spec file
+spec = Gem::Specification.load("#{GEM_NAME}.gemspec")
+
+# Setup generic gem
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.package_dir = 'pkg'
+  pkg.need_tar    = false
+end

data/leaflet-js.gemspec

@@ -0,0 +1,28 @@
+# encoding: utf-8
+Gem::Specification.new do |spec|
+  spec.name        = 'leaflet-js'
+  spec.version     = '0.6.beta4'
+  spec.homepage    = 'https://github.com/cfis/leaflet-js'
+  spec.summary     = <<-EOS
+Wraps the Leaflet Javascript Mapping Library in a Rails asset gem. Also include Leaflet.Label
+and Leaflet.Draw plusins.  For more information
+about Leaflet please see http://leafletjs.com/
+EOS
+
+  spec.authors = ['Charlie Savage']
+  spec.platform = Gem::Platform::RUBY
+  spec.files = Dir.glob(['leaflet-js.gemspec',
+                         'CHANGELOG.rdoc',
+                         'LICENSE',
+                         'Rakefile',
+                         'README.rdoc',
+                         'lib/leaflet-js.rb',
+                         'lib/leaflet/**/*',
+                         'lib/leaflet.draw/**/*',
+                         'lib/leaflet.label/**/*',
+                         'vendor/assets/images/*',
+                         'vendor/assets/stylesheets/*',
+                         'vendor/assets/javascripts/*'])
+  spec.required_ruby_version = '>= 1.9.3'
+  spec.date = Time.now
+end

data/lib/leaflet-js.rb

@@ -0,0 +1,10 @@
+module Leaflet
+  class Engine < Rails::Engine
+    initializer :append_assets_path do |app|
+      # Javascripts
+      app.config.assets.paths << File.join(config.root, 'lib', 'leaflet', 'src')
+      app.config.assets.paths << File.join(config.root, 'lib', 'leaflet.draw', 'src')
+      app.config.assets.paths << File.join(config.root, 'lib', 'leaflet.label', 'src')
+    end
+  end
+end

data/lib/leaflet.draw/BREAKINGCHANGES.md

@@ -0,0 +1,54 @@
+# How to upgrade from 0.1 to 0.2
+
+There are a number of changes to the plugin in 0.2 that may break peoples implementations of Leaflet.draw 0.1. If you  I will try my best to list any changes here.
+
+## Event consolidation
+
+Leaflet.draw 0.1 had a created event for each different shape that was created. 0.2 now consolitates these into a single created shape.
+
+The vector or marker is accessed by the `layer` property of the event arguments, the type of layer by the `layerType`.
+
+#### New way
+
+````js
+map.on('draw:created', function (e) {
+	var type = e.layerType,
+		layer = e.layer;
+
+	if (type === 'marker') {
+		// Do any marker specific logic here
+	}
+
+	map.addLayer(layer);
+});
+````
+
+#### Old way
+
+````js
+map.on('draw:poly-created', function (e) {
+	map.addLayer(e.poly);
+});
+map.on('draw:rectangle-created', function (e) {
+	map.addLayer(e.rect);
+});
+map.on('draw:circle-created', function (e) {
+	map.addLayer(e.circ);
+});
+map.on('draw:marker-created', function (e) {
+	e.marker.bindPopup('A popup!');
+	map.addLayer(e.marker);
+});
+````
+
+## Draw handler started/stopped event change
+
+Renamed the drawing started and stopped events to be the same as the created standard.
+
+`drawing` -> `draw:drawstart` and `drawing-disabled` -> `draw:drawstop`.
+
+The event argument has also changed from `drawingType` -> `layerType`.
+
+## CSS changes
+
+There has been a whole bunch of CSS changes, if you have customized any of these plese see [leaflet.draw.css](https://github.com/Leaflet/Leaflet.draw/blob/master/dist/leaflet.draw.css).

data/lib/leaflet.draw/CHANGELOG.md

@@ -0,0 +1,73 @@
+Leaflet.draw Changelog
+======================
+
+## master
+
+An in-progress version being developed on the master branch.
+
+### Improvements
+
+ * `draw:edited` now returns a `FeatureGroup` of features edited. (by [@jmkelly](https://github.com/jmkelly)). [#95](https://github.com/Leaflet/Leaflet.draw/pull/95)
+ * Circle tooltip shows the radius (in m) while drawing.
+ * Added Leaflet version check to inform developers that Leaflet 0.6+ is required.
+ * Added ability to finish drawing polygons by double clicking. (inspired by [@snkashis](https://github.com/snkashis)). [#121](https://github.com/Leaflet/Leaflet.label/pull/121)
+ * Added test environment. (by [@iirvine](https://github.com/iirvine)). [#123](https://github.com/Leaflet/Leaflet.draw/pull/123)
+
+### Bugfixes
+
+ * Fixed issue where removing a vertex or adding a new one via midpoints would not update the edited state for polylines and polygons.
+ * Fixed issue where not passing in the context to `off()` would result in the event from not being unbound.(by [@koppelbakje](https://github.com/koppelbakje)). [#95](https://github.com/Leaflet/Leaflet.draw/pull/112)
+ * Fixed issue where removing the draw control from the map would result in an error.
+ * Fixed bug where removing points created by dragging midpoints would cause the polyline to not reflect any newly created points.
+
+## 0.2.0 (February 20, 2013)
+
+Major new version. Added Edit toolbar which allows editing and deleting shapes.
+
+### Features
+
+ * Consistant event for shape creation. (by [@krikrou](https://github.com/krikrou)). [#58](https://github.com/Leaflet/Leaflet.draw/pull/58)
+
+### Bugfixes
+
+ * Fixed adding markers over vector layers. (by [@Starefossen](https://github.com/Starefossen)). [#82](https://github.com/Leaflet/Leaflet.draw/pull/82)
+
+## 0.1.7 (February 11, 2013)
+
+ * Add sanity check for toolbar buttons when adding top and bottom classes. (by [@yohanboniface](https://github.com/yohanboniface)). [#60](https://github.com/Leaflet/Leaflet.draw/pull/60)
+
+## 0.1.6 (January 17, 2013)
+
+* Updated toolbar styles to be in line with the new Leaflet zoom in/out styles.
+
+## 0.1.5 (December 10, 2012)
+
+### Features
+
+ * Added 'drawing-disabled' event fired on the map when a draw handler is disabled. (by [@ajbeaven](https://github.com/thegreat)). [#35](https://github.com/jacobtoye/Leaflet.draw/pull/35)
+ * Added 'drawing' event fired on the map when a draw handler is actived. (by [@ajbeaven](https://github.com/thegreat)). [#30](https://github.com/jacobtoye/Leaflet.draw/pull/30)
+
+### Bugfixes
+ 
+ * Stopped L.Control.Draw from storing handlers in it's prototype. (by [@thegreat](https://github.com/thegreat)). [#37](https://github.com/jacobtoye/Leaflet.draw/pull/37)
+
+## 0.1.4 (October 8, 2012)
+
+### Bugfixes
+
+ * Fixed a bug that would cause an error when creating rectangles/circles withought moving the mouse. (by [@inpursuit](https://github.com/inpursuit)). [#25](https://github.com/jacobtoye/Leaflet.draw/pull/25)
+ * Fixed a bug that would cause an error when clicking a different drawing tool while another mode enabled. (by [@thegreat](https://github.com/thegreat)). [#27](https://github.com/jacobtoye/Leaflet.draw/pull/27)
+ * Fixed control buttons breaking plugin in oldIE.
+ * Fixed drawing polylines and polygons in oldIE.
+
+## 0.1.3 (October 3, 2012)
+
+### Bugfixes
+
+ * Tip label will now show over vertex markers.
+ * Added ability to draw on top of existing markers and vector layers.
+ * Clicking on a map object that has a click handler no longer triggers the click event when in drawing mode.
+
+## Pre-0.1.3
+
+Check the commit history for changes previous to 0.1.3.

data/lib/leaflet.draw/Jakefile.js

@@ -0,0 +1,26 @@
+/*
+Leaflet.draw building and linting scripts.
+
+To use, install Node, then run the following commands in the project root:
+
+    npm install -g jake
+    npm install uglify-js
+    npm install jshint
+
+To check the code and build Leaflet from source, run "jake"
+
+For a custom build, open build/build.html in the browser and follow the instructions.
+*/
+
+var build = require('./build/build.js');
+
+desc('Check Leaflet.Draw source for errors with JSHint');
+task('lint', build.lint);
+
+desc('Combine and compress Leaflet.Draw source files');
+task('build', ['lint'], build.build);
+
+desc('Run PhantomJS tests');
+task('test', ['lint'], build.test);
+
+task('default', ['build']);

data/lib/leaflet.draw/MIT-LICENCE.txt

@@ -0,0 +1,20 @@
+Copyright 2012 Jacob Toye
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/leaflet.draw/README.md

@@ -0,0 +1,364 @@
+# Important
+You will need to download the latest Leaflet from master in the [Github repo](https://github.com/Leaflet/Leaflet) before Leaflet.draw 0.2.0 will work.
+
+#Leaflet.draw
+Adds support for drawing and editing vectors and markers on [Leaflet maps](https://github.com/Leaflet/Leaflet). Check out the [demo](http://leaflet.github.com/Leaflet.draw/)
+
+#### Upgrading from Leaflet.draw 0.1
+
+Leaflet.draw 0.2.0 changes a LOT of things from 0.1. Please see [BREAKING CHANGES](https://github.com/Leaflet/Leaflet.draw/blob/master/BREAKINGCHANGES.md) for how to upgrade.
+
+## Table of Contents
+[Using the plugin](#using)  
+[Advanced Options](#options)  
+[Command tasks](#tasks)  
+[Thanks](#thanks)  
+
+<a name="using" />
+## Using the plugin
+
+The default state for the control is the draw toolbar just below the zoom control. This will allow map users to draw vectors and markers. **Please note the edit toolbar is not enabled by default.**
+
+Too add the draw toolbar set the option `drawControl: true` in the map options.
+
+````js
+// create a map in the "map" div, set the view to a given place and zoom
+var map = L.map('map', {drawControl: true}).setView([51.505, -0.09], 13);
+
+// add an OpenStreetMap tile layer
+L.tileLayer('http://{s}.tile.osm.org/{z}/{x}/{y}.png', {
+    attribution: '&copy; <a href="http://osm.org/copyright">OpenStreetMap</a> contributors'
+}).addTo(map);
+````
+
+### Adding the edit toolbar
+
+To use the edit toolbar you must initialise the Leaflet.draw control and manually add it to the map.
+
+````js
+// create a map in the "map" div, set the view to a given place and zoom
+var map = L.map('map').setView([51.505, -0.09], 13);
+
+// add an OpenStreetMap tile layer
+L.tileLayer('http://{s}.tile.osm.org/{z}/{x}/{y}.png', {
+    attribution: '&copy; <a href="http://osm.org/copyright">OpenStreetMap</a> contributors'
+}).addTo(map);
+
+// Initialize the FeatureGroup to store editable layers
+var drawnItems = new L.FeatureGroup();
+map.addLayer(drawnItems);
+
+// Initialize the draw control and pass it the FeatureGroup of editable layers
+var drawControl = new L.Control.Draw({
+	edit: {
+		featureGroup: drawnItems
+	}
+});
+map.addControl(drawControl);
+````
+
+The key here is the `featureGroup` option. This tells the plugin which `FeatureGroup` that contains the layers that should be editable.
+
+### Events
+
+Once you have successfully added the Leaflet.draw plugin your map you will want to respond to the different actions users can do. The following events will be triggered on the map:
+
+#### draw:created
+
+| Property | Type | Description
+| --- | --- | ---
+| layer | [Polyline](http://leafletjs.com/reference.html#polyline)/[Polygon](http://leafletjs.com/reference.html#polygon)/[Rectangle](http://leafletjs.com/reference.html#rectangle)/[Circle](http://leafletjs.com/reference.html#circle)/[Marker](http://leafletjs.com/reference.html#marker) | Layer that was just created.
+| layerType | String | The type of layer this is. One of: `polyline`, `polygon`, `rectangle`, `circle`, `marker`
+
+
+Triggered when a new vector or marker has been created.
+
+````js
+map.on('draw:created', function (e) {
+	var type = e.layerType,
+		layer = e.layer;
+
+	if (type === 'marker') {
+		// Do marker specific actions
+	}
+
+	// Do whatever else you need to. (save to db, add to map etc)
+	map.addLayer(layer);
+});
+````
+
+#### draw:edited
+
+| Property | Type | Description
+| --- | --- | ---
+| layers | [LayerGroup](http://leafletjs.com/reference.html#layergroup) | List of all layers just edited on the map.
+
+Triggered when layers in the FeatureGroup, that the plugin was initialized with, have been edited and saved.
+
+````js
+map.on('draw:edited', function (e) {
+	var layers = e.layers;
+	layers.eachLayer(function (layer) {
+		//do whatever you want, most likely save back to db
+	});
+});
+````
+
+#### draw:deleted
+
+Triggered when layers have been layers have been removed (and saved) from the FeatureGroup.
+
+| Property | Type | Description
+| --- | --- | ---
+| layers | [LayerGroup](http://leafletjs.com/reference.html#layergroup) | List of all layers just removed from the map.
+
+#### draw:drawstart
+
+Triggered when the user has chosen to draw a particular vector or marker.
+
+| Property | Type | Description
+| --- | --- | ---
+| layerType | String | The type of layer this is. One of: `polyline`, `polygon`, `rectangle`, `circle`, `marker`
+
+#### draw:drawstop
+
+Triggered when the user has finshed a particular vector or marker.
+
+| Property | Type | Description
+| --- | --- | ---
+| layerType | String | The type of layer this is. One of: `polyline`, `polygon`, `rectangle`, `circle`, `marker`
+
+<a name="options" />
+## Advanced options
+
+You can configure the plugin by using the different options listed here.
+
+### Control.Draw
+
+These options make up the root object that is used when initializing the Leaflet.draw control.
+
+| Option | Type | Default | Description
+| --- | --- | --- | ---
+| position | String | `'topleft'` | The initial position of the control (one of the map corners). See [control positions](http://leafletjs.com/reference.html#control-positions).
+| draw | [DrawOptions](#drawoptions) | `{}` | The options used to configure the draw toolbar.
+| edit | [EditOptions](#editoptions) | `false` | The options used to configure the edit toolbar.
+
+<a name="drawoptions" />
+### DrawOptions
+
+These options will allow you to configure the draw toolbar and it's handlers.
+
+| Option | Type | Default | Description
+| --- | --- | --- | ---
+| polyline | [PolylineOptions](#polylineoptions) | `{ title: 'Draw a polyline' }` | Polyline draw handler options.
+| polygon | [PolygonOptions](#polygonoptions) | `{ title: 'Draw a polygon' }` | Polygon draw handler options.
+| rectangle | [RectangleOptions](#rectangleoptions) | `{ title: 'Draw a rectangle' }` | Rectangle draw handler options.
+| circle | [CircleOptions](#circleoptions) | `{ title: 'Draw a circle' }` | Circle draw handler options.
+| marker | [MarkerOptions](#markeroptions) | `{ title: 'Add a marker' }` | Marker draw handler options.
+
+### Draw handler options
+
+The following options will allow you to configure the individual draw handlers.
+
+<a name="polylineoptions" />
+<a name="polygonoptions" />
+#### PolylineOptions and PolygonOptions
+
+Polyline and Polygon drawing handlers take the same options.
+
+| Option | Type | Default | Description
+| --- | --- | --- | ---
+| title | String | `'Draw a Polyline (Polygon)'` | The title used for the polyline/polygon button.
+| allowIntersection | Bool | `true` | Determines if line segements can cross.
+| drawError | Object | [See code](https://github.com/Leaflet/Leaflet.draw/blob/master/src/draw/handler/Draw.Polyline.js#L10) | Configuration options for the error that displays if an intersection is detected.
+| guidelineDistance | Number | `20` | Distance in pixels between each guide dash.
+| shapeOptions | [Leaflet Polyline options](http://leafletjs.com/reference.html#polyline-options) | [See code](https://github.com/Leaflet/Leaflet.draw/blob/master/src/draw/handler/Draw.Polyline.js#L20) | The options used when drawing the polyline/polygon on the map.
+| zIndexOffset | Number | `2000` | This should be a high number to ensure that you can draw over all other layers on the map.
+
+<a name="rectangleoptions" />
+#### RectangleOptions
+
+| Option | Type | Default | Description
+| --- | --- | --- | ---
+| title | String | `'Draw a rectangle.'` | The title used for the rectangle button.
+| shapeOptions | [Leaflet Path options](http://leafletjs.com/reference.html#path-options) | [See code](https://github.com/Leaflet/Leaflet.draw/blob/master/src/draw/handler/Draw.Rectangle.js#L7) | The options used when drawing the rectangle on the map.
+
+<a name="circleoptions" />
+#### CircleOptions
+
+| Option | Type | Default | Description
+| --- | --- | --- | ---
+| title | String | `'Draw a circle.'` | The title used for the circle button.
+| shapeOptions | [Leaflet Path options](http://leafletjs.com/reference.html#path-options) | [See code](https://github.com/Leaflet/Leaflet.draw/blob/master/src/draw/handler/Draw.Circle.js#L7) | The options used when drawing the circle on the map. 
+
+<a name="markeroptions" />
+#### MarkerOptions
+
+| Option | Type | Default | Description
+| --- | --- | --- | ---
+| title | String | `'Add a marker.'` | The title used for the marker button.
+| icon | [Leaflet Icon](http://leafletjs.com/reference.html#icon) | `L.Icon.Default()` | The icon displayed when drawing a marker.
+| zIndexOffset | Number | `2000` | This should be a high number to ensure that you can draw over all other layers on the map.
+
+<a name="editoptions" />
+### EditOptions
+
+These options will allow you to configure the draw toolbar and its handlers.
+
+| Option | Type | Default | Description
+| --- | --- | --- | ---
+| featureGroup | [Leaflet FeatureGroup](http://leafletjs.com/reference.html#featuregroup) | `null` | This is the FeatureGroup that stores all editable shapes. **THIS iS REQUIRED FOR THE EDIT TOOLBAR TO WORK**
+| edit | [EditHandlerOptions](#edithandleroptions) | `{ title: 'Edit layers' }` | Edit handler options.
+| remove | [DeleteHandlerOptions](#deletehandleroptions) | `{ title: 'Delete layers' }` | Delete handler options.
+
+<a name="edithandleroptions" />
+#### EditHandlerOptions
+
+| Option | Type | Default | Description
+| --- | --- | --- | ---
+| title | String | `'Edit Layers'` | The title used for the edit button.
+| selectedPathOptions | [Leaflet Path options](http://leafletjs.com/reference.html#path-options) | [See code](https://github.com/Leaflet/Leaflet.draw/blob/master/src/edit/handler/EditToolbar.Edit.js#L9) | The path options for how the layers will look like while in edit mode.
+
+<a name="deletehandleroptions" />
+#### DeleteHandlerOptions
+
+| Option | Type | Default | Description
+| --- | --- | --- | ---
+| title | String | `'Remove Layers'` | The title used for the delete button.
+
+<a name="commontasks" />
+## Common tasks
+
+The following examples outline some common tasks.
+
+### Example Leaflet.draw config
+
+The following example will show you how to:
+
+1. Change the position of the control's toolbar.
+2. Customize the styles of a vector layer.
+3. Use a custom marker.
+4. Disable the delete functionality.
+
+````js
+var cloudmadeUrl = 'http://{s}.tile.cloudmade.com/BC9A493B41014CAABB98F0471D759707/997/256/{z}/{x}/{y}.png',
+	cloudmade = new L.TileLayer(cloudmadeUrl, {maxZoom: 18}),
+	map = new L.Map('map', {layers: [cloudmade], center: new L.LatLng(-37.7772, 175.2756), zoom: 15 });
+
+var editableLayers = new L.FeatureGroup();
+map.addLayer(editableLayers);
+
+var MyCustomMarker = L.Icon.extend({
+	options: {
+		shadowUrl: null,
+		iconAnchor: new L.Point(12, 12),
+		iconSize: new L.Point(24, 24),
+		iconUrl: 'link/to/image.png'
+	}
+});
+
+var options = {
+	position: 'topright',
+	draw: {
+		polyline: {
+			title: 'Draw a kick ass polyline!'
+			shapeOptions: {
+				color: '#f357a1',
+				weight: 10
+			}
+		},
+		polygon: {
+			allowIntersection: false, // Restricts shapes to simple polygons
+			drawError: {
+				color: '#e1e100, // Color the shape will turn when intersects
+				message: '<strong>Oh snap!<strong> you can\'t draw that!' // Message that will show when intersect
+			},
+			shapeOptions: {
+				color: '#bada55'
+			}
+		},
+		circle: false, // Turns off this drawing tool
+		rectangle: {
+			shapeOptions: {
+				clickable: false
+			}
+		},
+		marker: {
+			icon: new MyCustomMarker()
+		}
+	},
+	edit: {
+		featureGroup: editableLayers, //REQUIRED!!
+		remove: false
+	}
+};
+
+var drawControl = new L.Control.Draw(options);
+map.addControl(drawControl);
+
+map.on('draw:created', function (e) {
+	var type = e.layerType,
+		layer = e.layer;
+
+	if (type === 'marker') {
+		layer.bindPopup('A popup!');
+	}
+
+	drawnItems.addLayer(layer);
+});
+````
+
+### Disabling a toolbar
+
+If you do not want a particular toolbar in your app you can turn it off by setting the toolbar to false.
+
+````js
+var drawControl = new L.Control.Draw({
+	draw: false,
+	edit: {
+		featureGroup: editableLayers
+	}
+});
+````
+
+### Disabling a toolbar item
+
+If you want to turn off a particular toolbar item, set it to false. The following disables drawing polygons and markers. It also turns off the ability to edit layers.
+
+````js
+var drawControl = new L.Control.Draw({
+	draw: {
+		polygon: false,
+		marker: false
+	},
+	edit: {
+		featureGroup: editableLayers,
+		edit: false
+	}
+});
+````
+
+### Changing a drawing handlers options
+
+You can change a draw handlers options after initialization by using the `setDrawingOptions` method on the Leaflet.draw control.
+
+E.g. to change the colour of the rectangle:
+
+````js
+drawControl.setDrawingOptions(
+    rectangle: {
+        color: '#0000FF'
+    }
+);
+````
+
+<a name="thanks" />
+## Thanks
+
+Thanks so much to [@brunob](https://github.com/brunob), [@tnightingale](https://github.com/tnightingale), and [@shramov](https://github.com/shramov). I got a lot of ideas from their Leaflet plugins.
+
+All the [contributors](https://github.com/Leaflet/Leaflet.draw/graphs/contributors) and issue reporters of this plugin rock. Thanks for tidying up my mess and keeping the plugin on track.
+
+The icons used for some of the toolbar buttons are either from http://glyphicons.com/ or inspired by them. <3 Glyphicons!
+
+Finally, [@mourner](https://github.com/mourner) is the man! Thanks for dedicating so much of your time to create the gosh darn best JavaScript mapping library around.