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