CPANPLUS::FAQ - Frequently Asked Questions about CPANPLUS
This is the Frequently Asked Questions list for the CPANPLUS kit. More accurately, it's a very thin placeholder for where the FAQ will soon be.
The most up-to-date version of the FAQ can be found at the website http://cpanplus.sourceforge.net. This version of the FAQ may contain updates between code releases.
The CPANPLUS bugs mailing list archive is available at http://www.geocrawler.com/lists/3/SourceForge/18022/.
Work-arounds to known bugs will probably be available in the most recent FAQ.
CPANPLUS currently only supports proxies with LWP::UserAgent. You will need to set your environment variables accordingly. For example, to use an ftp proxy:
$ENV{ftp_proxy} = 'foo.com';
Refer to LWP::UserAgent for more details.
In versions before 0.04, CPANPLUS was designed to fetch initial files exclusively from ftp.cpan.org on the assumption this site would always be available. If CPANPLUS hangs during the initial fetch, it could mean that ftp.cpan.org is unavailable. This is only a problem for installation, as your own host list will be used once CPANPLUS is installed. A work-around is to edit Config.pm-orig in lib/CPANPLUS in the CPANPLUS directory. Under the hash key _ftp there's a key urilist. Near that should be the line 'host' = 'ftp.cpan.org'>. Simply replace this host with another one.
'host' =
The CPANPLUS interface will only be backwards-compatible with itself after version 1.0. This gives us a chance to correct and expand without being locked to an interface in early versions. Two things that have notably changed since the first version are the configuration and some Backend return values.
If it has to do with installing modules, most likely! Keep in mind that while the default shell may not be able to do something like "install all modules in the POE namespace", you can easily make something of the sort, using CPANPLUS::Backend.
The default shell is designed to be what the developers wanted in a shell.
If it doesn't do what you want, consider writing your own with CPANPLUS::Backend, and possibly releasing it in the CPANPLUS::Shell::* namespace. You can also change your default shell to be any other CPANPLUS shell you have installed.
Reliably under 5.005_03.
FreeBSD, Linux, Win32 and Cygwin.
None.
Set makemakerflags to something like this:
makemakerflags
LIB=~/perl/lib INSTALLMAN1DIR=~/perl/man/man1 INSTALLMAN3DIR=~/perl/man/man3
Of course you should replace 'perl' with the appropriate directory.
Also, be sure never to use UNINST=1 in makeflags.
makeflags
Currently, it is not possible to have multiple setup files, so all users will use the same repository and configuration.
To do this you need to ensure that you have an up-to-date listing of modules so that if the most recent version of a module isn't found in the local mirror, CPANPLUS will try to get it from the external mirror.
In your setup, list only complete mirrors. This way you will get a current listing from one of them when you start CPANPLUS.
Next, add your local mirror at runtime so that it becomes the new first choice.
In this example a CD from another server on the network is added (leave off the host argument if it is on the local machine):
my $cb = new CPANPLUS::Backend; my $conf = $cb->configure_object; $conf->_set_ftp(urilist => [ { path => '/mnt/cdrom', scheme => 'file', host => '//server', }, @{ $conf->_get_ftp('urilist') } ]);
Thanks to Nick Clark for asking this at the 2002 German Perl Workshop.
Ann Barcomb <kudra@cpan.org>.
The CPAN++ interface (of which this document is a part of) is copyright (c) 2001, 2002 Jos Boumans <kane@cpan.org>. All rights reserved.
This library is free software; you may redistribute and/or modify it under the same terms as Perl itself.
CPANPLUS::Backend, CPANPLUS::Shell::Default, CPANPLUS, CPANPLUS::Configure, http://cpanplus.sourceforge.net
To install CPANPLUS, copy and paste the appropriate command in to your terminal.
cpanm
cpanm CPANPLUS
CPAN shell
perl -MCPAN -e shell install CPANPLUS
For more information on module installation, please visit the detailed CPAN module installation guide.