Read block documentation comments delimited by ----- or ===== lines