tidy function definitions
more examples
update README
we don't want to change the RNG status; test will be done in C++
NEWS update
prepare for new release