Several syntax fixes and additional documentation

Signed-off-by: Fabian Deutsch <fabiand@fedoraproject.org>

Change-Id: Ie4c566d7636f2ffa17c176557fe552aeb67df936
Signed-off-by: Fabian Deutsch <fabiand@fedoraproject.org>