From ee80a0ac3339dcb2f3577a3d04147a5cbf9a220a Mon Sep 17 00:00:00 2001
From: Sorin Ionescu <sorin.ionescu@gmail.com>
Date: Tue, 12 Jun 2012 19:39:45 -0400
Subject: [PATCH] [Fix #110] Add documentation for perl

---
 modules/perl/README.md | 69 ++++++++++++++++++++++++++++++++++++++++++
 modules/perl/init.zsh  | 10 ------
 2 files changed, 69 insertions(+), 10 deletions(-)
 create mode 100644 modules/perl/README.md

diff --git a/modules/perl/README.md b/modules/perl/README.md
new file mode 100644
index 0000000..a97039a
--- /dev/null
+++ b/modules/perl/README.md
@@ -0,0 +1,69 @@
+Perl
+====
+
+Enables local [Perl][1] module installation on Mac OS X and defines alises.
+
+Local Module Installation
+-------------------------
+
+Perl versions older than 5.14 do not support the local installation of Perl
+modules natively. This module allows for local installation of Perl modules on
+Mac OS X Lion in *~/Library/Perl/5.12* by altering the environment.
+
+### Usage
+
+For Perl versions older than 5.14, install *local::lib*.
+
+    curl -L -C - -O http://search.cpan.org/CPAN/authors/id/A/AP/APEIRON/local-lib-1.008004.tar.gz
+    tar xvf local-lib-1.008004.tar.gz
+    cd local-lib-1.008004
+    perl Makefile.PL --bootstrap=$HOME/Library/Perl/5.12
+    make && make test && make install
+
+Install *cpanminus*:
+
+    curl -L http://cpanmin.us | perl - --self-upgrade
+
+Perlbrew
+--------
+
+An alternative to the above is to use [Perlbrew][2], which allows for the
+management of multiple, isolated Perl installations in the home directory.
+
+Aliases
+-------
+
+### General
+
+  - `pe` executes a one line program in a loop (`perl -wlne`).
+  - `pd` looks up Perl documentation (`perldoc`).
+
+### Perlbrew
+
+  - `pb` manages Perl environments.
+  - `pba` lists available Perl versions.
+  - `pbi` installs a Perl version.
+  - `pbl` lists installed Perl versions.
+  - `pbo` temporarily turns off Perlbrew.
+  - `pbO` turns off Perlbrew.
+  - `pbs` switches to a Perl version.
+  - `pbu` uninstalls a Perl version.
+  - `pbx` temporarily sets the Perl version to use.
+
+Functions
+---------
+
+  - `prep` provides a grep-like pattern search.
+  - `psub` provides a sed-like pattern substitution.
+
+Authors
+-------
+
+*The authors of this module should be contacted via the [issue tracker][3].*
+
+  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+
+[1]: http://www.perl.org
+[2]: http://perlbrew.pl
+[3]: https://github.com/sorin-ionescu/oh-my-zsh/issues
+
diff --git a/modules/perl/init.zsh b/modules/perl/init.zsh
index ec709b4..c833bd8 100644
--- a/modules/perl/init.zsh
+++ b/modules/perl/init.zsh
@@ -5,16 +5,6 @@
 #   Sorin Ionescu <sorin.ionescu@gmail.com>
 #
 
-# For Perl older than 5.10.14, install local::lib.
-#   curl -L -C - -O http://search.cpan.org/CPAN/authors/id/A/AP/APEIRON/local-lib-1.008004.tar.gz
-#   tar xvf local-lib-1.008004.tar.gz
-#   cd local-lib-1.008004
-#   perl Makefile.PL --bootstrap=$HOME/Library/Perl/5.12
-#   make && make test && make install
-#
-# Install cpanminus:
-#   curl -L http://cpanmin.us | perl - --self-upgrade
-#
 if [[ "$OSTYPE" == darwin* ]]; then
   # Perl is slow; cache its output.
   cache_file="${0:h}/cache.zsh"