#
# configpm
#
-# Copyright (C) 1994, 1995, 1996 1997, 1998, 1999, 2000, 2001,
-# 2002, 2003, 2004, 2005, 2006 Larry Wall and others.
+# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
+# 2002, 2003, 2004, 2005, 2006, 2007 Larry Wall and others.
#
#
# Regenerate the files
# lib/Config.pod
# lib/Cross.pm (optionally)
#
+#
# from the contents of the static files
#
# Porting/Glossary
#
# config.sh
#
+# Note that output directory is xlib/[cross-name]/ for cross-compiling
+#
# It will only update Config.pm and Config_heavy.pl if the contents of
# either file would be different. Note that *both* files are updated in
# this case, since for example an extension makefile that has a dependency
# on Config.pm should trigger even if only Config_heavy.pl has changed.
sub usage { die <<EOF }
-usage: $0 [ options ] [ Config_file ] [ Glossary_file ]
+usage: $0 [ options ]
--cross=PLATFORM cross-compile for a different platform
--no-glossary don't include Porting/Glossary in lib/Config.pod
- --heavy=FILE alternative name for lib/Config_heavy.pl
- Config_file alternative name for lib/Config.pm
- Glossary_file alternative name for Porting/Glossary
EOF
use strict;
'cross' => '', # --cross=PLATFORM - crosscompiling for PLATFORM
'glossary' => 1, # --no-glossary - no glossary file inclusion,
# for compactness
- 'heavy' => '', # pathname of the Config_heavy.pl file
);
sub opts {
my %Opts = opts();
-my ($Config_PM, $Config_heavy);
-my $Glossary = $ARGV[1] || 'Porting/Glossary';
+my ($Config_SH, $Config_PM, $Config_heavy, $Config_POD);
+my $Glossary = 'Porting/Glossary';
if ($Opts{cross}) {
# creating cross-platform config file
mkdir "xlib";
mkdir "xlib/$Opts{cross}";
- $Config_PM = $ARGV[0] || "xlib/$Opts{cross}/Config.pm";
-}
-else {
- $Config_PM = $ARGV[0] || 'lib/Config.pm';
-}
-if ($Opts{heavy}) {
- $Config_heavy = $Opts{heavy};
+ $Config_PM = "xlib/$Opts{cross}/Config.pm";
+ $Config_POD = "xlib/$Opts{cross}/Config.pod";
+ $Config_SH = "Cross/config-$Opts{cross}.sh";
}
else {
- ($Config_heavy = $Config_PM) =~ s!\.pm$!_heavy.pl!;
- die "Can't automatically determine name for Config_heavy.pl from '$Config_PM'"
- if $Config_heavy eq $Config_PM;
+ $Config_PM = "lib/Config.pm";
+ $Config_POD = "lib/Config.pod";
+ $Config_SH = "config.sh";
}
+($Config_heavy = $Config_PM) =~ s/\.pm$/_heavy.pl/;
+die "Can't automatically determine name for Config_heavy.pl from '$Config_PM'"
+ if $Config_heavy eq $Config_PM;
my $config_txt;
my $heavy_txt;
# This file was created by configpm when Perl was built. Any changes
# made to this file will be lost the next time perl is built.
+# for a description of the variables, please have a look at the
+# Glossary file, as written in the Porting folder, or use the url:
+# http://perl5.git.perl.org/perl.git/blob/HEAD:/Porting/Glossary
+
package Config;
use strict;
# use warnings; Pulls in Carp
my %seen_quotes;
{
my ($name, $val);
- open(CONFIG_SH, 'config.sh') || die "Can't open config.sh: $!";
+ open(CONFIG_SH, $Config_SH) || die "Can't open $Config_SH: $!";
while (<CONFIG_SH>) {
next if m:^#!/bin/sh:;
sub myconfig {
return $summary_expanded if $summary_expanded;
($summary_expanded = $summary) =~ s{\$(\w+)}
- { my $c = $Config::Config{$1}; defined($c) ? $c : 'undef' }ge;
+ {
+ my $c;
+ if ($1 eq 'git_ancestor_line') {
+ if ($Config::Config{git_ancestor}) {
+ $c= "\n Ancestor: $Config::Config{git_ancestor}";
+ } else {
+ $c= "";
+ }
+ } else {
+ $c = $Config::Config{$1};
+ }
+ defined($c) ? $c : 'undef'
+ }ge;
$summary_expanded;
}
if (@need_relocation) {
$heavy_txt .= 'foreach my $what (qw(' . join (' ', @need_relocation) .
")) {\n" . <<'EOT';
- s<^($what=)(['"])(.*?)\2>
- <$1 . $2 . relocate_inc($3) . $2 . "\n" .
- 'raw_' . $1 . $2 . $3 . $2>me;
+ s/^($what=)(['"])(.*?)\2/$1 . $2 . relocate_inc($3) . $2/me;
}
EOT
# Currently it only makes sense to do the ... relocation on Unix, so there's
$heavy_txt .= "EOVIRTUAL\n";
+$heavy_txt .= <<'ENDOFGIT';
+eval {
+ # do not have hairy conniptions if this isnt available
+ require 'Config_git.pl';
+ $Config_SH_expanded .= $Config::Git_Data;
+ 1;
+} or warn "Warning: failed to load Config_git.pl, something strange about this perl...\n";
+ENDOFGIT
+
$heavy_txt .= $fetch_string;
$config_txt .= <<'ENDOFEND';
ENDOFTIE
-open(CONFIG_POD, ">lib/Config.pod") or die "Can't open lib/Config.pod: $!";
+open(CONFIG_POD, ">$Config_POD") or die "Can't open $Config_POD: $!";
print CONFIG_POD <<'ENDOFTAIL';
=head1 NAME
values. The perl C<exists> function can be used to check if a
named variable exists.
+For a description of the variables, please have a look at the
+Glossary file, as written in the Porting folder, or use the url:
+http://perl5.git.perl.org/perl.git/blob/HEAD:/Porting/Glossary
+
=over 4
=item myconfig()
specific to that particular port. See the port specific documentation
in such cases.
+=cut
+
ENDOFTAIL
if ($Opts{glossary}) {
print CONFIG_POD <<EOF if $text;
=back
+=cut
+
EOF
print CONFIG_POD <<EOF;
=head2 $c
=over 4
+=cut
+
EOF
$text = 1;
}
=back
+=head1 GIT DATA
+
+Information on the git commit from which the current perl binary was compiled
+can be found in the variable C<$Config::Git_Data>. The variable is a
+structured string that looks something like this:
+
+ git_commit_id='ea0c2dbd5f5ac6845ecc7ec6696415bf8e27bd52'
+ git_describe='GitLive-blead-1076-gea0c2db'
+ git_branch='smartmatch'
+ git_uncommitted_changes=''
+ git_commit_id_title='Commit id:'
+ git_commit_date='2009-05-09 17:47:31 +0200'
+
+Its format is not guaranteed not to change over time.
+
=head1 NOTE
This module contains a good example of how to use tie to implement a
close(GLOS) if $Opts{glossary};
close(CONFIG_POD);
-print "written lib/Config.pod\n";
+print "written $Config_POD\n";
my $orig_config_txt = "";
my $orig_heavy_txt = "";
https://perl5.git.perl.org / perl5.git / blobdiff