On Thu, Apr 10, 2008 at 02:02:37PM -0700, Bernhard Schmalhofer wrote:
> When removing Parrot/HLLCompiler for RT#48030 I noticed that the docs
> of 'comreg'
> did not match very well with reality.
>
> pmichaud elaborated on IRC:
> [...]
See also the thread on this topic at [1]. Essentially a decision
was made in November 2006 that C<compreg> would return compiler objects
and that compilation would be done via a method call, but this
has yet to be recorded in a PDD.
For now I propose that we address the ticket by changing the docs
to read:
=item B<compreg>(out PMC, in STR)
Get the compiler object for source type $2. The returned compiler
object should provide a C<compile> method for translating code
in the source type. However, some Parrot compilers such as
C<PIR> and C<PASM> currently return a sub that is to be
invoked directly on the source.
=item B<compreg>(in STR, invar PMC)
Register $2 as the compiler object for source type $1.
A patch is attached making this change.
Pm
1.
http://groups.google.com/group/perl.perl6.internals/browse_thread/thread/9c58722a98f731b3