Add per-command examples.
Explain <- and ->.
Merge pull request #5 from acquia/docs

API examples