fix english and typos, rewrite a few formulations; reformat examples
Merge branch 'master' of git.nic.cz:ogra
Examples in documentation added as a local files.
Typo and style corrections.