On Sat, 26 Dec 2015 14:27:04 -0800, autarch wrote:
> There's a class in rakudo's Pod.pm named Pod::Raw, but rakudo does not
> produce these blocks. I'm not sure whether the bug is that the class
> exists or that it's never used.
I *think* it's meant to be Pod::Block::Comment. In rakudo/src/Perl6/Pod.nqp the
raw_block() routine spits out comments, and is called only for comments from
Actions. IMO Pod::Raw could be removed (and raw_block() renamed
comment_block(), I guess).
> I note that for something like "=begin html ... =end html" you get a
> Pod::Block::Named. That seems ok to me, and maybe we just don't need
> Pod::Raw to exist. The only issue is that there needs to be a way to
> tell the parser that the contents of a block should not be parsed for
> more Pod, or only selected Pod, like we have for code blocks.
In S26, named blocks are introduced by Titlecase identifiers, so
=Html :style-uri('http://example.com/css/pod.css')
<b>This is meant to be unparsed, and used by any processor that wants
to use it</b>
=html
This seems like it should be an error, as I read it:
S26:
Note that all block names consisting entirely of lowercase or
entirely of uppercase letters are reserved. See L<#Semantic blocks>.
