Alpstein/route-me — pull request #105 by incanus (2012-08-30 01:47:42+00:00)
Title: fixes #104: MapBox improvements

Here are the promised improvements. Separating them out proved to be really complicated due to required order of patching, so I quit after about 10 branches :-)

Some notes. Feel free to ask me about anything and we can discuss here.

* Documentation compatible with [appledoc](http://gentlebytes.com/appledoc/) has been added to about 95% of the public API. You can check out [this script](https://github.com/mapbox/mapbox-ios-sdk/blob/gh-pages/docs.sh) for what I use to generate our docset from it. This ignores implementation files, a bunch of classes with largely C structs (since those aren't supported yet), private API, and some of the basic alternative tile sources. These docs make up most of the diff that you'll see, so it should be pretty easy to scan.

* The overlay view now its own hit testing internally to account for user location annotations -- both allowing interacting with the dot, but not receiving touches on the accessory stuff like the halo and the tracking heading. These also lays some groundwork for, in the future, allowing an option for hits on polygons, say.

* I didn't include the performance stuff in this commit. It's pretty small code-wise and we can tackle that in the future. I've adjusted your version of the docs for `missingTilesDepth` as a result (i.e., still defaults to 0).

* I only really had to adjust the `tileCache` property of `RMMapView` as far as method/property reordering was concerned. Things worked logically otherwise. I did add some line spacing.