fix .gitignore: only ignore 'perl' in root of repo, not U/perl subdir

[metaconfig.git] / U / perl / xs_apiversion.U

?RCS: $Id: xs_apiversion.U $
?RCS:
?RCS: Copyright (c) 1999 Andy Dougherty
?RCS:
?RCS: You may redistribute only under the terms of the Artistic License,
?RCS: as specified in the README file that comes with the distribution.
?RCS: You may reuse parts of this distribution only within the terms of
?RCS: that same Artistic License; a copy of which may be found at the root
?RCS: of the source tree for dist 3.0.
?RCS:
?RCS: $Log: xs_apiversion.U,v $
?RCS:
?MAKE:xs_apiversion pm_apiversion: version
?MAKE:	-pick add $@ %<
?S:xs_apiversion:
?S:	This variable contains the version of the oldest perl binary
?S:	compatible with the present perl.  perl.c:incpush() and
?S:	lib/lib.pm will automatically search in $sitearch for older
?S:	directories across major versions back to xs_apiversion.
?S:	This is only useful if you have a perl library directory tree
?S:	structured like the default one.
?S:	See INSTALL for how this works.
?S:	The versioned site_perl directory was introduced in 5.005,
?S:	so that is the lowest possible value.
?S:	Since this can depend on compile time options
?S:	it is set by Configure.  Other non-default sources
?S:	of potential incompatibility, such as multiplicity, threads,
?S:	debugging, 64bits, sfio, etc., are not checked for currently,
?S:	though in principle we could go snooping around in old
?S:	Config.pm files.
?S:.
?S:pm_apiversion:
?S:	This variable contains the version of the oldest perl
?S:	compatible with the present perl.  (That is, pure perl modules
?S:	written for $pm_apiversion will still work for the current
?S:	version).  perl.c:incpush() and lib/lib.pm will automatically
?S:	search in $sitelib for older directories across major versions
?S:	back to pm_apiversion.  This is only useful if you have a perl
?S:	library directory tree structured like the default one.  The
?S:	versioned site_perl library was introduced in 5.005, so that's
?S:	the default setting for this variable.  It's hard to imagine
?S:	it changing before Perl6.  It is included here for symmetry
?S:	with xs_apiveprsion -- the searching algorithms will
?S:	(presumably) be similar.
?S:	See the INSTALL file for how this works.
?S:.
?C:PERL_XS_APIVERSION:
?C:	This variable contains the version of the oldest perl binary
?C:	compatible with the present perl.  perl.c:incpush() and
?C:	lib/lib.pm will automatically search in $sitearch for older
?C:	directories across major versions back to xs_apiversion.
?C:	This is only useful if you have a perl library directory tree
?C:	structured like the default one.
?C:	See INSTALL for how this works.
?C:	The versioned site_perl directory was introduced in 5.005,
?C:	so that is the lowest possible value.
?C:	Since this can depend on compile time options
?C:	it is set by Configure.  Other non-default sources
?C:	of potential incompatibility, such as multiplicity, threads,
?C:	debugging, 64bits, sfio, etc., are not checked for currently,
?C:	though in principle we could go snooping around in old
?C:	Config.pm files.
?C:.
?C:PERL_PM_APIVERSION:
?C:	This variable contains the version of the oldest perl
?C:	compatible with the present perl.  (That is, pure perl modules
?C:	written for pm_apiversion will still work for the current
?C:	version).  perl.c:incpush() and lib/lib.pm will automatically
?C:	search in $sitelib for older directories across major versions
?C:	back to pm_apiversion.  This is only useful if you have a perl
?C:	library directory tree structured like the default one.  The
?C:	versioned site_perl library was introduced in 5.005, so that's
?C:	the default setting for this variable.  It's hard to imagine
?C:	it changing before Perl6.  It is included here for symmetry
?C:	with xs_apiveprsion -- the searching algorithms will
?C:	(presumably) be similar.
?C:	See the INSTALL file for how this works.
?C:.
?H:#define PERL_XS_APIVERSION "$xs_apiversion"
?H:#define PERL_PM_APIVERSION "$pm_apiversion"
?H:.
: Find earliest binary compatible site_perl subdirectory perl can use.
xs_apiversion=$version # The current site_perl version.
: Find earliest pure perl site_perl subdirectory perl can use.
: The versioned directories started at 5.005.
pm_apiversion='5.005'