allow multiple params in inspect
add [] and move errors to stderr
docs: warn about build data tx & ADD w/o context

This updates the documentation to mention that:
1. a lot of data may get sent to the docker daemon if there is a lot of
data in the directory passed to docker build
2. ADD doesn't work in the absence of the context
3. running without a context doesn't send file data to the docker
daemon
4. explain that the data sent to the docker daemon will be used by ADD
commands
docs: build: ADD copies just needed data w/ full path
Remove CR/NL from description in docker CLI. Also moved description shortening to the client
seperated the registry and index API's into their own docs

seperated the registry and index API's into their own docs and merged
in the index search api into the index api. Also renamed the original
registry api to registry_index_spec.
build: don't ignore last line in Dockerfile when it doesn't end with \n
More principles. Raw and unstructured to spawn discussion.
Merge branch 'master' of ssh://github.com/dotcloud/docker
Added a readme explaining the role of each API
Merge branch 'master' of ssh://github.com/dotcloud/docker
Merge pull request #853 from kencochrane/registry-api-1.1-fix

* Documentation: separate the registry and index API's into their own docs
commands: use in instead of os.Stdin in hijack
Merge pull request #877 from fsouza/fix-hijack

- Runtime: use in instead of os.Stdin in hijack
Merge pull request #874 from fsouza/fix-build-newline

- Builder: don't ignore last line in Dockerfile when it doesn't end with \n
Merge pull request #852 from dotcloud/556-docker-search-fmt

Remove CR/NL from description in docker CLI
Merge pull request #844 from dotcloud/843-inspect_multiple_params-feature

* Runtime: allow multiple params in inspect
Merge branch 'master' of ssh://github.com/dotcloud/docker
New roadmap item: advanced port redirections
Merge pull request #845 from unclejack/841-update_docs_no_add_without_context

841 - docs: warn about the transmission of data to the docker daemon & ADD without context