SQUASH: doc clarifications