package ExtUtils::Helpers;

$ExtUtils::Helpers::VERSION = '0.026';

use strict;

use warnings FATAL => 'all';

use Exporter 5.57 'import';

use Config;

use File::Basename qw/basename/;

use File::Spec::Functions qw/splitpath canonpath abs2rel splitdir/;

use Text::ParseWords 3.24 ();

our @EXPORT_OK = qw/make_executable split_like_shell man1_pagename man3_pagename detildefy/;

BEGIN {

	my %impl_for = ( MSWin32 => 'Windows', VMS => 'VMS');

	my $package = 'ExtUtils::Helpers::' . ($impl_for{$^O} || 'Unix');

	my $impl = $impl_for{$^O} || 'Unix';

	require "ExtUtils/Helpers/$impl.pm";

	"ExtUtils::Helpers::$impl"->import();

}

sub split_like_shell {

	my ($string) = @_;

	return if not defined $string;

	$string =~ s/^\s+|\s+$//g;

	return if not length $string;

	return Text::ParseWords::shellwords($string);

}

sub man1_pagename {

	my $filename = shift;

	return basename($filename).".$Config{man1ext}";

}

my %separator = (

	MSWin32 => '.',

	VMS => '__',

	os2 => '.',

	cygwin => '.',

);

my $separator = $separator{$^O} || '::';

sub man3_pagename {

	my ($filename, $base) = @_;

	$base ||= 'lib';

	my ($vols, $dirs, $file) = splitpath(canonpath(abs2rel($filename, $base)));

	$file = basename($file, qw/.pm .pod/);

	my @dirs = grep { length } splitdir($dirs);

	return join $separator, @dirs, "$file.$Config{man3ext}";

}

1;

# ABSTRACT: Various portability utilities for module builders

__END__

=pod

=encoding utf-8

=head1 NAME

ExtUtils::Helpers - Various portability utilities for module builders

=head1 VERSION

version 0.026

=head1 SYNOPSIS

 use ExtUtils::Helpers qw/make_executable split_like_shell/;

 unshift @ARGV, split_like_shell($ENV{PROGRAM_OPTS});

 write_script_to('Build');

 make_executable('Build');

=head1 DESCRIPTION

This module provides various portable helper functions for module building modules.

=head1 FUNCTIONS

=head2 make_executable($filename)

This makes a perl script executable.

=head2 split_like_shell($string)

This function splits a string the same way as the local platform does.

=head2 detildefy($path)

This function substitutes a tilde at the start of a path with the users homedir in an appropriate manner.

=head2 man1_pagename($filename)

Returns the man page filename for a script.

=head2 man3_pagename($filename, $basedir)

Returns the man page filename for a Perl library.

=head1 ACKNOWLEDGEMENTS

Olivier Mengué and Christian Walde made C<make_executable> work on Windows.

=head1 AUTHORS

=over 4

=item *

Ken Williams <kwilliams@cpan.org>

=item *

Leon Timmermans <leont@cpan.org>

=back

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2004 by Ken Williams, Leon Timmermans.

This is free software; you can redistribute it and/or modify it under

the same terms as the Perl 5 programming language system itself.

=cut