From fa6a51efeaafadefb906b540ca74ed92376a9695 Mon Sep 17 00:00:00 2001 From: Karl Williamson Date: Sat, 5 Mar 2022 21:52:20 -0700 Subject: [PATCH] perlapi: How to find when API item added to Perl This adds text to this pod that shows how to use ppport to find when an API element came into being in perl --- autodoc.pl | 14 ++++++++++++++ pod/perldelta.pod | 3 ++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/autodoc.pl b/autodoc.pl index 365073568a8f..d5803d440127 100644 --- a/autodoc.pl +++ b/autodoc.pl @@ -2780,6 +2780,20 @@ ($destpod) |to be documented. Patches welcome! The interfaces of these are subject to |change without notice. | +|To find out what release an element came into being, use +| +| perl dist/ppport.h --api-info=element +| +|You may also use a pattern +| +| perl dist/ppport.h --api-info=/./ +| +|displays all possible public api elements, but not items in L. +|Some elements have been backported in L so that they are +|usable in earlier versions than they otherwise would be available. The +|display also includes information as to what the earliest possible version +|such an element may be used in; as well as some hints and cautions. +| |Some of the functions documented here are consolidated so that a single entry |serves for multiple functions which all do basically the same thing, but have |some slight differences. For example, one form might process magic, while diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 8917ce5a4296..1e7b480b0776 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -219,7 +219,8 @@ Additionally, the following selected changes have been made: =item * -XXX Description of the change here +L now contains information about how to find what release of +Perl first contained an API element =back