3 * Copyright (C) 1993, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
4 * 2003, 2004, 2005, 2006, 2007, 2008, 2009, by Larry Wall and others
6 * You may distribute under the terms of either the GNU General Public
7 * License or the Artistic License, as specified in the README file.
12 =for apidoc_section Versioning
14 =for apidoc AmDnU|U8|PERL_REVISION
15 The major number component of the perl interpreter currently being compiled or
16 executing. This has been C<5> from 1993 into 2020.
18 Instead use one of the version comparison macros. See C<L</PERL_VERSION_EQ>>.
20 =for apidoc AmDnU|U8|PERL_VERSION
21 The minor number component of the perl interpreter currently being compiled or
22 executing. Between 1993 into 2020, this has ranged from 0 to 33.
24 Instead use one of the version comparison macros. See C<L</PERL_VERSION_EQ>>.
26 =for apidoc AmDnU|U8|PERL_SUBVERSION
27 The micro number component of the perl interpreter currently being compiled or
28 executing. In stable releases this gives the dot release number for
29 maintenance updates. In development releases this gives a tag for a snapshot
30 of the status at various points in the development cycle.
32 Instead use one of the version comparison macros. See C<L</PERL_VERSION_EQ>>.
37 #ifndef __PATCHLEVEL_H_INCLUDED__
39 /* do not adjust the whitespace! Configure expects the numbers to be
40 * exactly on the third column */
42 #define PERL_REVISION 5 /* age */
43 #define PERL_VERSION 33 /* epoch */
44 #define PERL_SUBVERSION 3 /* generation */
46 /* The following numbers describe the earliest compatible version of
47 Perl ("compatibility" here being defined as sufficient binary/API
48 compatibility to run XS code built with the older version).
49 Normally this should not change across maintenance releases.
51 Note that this only refers to an out-of-the-box build. Many non-default
52 options such as usemultiplicity tend to break binary compatibility
55 This is used by Configure et al to figure out
56 PERL_INC_VERSION_LIST, which lists version libraries
57 to include in @INC. See INSTALL for how this works.
59 Porting/bump-perl-version will automatically set these to the version of perl
60 to be released for blead releases, and to 5.X.0 for maint releases. Manually
61 changing them should not be necessary.
63 #define PERL_API_REVISION 5
64 #define PERL_API_VERSION 33
65 #define PERL_API_SUBVERSION 3
67 XXX Note: The selection of non-default Configure options, such
68 as -Duselonglong may invalidate these settings. Currently, Configure
69 does not adequately test for this. A.D. Jan 13, 2000
72 #define __PATCHLEVEL_H_INCLUDED__
76 local_patches -- list of locally applied less-than-subversion patches.
77 If you're distributing such a patch, please give it a name and a
78 one-line description, placed just before the last NULL in the array
79 below. If your patch fixes a bug in the perlbug database, please
80 mention the bugid. If your patch *IS* dependent on a prior patch,
81 please place your applied patch line after its dependencies. This
82 will help tracking of patch dependencies.
84 Please either use 'diff --unified=0' if your diff supports
85 that or edit the hunk of the diff output which adds your patch
86 to this list, to remove context lines which would give patch
87 problems. For instance, if the original context diff is
89 *** patchlevel.h.orig <date here>
90 --- patchlevel.h <date here>
93 ,"FOO1235 - some patch"
94 ,"BAR3141 - another patch"
95 ,"BAZ2718 - and another patch"
96 + ,"MINE001 - my new patch"
101 *** patchlevel.h.orig <date here>
102 --- patchlevel.h <date here>
105 + ,"MINE001 - my new patch"
109 (Note changes to line numbers as well as removal of context lines.)
110 This will prevent patch from choking if someone has previously
111 applied different patches than you.
113 History has shown that nobody distributes patches that also
114 modify patchlevel.h. Do it yourself. The following perl
115 program can be used to add a comment to patchlevel.h:
118 die "Usage: perl -x patchlevel.h comment ..." unless @ARGV;
119 open PLIN, "<", "patchlevel.h" or die "Couldn't open patchlevel.h : $!";
120 open PLOUT, ">", "patchlevel.new" or die "Couldn't write on patchlevel.new : $!";
123 if (/\t,NULL/ and $seen) {
124 while (my $c = shift @ARGV){
127 print PLOUT qq{\t,"$c"\n};
130 $seen++ if /local_patches\[\]/;
133 close PLOUT or die "Couldn't close filehandle writing to patchlevel.new : $!";
134 close PLIN or die "Couldn't close filehandle reading from patchlevel.h : $!";
135 close DATA; # needed to allow unlink to work win32.
136 unlink "patchlevel.bak" or warn "Couldn't unlink patchlevel.bak : $!"
137 if -e "patchlevel.bak";
138 rename "patchlevel.h", "patchlevel.bak" or
139 die "Couldn't rename patchlevel.h to patchlevel.bak : $!";
140 rename "patchlevel.new", "patchlevel.h" or
141 die "Couldn't rename patchlevel.new to patchlevel.h : $!";
144 Please keep empty lines below so that context diffs of this file do
145 not ever collect the lines belonging to local_patches() into the same
150 #if !defined(PERL_PATCHLEVEL_H_IMPLICIT) && !defined(LOCAL_PATCH_COUNT)
151 # if defined(PERL_IS_MINIPERL)
152 # define PERL_PATCHNUM "UNKNOWN-miniperl"
153 # define PERL_GIT_UNPUSHED_COMMITS /*leave-this-comment*/
154 # elif defined(PERL_MICRO)
155 # define PERL_PATCHNUM "UNKNOWN-microperl"
156 # define PERL_GIT_UNPUSHED_COMMITS /*leave-this-comment*/
158 #include "git_version.h"
160 static const char * const local_patches[] = {
162 #ifdef PERL_GIT_UNCOMMITTED_CHANGES
163 ,"uncommitted-changes"
165 PERL_GIT_UNPUSHED_COMMITS /* do not remove this line */
171 /* Initial space prevents this variable from being inserted in config.sh */
172 # define LOCAL_PATCH_COUNT \
173 ((int)(C_ARRAY_LENGTH(local_patches)-2))
175 /* the old terms of reference, add them only when explicitly included */
176 #define PATCHLEVEL PERL_VERSION
177 #undef SUBVERSION /* OS/390 has a SUBVERSION in a system header */
178 #define SUBVERSION PERL_SUBVERSION