develooper Front page | perl.perl6.language | Postings from June 2007

Re: [svn:perl6-synopsis] r14421 - doc/trunk/design/syn

Thread Previous | Thread Next
From:
Jonathan Lang
Date:
June 14, 2007 07:49
Subject:
Re: [svn:perl6-synopsis] r14421 - doc/trunk/design/syn
Message ID:
ef30550b0706140749w6c6290e9qc164901b578a8d5b@mail.gmail.com
I'm going to stay away from the "POD referencing Perl" debate for the
time being.  Instead, a couple of thoughts:

1. It has always been my understanding that comments intimately relate
to documentation, despite being part of Perl's syntax.  As such, they
are a technical violation of this "separation of Church and State",
being State-sponsored religion as it were. (Who'd have thought that
we'd be talking politics and religion on a programming language
mailing list?  Egad!)  Not that I'm advocating the removal of
comments; their sheer practical value makes up for their heathen ways.

2. Getting block comments to hide POD blocks wouldn't require the POD
parser to have a full implementation of a Perl parser.  It would
require the POD parser to have a _limited_ implementation of a Perl
parser, one that's capable of identifying block comments.  And IIRC,
you already have to do something like this with respect to block
quotes:

  say :to(END);
  =begin POD
  blah blah blah
  =end POD
  END

If I understand matters correctly, the "POD code" in the above example
isn't POD code at all, but rather the content of a multi-line quote.
So extending the POD parser's awareness of Perl syntax to handle block
comments as well isn't much of a stretch.

-- 
Jonathan "Dataweaver" Lang

Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About