well documented

finaly the full docummented source