summaryrefslogtreecommitdiff
path: root/lib/Carton/Doc/Exec.pod
diff options
context:
space:
mode:
Diffstat (limited to 'lib/Carton/Doc/Exec.pod')
-rw-r--r--lib/Carton/Doc/Exec.pod19
1 files changed, 19 insertions, 0 deletions
diff --git a/lib/Carton/Doc/Exec.pod b/lib/Carton/Doc/Exec.pod
new file mode 100644
index 0000000..9eeca09
--- /dev/null
+++ b/lib/Carton/Doc/Exec.pod
@@ -0,0 +1,19 @@
+=head1 NAME
+
+Carton::Doc::Exec - execute your script in a carton local environment
+
+=head1 SYNOPSIS
+
+ carton exec perl myscript.pl
+
+=head1 DESCRIPTION
+
+This command allows you to run your script in an isolated carton local
+environment, which means the perl 5 library path C<@INC> are the only
+ones from perl's core library path, carton's library path
+(i.e. C<local/lib/perl5>) and the current directory.
+
+This is useful to make sure your scripts and application use the exact
+same versions of the modules in your library path, and are not using
+any of the modules you accidentally installed into your system perl or
+perlbrew's site library path.