Tidy doco and add additional example and TODO (#occurrences as return?)