Extended documentation, some polishing of the code...

Signed-off-by: Ory Chowaw-Liebman <ory.chowaw-liebman@gmx.de>