fixes from second doc