Add notes on differernt Perl versions

1 files changed, 18 insertions, 0 deletions

diff --git a/lib/Carton.pm b/lib/Carton.pm
index 7b274e5..65c8801 100644
--- a/lib/Carton.pm
+++ b/lib/Carton.pm
@@ -113,6 +113,24 @@ C<--deployment> option, you can avoid querying for a database like
 CPAN Meta DB or downloading files from CPAN mirrors upon deployment
 time.
 
+=head1 PERL VERSIONS
+
+When you take a snapshot in one perl version and deploy on another
+(different) version, you might have troubles with core modules.
+
+The simples solution, which might not work for everybody, is to use
+the same version of perl in the development and deployment.
+
+To enforce that, you're recommended to use L<plenv> and
+C<.perl-version> to lock perl versions in development.
+
+You can also specify the minimum perl required in C<cpanfile>:
+
+  requires 'perl', '5.16.3';
+
+and carton (and cpanm) will give you errors when deployed on hosts
+with perl lower than the specified version.
+
 =head1 COMMUNITY
 
 =over 4