This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
SelfLoader: Version bump for CPAN sync
[perl5.git] / dist / Carp / README
1 NAME
2
3 Carp - alternative warn and die for modules
4
5 DESCRIPTION
6
7 The Carp routines are useful in your own modules because they act like
8 die() or warn(), but with a message which is more likely to be useful
9 to a user of your module.  In the case of cluck, confess, and longmess
10 that context is a summary of every call in the call-stack.  For a shorter
11 message you can use carp or croak which report the error as being from
12 where your module was called.  There is no guarantee that that is where
13 the error was, but it is a good educated guess.
14
15 You can also alter the way the output and logic of Carp works, by changing
16 some global variables in the Carp namespace.
17
18 INSTALLATION
19
20         perl Makefile.PL
21         make
22         make test
23         make install
24
25 AUTHOR
26
27 The Carp module first appeared in Larry Wall's perl 5.000 distribution.
28 Since then it has been modified by several of the perl 5 porters.
29 Andrew Main (Zefram) <zefram@fysh.org> divested Carp into an independent
30 distribution.
31
32 COPYRIGHT
33
34 Copyright (C) 1994-2013 Larry Wall
35
36 Copyright (C) 2011, 2012, 2013 Andrew Main (Zefram) <zefram@fysh.org>
37
38 LICENSE
39
40 This module is free software; you can redistribute it and/or modify it
41 under the same terms as Perl itself.