Skip to content

Commit fa6a51e

Browse files
committed
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
1 parent 25035a5 commit fa6a51e

File tree

2 files changed

+16
-1
lines changed

2 files changed

+16
-1
lines changed

autodoc.pl

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2780,6 +2780,20 @@ ($destpod)
27802780
|to be documented. Patches welcome! The interfaces of these are subject to
27812781
|change without notice.
27822782
|
2783+
|To find out what release an element came into being, use
2784+
|
2785+
| perl dist/ppport.h --api-info=element
2786+
|
2787+
|You may also use a pattern
2788+
|
2789+
| perl dist/ppport.h --api-info=/./
2790+
|
2791+
|displays all possible public api elements, but not items in L<perlintern>.
2792+
|Some elements have been backported in L<Devel::PPPort> so that they are
2793+
|usable in earlier versions than they otherwise would be available. The
2794+
|display also includes information as to what the earliest possible version
2795+
|such an element may be used in; as well as some hints and cautions.
2796+
|
27832797
|Some of the functions documented here are consolidated so that a single entry
27842798
|serves for multiple functions which all do basically the same thing, but have
27852799
|some slight differences. For example, one form might process magic, while

pod/perldelta.pod

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -219,7 +219,8 @@ Additionally, the following selected changes have been made:
219219

220220
=item *
221221

222-
XXX Description of the change here
222+
L<perlapi> now contains information about how to find what release of
223+
Perl first contained an API element
223224

224225
=back
225226

0 commit comments

Comments
 (0)