summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md16
1 files changed, 14 insertions, 2 deletions
diff --git a/README.md b/README.md
index 91ceea1..b703b6c 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,10 @@ Carton - Perl module dependency manager (aka Bundler for Perl)
> carton install
> carton exec starman -p 8080 myapp.psgi
+ # carton exec is optional
+ > perl -Ilocal/lib/perl5 local/bin/starman -p 8080 myapp.psgi
+ > PERL5LIB=/path/to/local/lib/perl5 /path/to/local/bin/starman -p 8080 myapp.psgi
+
# AVAILABILITY
Carton only works with perl installation with the complete set of core
@@ -24,8 +28,9 @@ modules. If you use perl installed by a vendor package with modules
stripped from core, Carton is not expected to work correctly.
Also, Carton requires you to run your command/application with
-`carton exec` command, which means it's difficult or impossible to
-run in an embedded perl use case such as mod\_perl.
+`carton exec` command or to include the _local/lib/perl5_ directory
+in your Perl library search path (using `PERL5LIB`, `-I`, or
+[lib](https://metacpan.org/pod/lib)).
# DESCRIPTION
@@ -126,6 +131,13 @@ will install modules using this local cache. Combined with
CPAN Meta DB or downloading files from CPAN mirrors upon deployment
time.
+As of Carton v1.0.32, the bundle also includes a package index
+allowing you to simply use [cpanm](https://metacpan.org/pod/cpanm) (which has a
+[standalone version](https://metacpan.org/pod/App::cpanminus#Downloading-the-standalone-executable))
+instead of installing Carton on a remote machine.
+
+ > cpanm -L local --from "$PWD/vendor/cache" --installdeps --notest --quiet .
+
# PERL VERSIONS
When you take a snapshot in one perl version and deploy on another