[Tile-serving] [osm2pgsql] Add Multi Backend Docs and Sample Configuration (#226)

[Kevin Kreiser]

This pr adds a bit of documentation on how to configure and use the multi pgsql backend. It adds some markdown in the docs section as well as a sample config/style file and a lua file for tag transformations.

In terms of code changes I added a bit to the output of the --help -v output to describe and note the multi backend exists. I also added a fix to the multi backend options usage for specifying the name of the tables. It seemed unintuitive to me that when you specify a name to the table it would still get the table prefix. If you want a prefix put it in the config for the table. It seems like the prefix is useful in the  normal pgsql backend where you dont have full control over the names of the tables and didn't apply to the multi backend.
You can merge this Pull Request by running:

  git pull https://github.com/kevinkreiser/osm2pgsql kk_docs

Or you can view, comment on it, or merge it online at:

  https://github.com/openstreetmap/osm2pgsql/pull/226

-- Commit Summary --

  * start with placeholder info for the multi backed
  * push in the indent of the sample json so as to make it look right in markdown
  * link to section of pgsql section for similar import section for muli backend
  * flesh out other single table options under multi
  * try linking without embedding html
  * add a mention of the mutli back end to the options for output. fix json formatting in the docs for example multi config
  * fix sample config in docs
  * add a sample multi backend confuration and sample lua script to use with it
  * fix expired tile generation, wasn't getting out of copy mode before trying to use the prepared statement get_wkt to delete ways found in a relation
  * Merge remote-tracking branch 'origin/master' into kk_docs
  * make multi backend use the provided table name verbatim. prefix doesnt make sense when you can name the thing directly
  * update building lua script to only care about buildings

-- File Changes --

    M README.md (4)
    A building.lua (124)
    A docs/multi.md (55)
    M options.cpp (6)
    M output-multi.cpp (10)
    A sample.multi.json (16)
    M tests/test-output-multi-line.cpp (39)
    M tests/test-output-multi-point-multi-table.cpp (10)
    M tests/test-output-multi-point.cpp (10)
    M tests/test-output-multi-polygon.cpp (40)

-- Patch Links --

https://github.com/openstreetmap/osm2pgsql/pull/226.patch
https://github.com/openstreetmap/osm2pgsql/pull/226.diff

---
Reply to this email directly or view it on GitHub:
https://github.com/openstreetmap/osm2pgsql/pull/226
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstreetmap.org/pipermail/tile-serving/attachments/20141205/ac30e42f/attachment.html>