vectorised numbers, and improved docs.