add compare; doc updates