X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=p5sagit%2FDevel-REPL.git;a=blobdiff_plain;f=INSTALL;h=00edb6df77adc6ca0f9d638c1a5ad90a2f8103b2;hp=a1dc193ceb950d8d8be017b27f389693b201574d;hb=refs%2Ftags%2Fv1.003027;hpb=6aa584927ce35a633ee66fd372f3a6c2c23aa447

diff --git a/INSTALL b/INSTALL
index a1dc193..00edb6d 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,14 +1,43 @@
-WHAT IS THIS?
+This is the Perl distribution Devel-REPL.
 
-This is Devel::REPL, an interactive Perl shell.
-Please see the README that comes with this distribution.
+Installing Devel-REPL is straightforward.
 
-HOW DO I INSTALL IT?
+## Installation with cpanm
 
-To install this module, cd to the directory that contains this README
-file and type the following:
+If you have cpanm, you only need one line:
 
-   perl Makefile.PL
-   make
-   make test
-   make install
+    % cpanm Devel::REPL
+
+If you are installing into a system-wide directory, you may need to pass the
+"-S" flag to cpanm, which uses sudo to install the module:
+
+    % cpanm -S Devel::REPL
+
+## Installing with the CPAN shell
+
+Alternatively, if your CPAN shell is set up, you should just be able to do:
+
+    % cpan Devel::REPL
+
+## Manual installation
+
+As a last resort, you can manually install it. Download the tarball, untar it,
+then build it:
+
+    % perl Makefile.PL
+    % make && make test
+
+Then install it:
+
+    % make install
+
+If you are installing into a system-wide directory, you may need to run:
+
+    % sudo make install
+
+## Documentation
+
+Devel-REPL documentation is available as POD.
+You can run perldoc from a shell to read the documentation:
+
+    % perldoc Devel::REPL