summaryrefslogtreecommitdiffstats
path: root/upstream/mageia-cauldron/man3pm/autodie::skip.3pm
blob: 82fa03be7258cd742847f1f056fbab16283c153f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
.\" ========================================================================
.\"
.IX Title "autodie::skip 3pm"
.TH autodie::skip 3pm 2023-11-28 "perl v5.38.2" "Perl Programmers Reference Guide"
.\" 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
autodie::skip \- Skip a package when throwing autodie exceptions
.SH SYNPOSIS
.IX Header "SYNPOSIS"
.Vb 1
\&    use parent qw(autodie::skip);
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This dummy class exists to signal that the class inheriting it should
be skipped when reporting exceptions from autodie.  This is useful
for utility classes like Path::Tiny that wish to report the location
of where they were called on failure.
.PP
If your class has a better way of doing roles, then you should not
load this class and instead simply say that your class \fIDOES\fR
\&\f(CW\*(C`autodie::skip\*(C'\fR instead.
.SH AUTHOR
.IX Header "AUTHOR"
Copyright 2013, Paul Fenwick <pjf@cpan.org>
.SH LICENSE
.IX Header "LICENSE"
This module is free software. You may distribute it under the same
terms as Perl itself.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
autodie, autodie::exception