Acme-GuessNumber Installation Guide * Table of Contents * System Requirements * Installation Instruction ** Install with ExtUtils::MakeMaker ** Install with Module::Build ** Install with the CPAN Shell ** Install with the CPANPLUS Shell * System Requirements 1. Perl, version 5 or above. To be a winner of the game you have no option but Perl 5. You can run perl -v to see your current Perl version. If you don't have Perl, or if you have an older version of Perl, you can download and install/upgrade it from Perl website. http://www.perl.com/ If you are using MS-Windows, you can download and install ActiveState ActivePerl. http://www.activestate.com/ 2. Required Perl modules: None. 3. Optional Perl modules: none * Installation Instruction ** Install with ExtUtils::MakeMaker arclog uses standard Perl installation with ExtUtils::MakeMaker. Follow these steps: % perl Makefile.PL % make % make test % make install When running make install, make sure you have the priviledge to write to the installation location. This usually requires the root priviledge. If you are using ActivePerl under MS-Windows, you should use nmake instead of make. nmake can be obtained from the Microsoft FTP site. ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe If you want to install into another location, you can set the PREFIX. For example, to install into your home when you are not root: % perl Makefile.PL PREFIX=/home/jessica Refer to the docuemntation of ExtUtils::MakeMaker for more installation options (by running perldoc ExtUtils::MakeMaker). ** Install with Module::Build You can install with Module::Build instead, if you prefer. Follow these steps: % perl Build.PL % ./Build % ./Build test % ./Build install When running ./Build install, make sure you have the priviledge to write to the installation location. This usually requires the root priviledge. If you want to install into another location, you can set the --prefix. For example, to install into your home when you are not root: % perl Build.PL --prefix=/home/jessica Refer to the docuemntation of Module::Build for more installation options (by running perldoc Module::Build). ** Install with the CPAN Shell You can install with the CPAN shell, if you prefer. CPAN shell takes care of ExtUtils::MakeMaker and Module::Build for you: % cpan Acme::GuessNumber Make sure you have the priviledge to write to the installation location. This usually requires the root priviledge. Since CPAN shell 1.81 you can set "make_install_make_command" and "mbuild_install_build_command" in your CPAN configuration to switch to root just before install: % cpan cpan> o conf make_install_make_command "sudo make" cpan> o conf mbuild_install_build_command "sudo ./Build" cpan> install Acme::GuessNumber If you want to install into another location, you can set the "makepl_arg" and "mbuild_arg" in your CPAN configuration. For example, to install into your home when you are not root: % cpan cpan> o conf makepl_arg "PREFIX=/home/jessica" cpan> o conf mbuild_arg "--prefix=/home/jessica" cpan> install Acme::GuessNumber Refer to the docuemntation of cpan for more CPAN shell commands (by running perldoc cpan). ** Install with the CPANPLUS Shell You can install with the CPANPLUS shell, if you prefer. CPANPLUS shell takes care of ExtUtils::MakeMaker and Module::Build for you: % cpanp -i Acme::GuessNumber Make sure you have the priviledge to write to the installation location. This usually requires the root priviledge. If you want to install into another location, you can set the "makemakerflags" and "buildflags" in your CPANPLUS configuration. For example, to install into your home when you are not root: % cpanp CPAN Terminal> s conf makemakerflags "PREFIX=/home/jessica" CPAN Terminal> s conf buildflags "--prefix=/home/jessica" CPAN Terminal> install Acme::GuessNumber Refer to the docuemntation of cpanp for more CPANPLUS shell commands (by running perldoc cpanp). imacat 2008-04-22 imacat@mail.imacat.idv.tw http://www.imacat.idv.tw/