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