Update the README

Update the readme to refer to 9.1+2.0 by default.
Information for older versions remains as an alternative.
Add example osm2pgsql usage

The example osm2pgsql usage is for a full planet and based on reasonable defaults for rendering osm-carto.

The example will periodically require updating to increase the RAM cache and quoted flat nodes size.

Also, be clearer about supporting PBF.
Merge pull request #40 from pnorman/example_docs

Update the README
Merge pull request #42 from pnorman/example_help

Add example osm2pgsql usage
Explain why fork() failed

In my experience, it's often because the cache size was set too high and fork()
can't allocate sufficient memory for the child. However, if nothing to this
effect is output, it's not clear what can be done.
Message cleanup
Merge pull request #47 from mojodna/fork-error-message

Explain why fork() failed
Remove old legacy osm2pgsql
Merge pull request #48 from pnorman/no_legacy

Remove old legacy osm2pgsql
Fixed up the integration test suit

This was mostly fixed by disabling the failing tests.

The tests worked by comparing the number of objects in the database between different options
There are a number of options however, that are known or supposed to produce different results.
Make sure that these are not compared between each other.

For now this mostly remains a crash test suit, as there are no known correct answers to test it against.

- Add some more parameters to check
- Verify the geometry by comparing the cumulative length and area.
Remove references to legacy/Makefile
Fix #ifdef HAVE_PTHREAD if pthread isn't defined
Merge pull request #54 from kanwei/master

Remove references to legacy/Makefile
Cleaned up lua script for tagtransform

Replaced lists of if-statements with tables over which to iterate

This was suggested in #53 by systemed
possix_fallocate does not set errno (fixes #55)

Also increase the initial writeout of flat-nodes to 2.6 Billion
nicer help message.
Merge pull request #57 from woodpeck/nicer_help_message_2

nicer help message.
Add a new regression test suite using integration tests

This regression test suite imports well defined osm test files
(currently a liechtenstein snapshot for general testing and
 a special crafted osm file with many different multi-polygon examples )
with various different parameters of osm2pgsql. It then runs various
different SQL queries against the resulting db to verify the results are
as expected.

Although the framework is in place, the number of tests are still rather limited
and need expanding to cover all of the interesting cases.
Allow phstore in style files even when --hstore is not specified

This allows a style file to be designed for both with and without hstore,
important for general-use style files.
test script: close DB connection on error in setup