class Bake::Documentation

def description

@returns [Enumerable] If no block given.
@parameter match [MatchData] The regular expression match for each line of documentation.
@yields {|match| ...}

The text-only lines of the comment block.
def description
	return to_enum(:description) unless block_given?
	
	# We track empty lines and only yield a single empty line when there is another line of text:
	gap = false
	
	@comments.each do |comment|
		if match = comment.match(DESCRIPTION)
			if match[1]
				if gap
					yield ""
					gap = false
				end
				
				yield match[1]
			else
				gap = true
			end
		else
			break
		end
	end
end