.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Carp::Always 3pm"
.TH Carp::Always 3pm "2012-08-21" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Carp::Always \- Warns and dies noisily with stack backtraces
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  use Carp::Always;
.Ve
.PP
makes every \f(CW\*(C`warn()\*(C'\fR and \f(CW\*(C`die()\*(C'\fR complains loudly in the calling package 
and elsewhere. More often used on the command line:
.PP
.Vb 1
\&  perl \-MCarp::Always script.pl
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module is meant as a debugging aid. It can be 
used to make a script complain loudly with stack backtraces 
when \fIwarn()\fRing or \fIdie()\fRing.
.PP
Here are how stack backtraces produced by this module
looks:
.PP
.Vb 5
\&  # it works for explicit die\*(Aqs and warn\*(Aqs
\&  $ perl \-MCarp::Always \-e \*(Aqsub f { die "arghh" }; sub g { f }; g\*(Aq
\&  arghh at \-e line 1
\&          main::f() called at \-e line 1
\&          main::g() called at \-e line 1
\&
\&  # it works for interpreter\-thrown failures
\&  $ perl \-MCarp::Always \-w \-e \*(Aqsub f { $a = shift; @a = @$a };\*(Aq \e
\&                           \-e \*(Aqsub g { f(undef) }; g\*(Aq
\&  Use of uninitialized value in array dereference at \-e line 1
\&          main::f(\*(Aqundef\*(Aq) called at \-e line 2
\&          main::g() called at \-e line 2
.Ve
.PP
In the implementation, the \f(CW\*(C`Carp\*(C'\fR module does
the heavy work, through \f(CW\*(C`longmess()\*(C'\fR. The
actual implementation sets the signal hooks
\&\f(CW$SIG{_\|_WARN_\|_}\fR and \f(CW$SIG{_\|_DIE_\|_}\fR to
emit the stack backtraces.
.PP
Oh, by the way, \f(CW\*(C`carp\*(C'\fR and \f(CW\*(C`croak\*(C'\fR when requiring/using
the \f(CW\*(C`Carp\*(C'\fR module are also made verbose, behaving
like \f(CW\*(C`cluck\*(C'\fR and \f(CW\*(C`confess\*(C'\fR, respectively.
.SS "\s-1EXPORT\s0"
.IX Subsection "EXPORT"
Nothing at all is exported.
.SH "ACKNOWLEDGMENTS"
.IX Header "ACKNOWLEDGMENTS"
This module was born as a reaction to a release
of Acme::JavaTrace by Se\*'bastien Aperghis-Tramoni.
Se\*'bastien also has a newer module called
Devel::SimpleTrace with the same code and fewer flame
comments on docs. The pruning of the uselessly long
docs of this module were prodded by Michael Schwern.
.PP
Schwern and others told me \*(L"the module name stinked\*(R" \-
it was called \f(CW\*(C`Carp::Indeed\*(C'\fR. After thinking long
and not getting nowhere, I went with nuffin's suggestion
and now it is called \f(CW\*(C`Carp::Always\*(C'\fR. 
\&\f(CW\*(C`Carp::Indeed\*(C'\fR which is now deprecate
lives in its own distribution (which won't go anywhere
but will stay there as a redirection to this module).
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.IP "\(bu" 4
Carp
.IP "\(bu" 4
Acme::JavaTrace and Devel::SimpleTrace
.IP "\(bu" 4
Carp::Always::Color
.IP "\(bu" 4
Carp::Source::Always
.PP
Please report bugs via \s-1CPAN\s0 \s-1RT\s0 
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Carp\-Always.
.SH "BUGS"
.IX Header "BUGS"
Every (un)deserving module has its own pet bugs.
.IP "\(bu" 4
This module does not play well with other modules which fusses
around with \f(CW\*(C`warn\*(C'\fR, \f(CW\*(C`die\*(C'\fR, \f(CW$SIG{\*(Aq_\|_WARN_\|_\*(Aq}\fR,
\&\f(CW$SIG{\*(Aq_\|_DIE_\|_\*(Aq}\fR.
.IP "\(bu" 4
Test scripts are good. I should write more of these.
.IP "\(bu" 4
I don't know if this module name is still a bug as it was
at the time of \f(CW\*(C`Carp::Indeed\*(C'\fR.
.SH "AUTHOR"
.IX Header "AUTHOR"
Adriano Ferreira, <ferreira@cpan.org>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright (C) 2005\-2012 by Adriano R. Ferreira
.PP
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.