added additional doc; changed message to be clearer