[perl #39085] [TODO] pmc - make pmc2c.pl extract function declarations

[Andy Lester]

# New Ticket Created by Andy Lester
# Please include the string: [perl #39085]
# in the subject line of all future correspondence about this issue.
# <URL: https://rt.perl.org/rt3/Ticket/Display.html?id=39085 >

Each .pmc file has redundant function headings. For example, in src/
pmc/integer.c

/*
=item C<PMC instantiate(PMC* sig)>

Create a new Integer with arguments passed according to pdd03.

=cut

*/
PMC* instantiate(PMC* sig) {
PMC* const ret = new_pmc_header(INTERP, 0);
opcode_t *arg_op;
INTVAL init = 0;

There's no reason pmc2c.pl can't create the =item line from the
declaration of the function itself. This removes double-maintenance
for the programmer, and the chance of getting the two out of sync.

--
Andy Lester => an...@petdance.com => www.petdance.com => AIM:petdance