several documentation and regression fixes