expand doc; fixed errors.