Document and add tests for the new fancy_read features

git-svn-id: svn+ssh://rubyforge.org/var/svn/tioga/trunk/tioga@642 f6f669a6-2b79-499e-8f05-be2b991fc3d0