summaryrefslogtreecommitdiff
path: root/Master/tlpkg/tlperl/bin/cpan.bat
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/tlperl/bin/cpan.bat')
-rwxr-xr-xMaster/tlpkg/tlperl/bin/cpan.bat245
1 files changed, 0 insertions, 245 deletions
diff --git a/Master/tlpkg/tlperl/bin/cpan.bat b/Master/tlpkg/tlperl/bin/cpan.bat
deleted file mode 100755
index b96d7678fd2..00000000000
--- a/Master/tlpkg/tlperl/bin/cpan.bat
+++ /dev/null
@@ -1,245 +0,0 @@
-@rem = '--*-Perl-*--
-@echo off
-if "%OS%" == "Windows_NT" goto WinNT
-perl -x -S "%0" %1 %2 %3 %4 %5 %6 %7 %8 %9
-goto endofperl
-:WinNT
-perl -x -S %0 %*
-if NOT "%COMSPEC%" == "%SystemRoot%\system32\cmd.exe" goto endofperl
-if %errorlevel% == 9009 echo You do not have Perl in your PATH.
-if errorlevel 1 goto script_failed_so_exit_with_non_zero_val 2>nul
-goto endofperl
-@rem ';
-#!/usr/local/bin/perl
-#line 15
-use strict;
-use vars qw($VERSION);
-
-use App::Cpan;
-$VERSION = '1.57';
-
-my $rc = App::Cpan->run( @ARGV );
-
-# will this work under Strawberry Perl?
-exit( $rc || 0 );
-
-=head1 NAME
-
-cpan - easily interact with CPAN from the command line
-
-=head1 SYNOPSIS
-
- # with arguments and no switches, installs specified modules
- cpan module_name [ module_name ... ]
-
- # with switches, installs modules with extra behavior
- cpan [-cfgimt] module_name [ module_name ... ]
-
- # with just the dot, install from the distribution in the
- # current directory
- cpan .
-
- # without arguments, starts CPAN.pm shell
- cpan
-
- # dump the configuration
- cpan -J
-
- # load a different configuration to install Module::Foo
- cpan -j some/other/file Module::Foo
-
- # without arguments, but some switches
- cpan [-ahrvACDlLO]
-
-=head1 DESCRIPTION
-
-This script provides a command interface (not a shell) to CPAN. At the
-moment it uses CPAN.pm to do the work, but it is not a one-shot command
-runner for CPAN.pm.
-
-=head2 Options
-
-=over 4
-
-=item -a
-
-Creates a CPAN.pm autobundle with CPAN::Shell->autobundle.
-
-=item -A module [ module ... ]
-
-Shows the primary maintainers for the specified modules.
-
-=item -c module
-
-Runs a `make clean` in the specified module's directories.
-
-=item -C module [ module ... ]
-
-Show the F<Changes> files for the specified modules
-
-=item -D module [ module ... ]
-
-Show the module details. This prints one line for each out-of-date module
-(meaning, modules locally installed but have newer versions on CPAN).
-Each line has three columns: module name, local version, and CPAN
-version.
-
-=item -f
-
-Force the specified action, when it normally would have failed. Use this
-to install a module even if its tests fail. When you use this option,
--i is not optional for installing a module when you need to force it:
-
- % cpan -f -i Module::Foo
-
-=item -F
-
-Turn off CPAN.pm's attempts to lock anything. You should be careful with
-this since you might end up with multiple scripts trying to muck in the
-same directory. This isn't so much of a concern if you're loading a special
-config with C<-j>, and that config sets up its own work directories.
-
-=item -g module [ module ... ]
-
-Downloads to the current directory the latest distribution of the module.
-
-=item -G module [ module ... ]
-
-UNIMPLEMENTED
-
-Download to the current directory the latest distribution of the
-modules, unpack each distribution, and create a git repository for each
-distribution.
-
-If you want this feature, check out Yanick Champoux's C<Git::CPAN::Patch>
-distribution.
-
-=item -h
-
-Print a help message and exit. When you specify C<-h>, it ignores all
-of the other options and arguments.
-
-=item -i
-
-Install the specified modules.
-
-=item -j Config.pm
-
-Load the file that has the CPAN configuration data. This should have the
-same format as the standard F<CPAN/Config.pm> file, which defines
-C<$CPAN::Config> as an anonymous hash.
-
-=item -J
-
-Dump the configuration in the same format that CPAN.pm uses. This is useful
-for checking the configuration as well as using the dump as a starting point
-for a new, custom configuration.
-
-=item -L author [ author ... ]
-
-List the modules by the specified authors.
-
-=item -m
-
-Make the specified modules.
-
-=item -O
-
-Show the out-of-date modules.
-
-=item -t
-
-Run a `make test` on the specified modules.
-
-=item -r
-
-Recompiles dynamically loaded modules with CPAN::Shell->recompile.
-
-=item -v
-
-Print the script version and CPAN.pm version then exit.
-
-=back
-
-=head2 Examples
-
- # print a help message
- cpan -h
-
- # print the version numbers
- cpan -v
-
- # create an autobundle
- cpan -a
-
- # recompile modules
- cpan -r
-
- # install modules ( sole -i is optional )
- cpan -i Netscape::Booksmarks Business::ISBN
-
- # force install modules ( must use -i )
- cpan -fi CGI::Minimal URI
-
-=head1 EXIT VALUES
-
-The script exits with zero if it thinks that everything worked, or a
-positive number if it thinks that something failed. Note, however, that
-in some cases it has to divine a failure by the output of things it does
-not control. For now, the exit codes are vague:
-
- 1 An unknown error
-
- 2 The was an external problem
-
- 4 There was an internal problem with the script
-
- 8 A module failed to install
-
-=head1 TO DO
-
-* one shot configuration values from the command line
-
-
-
-=head1 BUGS
-
-* none noted
-
-=head1 SEE ALSO
-
-Most behaviour, including environment variables and configuration,
-comes directly from CPAN.pm.
-
-=head1 SOURCE AVAILABILITY
-
-This code is in Github:
-
- git://github.com/briandfoy/cpan_script.git
-
-=head1 CREDITS
-
-Japheth Cleaver added the bits to allow a forced install (-f).
-
-Jim Brandt suggest and provided the initial implementation for the
-up-to-date and Changes features.
-
-Adam Kennedy pointed out that exit() causes problems on Windows
-where this script ends up with a .bat extension
-
-=head1 AUTHOR
-
-brian d foy, C<< <bdfoy@cpan.org> >>
-
-=head1 COPYRIGHT
-
-Copyright (c) 2001-2009, brian d foy, All Rights Reserved.
-
-You may redistribute this under the same terms as Perl itself.
-
-=cut
-
-1;
-
-__END__
-:endofperl