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

Reply via email to