.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.48)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'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 >0, 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.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "StackTrace::Auto 3"
.TH StackTrace::Auto 3 2026-10-25 "perl v5.44.0" "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 SYNOPSIS
.IX Header "SYNOPSIS"
First, include StackTrace::Auto in a Moose or Mooclass...
.PP
.Vb 4
\&  package Some::Class;
\&  # NOTE: Moo can also be used here instead of Moose
\&  use Moose;
\&  with \*(AqStackTrace::Auto\*(Aq;
.Ve
.PP
\&...then create an object of that class...
.PP
.Vb 1
\&  my $obj = Some::Class\->new;
.Ve
.PP
\&...and now you have a stack trace for the object\*(Aqs creation.
.PP
.Vb 1
\&  print $obj\->stack_trace\->as_string;
.Ve
.PP
This attribute will contain an object representing the stack at the point when
the error was generated and thrown.  It must be an object performing the
\&\f(CW\*(C`as_string\*(C'\fR method.
.PP
This attribute may be provided to use an alternate class for stack traces.  The
default is Devel::StackTrace.
.PP
In general, you will not need to think about this attribute.
.PP
This attribute is an arrayref of arguments to pass when building the stack
trace.  In general, you will not need to think about it.
.SH "POD ERRORS"
.IX Header "POD ERRORS"
Hey! \fBThe above document had some coding errors, which are explained below:\fR
.IP "Around line 26:" 4
.IX Item "Around line 26:"
Unknown directive: =attr
.IP "Around line 32:" 4
.IX Item "Around line 32:"
Unknown directive: =attr
.IP "Around line 73:" 4
.IX Item "Around line 73:"
Unknown directive: =attr