# New Ticket Created by Bernhard Schmalhofer # Please include the string: [perl #52720] # in the subject line of all future correspondence about this issue. # <URL: http://rt.perl.org/rt3/Ticket/Display.html?id=52720 >
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: [22:17] <barney> Looks like the docs to 'compreg' is incomplete [22:19] <Coke> something in particular lacking? [22:20] <barney> Registering an object on which the method 'compile' will be called [22:20] <Coke> the opcode descriptions are shy. [22:20] <pmichaud> compreg is old [22:20] <Coke> barney: You can DO that? [22:20] <Coke> I thought it was just an invokable. [22:20] <pmichaud> compreg doesn't care what kind of object it's given [22:20] <pmichaud> it's basically a glorified hash [22:21] <barney> I need to do that, It complained when I wanted to register a Sub [22:21] <pmichaud> whatever you stick into it is what you get out [22:21] <Coke> pmichaud: the expectation, though, is that when you get something out of the hash, you can simply invoke it and pass in the source as a single string arg. [22:21] <barney> I see. Calling the method 'compile' then is just a convention ? [22:21] <pmichaud> coke: I think that's no longer true either [22:22] <pmichaud> nowadays we expect to have a compiler object with a 'compile' method [22:22] <pmichaud> but I don't think that's been officially specced in a PDD yet, except for... [22:22] <Coke> ... that's definitely not documented near the opcode. [22:22] <Coke> and is very likely not how tcl works. [22:23] <Coke> barney: opening a ticket would be good. The scope of this ticket, is that the docs are to be updated, so that they reflect the current state. Specifying an interface for compiler object is a different issue.
