Skip to content

Commit 58e9172

Browse files
committed
Add some cultural guidance
1 parent 2b3e34a commit 58e9172

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

doc/Type/X/AdHoc.pod

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,12 @@ You can obtain the original object with the C<payload> method.
2323
" and backtrace ",
2424
$!.backtrace;
2525
26+
Note that young code will often be prototyped using C<X::AdHoc> and
27+
then later be revised to use more specific subtypes of C<Exception>.
28+
As such it is usually best not to explicitly rely on receiving an
29+
C<X::AdHoc> -- in many cases using the string returned by the
30+
C<.message> method, which all C<Exception>s must have, is preferable.
31+
2632
=head1 Methods
2733
2834
=head2 method payload

0 commit comments

Comments
 (0)