Skip Menu |
Report information
Id: 127038
Status: open
Priority: 0/
Queue: perl6

Owner: Nobody
Requestors: autarch <autarch [at] urth.org>
Cc:
AdminCc:

Severity: (no value)
Tag: (no value)
Platform: (no value)
Patch Status: (no value)
VM: (no value)



Subject: Pod parsing does not create raw blocks
Download (untitled) / with headers
text/plain 511b
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 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.
Download (untitled) / with headers
text/plain 1.1k
On Sat, 26 Dec 2015 14:27:04 -0800, autarch wrote: Show quoted text
> 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). Show quoted text
> 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>.


This service is sponsored and maintained by Best Practical Solutions and runs on Perl.org infrastructure.

For issues related to this RT instance (aka "perlbug"), please contact perlbug-admin at perl.org