perl5 icon indicating copy to clipboard operation
perl5 copied to clipboard

Deprecation of GIMME long promised but not yet scheduled

Open jkeenan opened this issue 1 year ago • 0 comments

(Moved from https://github.com/Perl/perl5/pull/22527#issuecomment-2302024016.)

I read the following in the documentation (5.40.0):

perldoc perl5380delta

    *   The underlying "Perl_dowantarray" function implementing the
        long-deprecated "GIMME" macro has been marked as deprecated, so that
        use of the macro emits a compile-time warning. "GIMME" has been
        documented as deprecated in favour of "GIMME_V" since Perl v5.6.0,
        but had not previously issued a warning.

perldoc perlapi

    "GIMME"
        "DEPRECATED!" It is planned to remove "GIMME" from a future release
        of Perl. Do not use it for new code; remove it from existing code.

        A backward-compatible version of "GIMME_V" which can only return
        "G_SCALAR" or "G_LIST"; in a void context, it returns "G_SCALAR".
        Deprecated. Use "GIMME_V" instead.

            U32  GIMME

But I see no mention of GIMME in pod/perldeprecation.pod. So shouldn't we be developing a plan and a timetable for its removal? Can anyone explain why we haven't done so already (e.g., it may be in use in darkpan code)?

jkeenan avatar Aug 22 '24 11:08 jkeenan