Install the VI Perl Toolkit on OS X: Difference between revisions
Install the VI Perl Toolkit on OS X (view source)
Revision as of 21:19, 27 February 2010
, 27 February 2010Adding how-to setup using MacPorts (more details will follow... )
mNo edit summary |
m (Adding how-to setup using MacPorts (more details will follow... )) |
||
| Line 1: | Line 1: | ||
== Installing the VI Perl Toolkit on OS X == | == Installing the VI Perl Toolkit on OS X == | ||
'' by Wil van Antwerpen '' | '' by Wil van Antwerpen '' | ||
Basically there are two ways in which you can get the VI Perl Toolkit working on OS X. | |||
One way is by using the CPAN functionality of Perl which is already installed on your Mac and the other way is by using Macports. | |||
I will first walk you through how-to this using the CPAN Network and then show you how to get it working using macports. | |||
You will only need to use one method in order to use the Toolkit. | |||
== Installing Developer Tools == | == Installing Developer Tools == | ||
The VI Perl Toolkit needs to get a few extra | The VI Perl Toolkit needs to get a few extra modules added to the current perl setup that is by default installed on Mac OS X. In order to get these modules we use CPAN or macPorts. | ||
Both have some prerequisites of their own. | |||
For starters your system must have "make" installed. | For starters your system must have "make" installed. | ||
| Line 33: | Line 39: | ||
== Installing missing perl dependencies == | == Installing missing perl dependencies == | ||
So now we need to setup CPAN unless you already have it working, | So now we need to setup CPAN or MacPorts unless you already have it working, in that case you can skip the installation part. | ||
== Is /usr/local setup? == | === CPAN: Is /usr/local setup? === | ||
By default cpan will try to install some documentation under the /usr/local folder, so this folder has to exist and it needs to have the correct ownership privileges setup. | By default cpan will try to install some documentation under the /usr/local folder, so this folder has to exist and it needs to have the correct ownership privileges setup. | ||
See if the folder already exists: | See if the folder already exists: | ||
| Line 59: | Line 65: | ||
drwxr-xr-x@ 12 topaz topaz 408B Feb 27 01:06 .. | drwxr-xr-x@ 12 topaz topaz 408B Feb 27 01:06 .. | ||
== | === CPAN: Configuration === | ||
With the developer tools setup now you have to configure CPAN. You can also use this step if you want to change your CPAN configuration. | With the developer tools setup now you have to configure CPAN. You can also use this step if you want to change your CPAN configuration. | ||
Configuring CPAN makes sure that the tools finds the necessary commands on your system (make et al). To do that, run: | Configuring CPAN makes sure that the tools finds the necessary commands on your system (make et al). To do that, run: | ||
| Line 80: | Line 86: | ||
The main things to select are country to download from and the site(s) which you want to use for the repositories. Just make the most logical selections here. | The main things to select are country to download from and the site(s) which you want to use for the repositories. Just make the most logical selections here. | ||
== Installing the VI Perl Toolkit dependencies == | === CPAN: Installing the VI Perl Toolkit dependencies === | ||
Now we'll get the missing dependencies by running them one by one. We could add all of these on a single line, but we want it to be easy to see if the install was successful so we are running them one by one. | Now we'll get the missing dependencies by running them one by one. We could add all of these on a single line, but we want it to be easy to see if the install was successful so we are running them one by one. | ||
| Line 100: | Line 106: | ||
cpan UUID | cpan UUID | ||
Which down here installed fine too, so now we can finally get back to installing the VI Perl Toolkit. | Which down here installed fine too, so now we can finally get back to installing the VI Perl Toolkit. | ||
=== Setting up MacPorts === | |||
Go to the [http://www.macports.org/install.php Macports install page] and download the .dmg file for your environment and run the installer. | |||
=== MacPorts: Installing the VI Perl Toolkit dependencies === | |||
== Install VI Perl Toolkit == | == Install VI Perl Toolkit == | ||
| Line 138: | Line 148: | ||
If you want to uninstall the Developer Tools, you need to run the command: | If you want to uninstall the Developer Tools, you need to run the command: | ||
/Developer/Library/uninstall-devtools --mode=all | /Developer/Library/uninstall-devtools --mode=all | ||
Be aware that you can then no longer use CPAN or Macports to extend your system! | |||
From CPAN you can remove an installed module by running a clean command. | From CPAN you can remove an installed module by running a clean command. | ||
| Line 143: | Line 155: | ||
cpan clean Class::MethodMaker | cpan clean Class::MethodMaker | ||
This is sometimes needed if a module gets stuck while trying to install it. | This is a troubleshoot step and sometimes needed if a module gets stuck while trying to install it. | ||
Again don't remove any module your install depends on. | |||
If CPAN still gives problems, then you can remove your local CPAN configuration and cache directory by running: | If CPAN still gives problems, then you can remove your local CPAN configuration and cache directory by running: | ||