resolves #152 organizes basic API and CLI usage in manual

- moves information to includes
- creates API part in user manual
- expands usage quick start sections
- checks command line reference format
Merge pull request #153 from graphitefriction/api-cli-org

resolves #152 organizes basic API and CLI usage in manual