Update the man page for osm2pgsql

also move it out of the debian directory and into a new docs directory
Update the README a bit
Add a few more authors to the AUTHORS file who seem to have done a lot of commits

This is not an exhaustive list of authors of osm2pgsql and can be added to at any time
if any (important) authors were missed who want to be named.