fixed some defects
doc updates