some more haddock (see #86)