a little more documentation

(still need to say something clever about the slurp multimethod)