update the /documentation, and the synopsis