Damian Conway wrote:
> It's not yet committed, as there will (no doubt) be much discussion
> first. I apologize in advance: I am still travelling on my annual world
> tour, so my ability to participate in this discussion will be limited
> and erratic.

In the spirit of "ask for forgiveness rather than permission" I'd
suggest to commit it early. People on #perl6 have been asking where it
is already, since it's not at the usual location[tm].


> Of course, all comments, suggestions, and patches are most welcome.

Then let me start with a huge praise: to me it seems much more practical
to the Pod writer than the previous version. I appreciate the huge
effort that has surely flown into it.

However it seems we have to pay a price: each act of rendering a Pod
file actually means executing the program that's being documented (at
least the BEGIN blocks and other stuff that happens at compile time),
with all the security risks implied. So we'll need a *very* good
sandbox. Is that worth it?

Two minor comments:

ll 99:
    followed by a valid identifierN<
        A valid identifier is a sequence of alphanumerics and/or
        underscores, beginning with an alphabetic or underscore
    >

Is there a good reason to deviate from Perl 6's definition of an
identifier? For the sake of consistentcy I'd just say that the Perl 6 rules
apply.



ll 311:
    sub fu (             #= This text stored in C<&fu.WHY>

This seems to be ignorant of multi subs. If I write

    multi sub fu () {    #= some Pod

Then &fu is a multi, not a particular candidate. Does it actually attach to
the .WHY of the candidate? Or of the multi?


Cheers,
Moritz

Reply via email to