yet more additions to the documenation