tweaks to comments and example
reorganisation