adapted doc to source code
some fixes and additional commentry to update procedure