1Carton::Doc::Upgrading(U3s)er Contributed Perl DocumentatCiaornton::Doc::Upgrading(3)
2
3
4
6 Carton::Doc::Upgrading - Upgrading document
7
9 Carton adds, changes and deprecates some features between major
10 releases in backward incompatible ways. Here's the list of major
11 changes between versions. See "Changes" file for more details.
12
13 v0.9 to v1.0
14 • "carton exec -Ilib" is deprecated. You must pass the optional
15 include path to perl interpreter in the normal way, like:
16
17 carton exec perl -Ilib myscript
18
19 Or make your script to take its own "-I" option, like many command
20 line launcher does (i.e. plackup, prove)
21
22 carton exec plackup -Ilib myapp.psgi
23
24 • "carton.lock" is now "cpanfile.snapshot". Its name and file format
25 has been changed. There's no automatic migration, but you can do:
26
27 # run with Carton v0.9.64
28 > carton install
29
30 # upgrade to Carton v1.0
31 > cpanm Carton
32 > carton install
33 > git add cpanfile.snapshot
34 > git rm carton.lock
35
36 This process will most likely preserve modules in your local
37 library.
38
39 • cpanfile is now a requirement, and extracting requirements from
40 build files ("Makefile.PL", "Build.PL") is not supported.
41
42
43
44perl v5.36.0 2023-01-20 Carton::Doc::Upgrading(3)