CONTENTS
--------
Installation of Perl/Tk
Installation
1. CPAN
2. CPANP
3. Module::Build
4. ExtUtils-MakeMaker
Acknowledgement
INSTALLATION OF PERL/TK
-----------------------
Users of Linux or of the Strawberry Perl distribution usually have
Tk already installed or may install it easily with their package manager.
So this section is relevant only for users that work on Windows with the
Perl distribution ActivePerl.
Newer versions of ActivePerl install the MinGW package and the dmake
utility automatically when you use the shell commands cpan or cpanp for
the first time. I observed this with version v5.16.3, so maybe you can
ignore this section.
Please look whether Tk (the Perl/Tk package) or gcc (a C++ compiler) is
installed. If none of them is present, choose one for install. In any
case, you will need administative privileges for this.
Install gcc: Using ppm, install the MinGW package. This will also install
the gcc compiler. When gcc is available, the installation of
Games::Sudoku::Trainer can successfully install Tk as a
prerequisite.
Install Tk: In your browser, visit the website http://www.bribes.org/perl/.
On the bottom, select your repository (32 bit or 64 bit). In the
repository search for the "Tk" entry, copy the DOS command in it
and insert it in the DOS shell window. This command will add Tk
to the ppm repository of ActivePerl. Now you can use ppm to
install Tk.
INSTALLATION INSTRUCTIONS
-------------------------
There are several procedures available for installation of Perl modules. It's
recommended that you use the first one in this list that is available in your
Perl distribution. For all of them you will need administative privileges.
1. CPAN
-------
Use the shell command "cpan Games::Sudoku::Trainer".
2. CPANP
--------
Use the shell command "cpanp -i Games::Sudoku::Trainer".
-----------------
For the following installation procedures you need a preliminary step:
Visit the website
http://search.cpan.org/search?query=sudokutrainer&mode=all
and click on the search result "SudokuTrainer",
and from there download the distribution file, then unpack it:
On Linux: tar -xzf SudokuTrainer-<version>.tar.gz
On Windows: Use a ZIP archiver program (e. g. winZIP or 7-Zip) to unpack the
distribution file.
Finally enter the distribution directory:
cd SudokuTrainer-<version>.
3. Module::Build
----------------
Enter the following commands, depending on your platform:
Linux Windows
----- -------
perl Build.PL perl Build.PL
./Build Build
./Build test Build test
sudo ./Build install Build install
4. ExtUtils-MakeMaker
---------------------
This installation procedure is available since the first days of CPAN, and
it is still included in Perl installations. It uses the "make" utility.
However the name of this utility changes slightly depending on the platform.
e. g. on Windows the name is "dmake".
Enter the following commands, depending on your platform:
Linux Windows
----- -------
perl Makefile.PL perl Makefile.PL
make dmake
make test dmake test
sudo make install dmake install
ACKNOWLEDGEMENT
---------------
Big parts of the installation instructions have been taken from the tutorial
http://wiki.perl-community.de/Wissensbasis/ModuleWieInstalliereIchEinModul,
which was written by the German Perl forum www.perl-community.de.