Documentation corrections

Corrected some spelling errors and added / correceted some references
Handlingh of -- by \c and <code> results in - adjusted documentation

Adjusted documentation so that -- in \c and <code> are shown as -- by placing the parts in ` (backtick)
Merge pull request #89 from albert-github/feature/docu_update

Documentation corrections