some final touches, doc updated