this is a meta ticket covering many issues, taken out of #590.

• straightforward ipfs -h
• comprehensive ipfs --help -- in progress
• command reference in website -- sort of there: http://ipfs.io/docs/commands
• api reference in website -- not yet there: http://ipfs.io/docs/api
• examples -- started: http://ipfs.io/docs/examples <-- want a hundred!
• man pages generated from the ipfs --help output eventually (man pages #275)

The website can be edited here: https://github.com/protocol/websites/tree/master/ipn.io/src/ipfs.io