Properly handle embedded doc comments (=begin/=end)
Properly handle embedded doc comments (=begin/=end)

Fixes #577
Closes #578

lsegal/yard,alexdowad/yard,lsegal/yard,jreinert/yard,jreinert/yard,amclain/yard,herosky/yard,thomthom/yard,thomthom/yard,herosky/yard,ohai/yard,ohai/yard,alexdowad/yard,thomthom/yard,amclain/yard,alexdowad/yard,herosky/yard,iankronquist/yard,amclain/yard,iankronquist/yard,iankronquist/yard,lsegal/yard,ohai/yard,jreinert/yard