Rewrite the main README file
Configure uzbl-browser for PREFIX
Add a target for uzbl.desktop
Quote variable expansion in uzbl-browser
Move '!' outside the test block
Simplify uzbl-browser logic
Document the dir1:dir2:dir3:subpath behavior
Embed uzbl subdir in the XDG _home variables
Remove unimplemented event
Remove uzbl-browser when cleaning
Update docs for latest changes
Update scheme_handler documentation
Document permission_handler
Update docs for link following configuration

Reported-By: Ruthard Baudach <ruthard.baudach@web.de>
Improve cookie documentation examples
Update request_handler documentation
Support request_handler in WebKit1

The WebKit1 API is synchronous, so it must be done in the signal
handler.
Merge branch 'dev/update-docs' into mathstuf/next

* dev/update-docs:
  Update request_handler documentation
  Improve cookie documentation examples
  Update docs for link following configuration
  Document permission_handler
  Update scheme_handler documentation
  Update docs for latest changes
  Remove uzbl-browser when cleaning
  Remove unimplemented event
  Embed uzbl subdir in the XDG _home variables
  Document the dir1:dir2:dir3:subpath behavior
  Simplify uzbl-browser logic
  Move '!' outside the test block
  Quote variable expansion in uzbl-browser
  Add a target for uzbl.desktop
  Configure uzbl-browser for PREFIX
  Rewrite the main README file
Install the proper README files

Also replace @PREFIX@ with the actual prefix.
Use XDG_RUNTIME_DIR if available