issue #19 more documentation...