From: Rafael Garcia-Suarez <rgarciasuarez@gmail.com>
Date: Mon, 1 May 2006 20:25:17 +0000 (+0000)
Subject: Add a BUGS section to Fatal.pm, see bug #38790
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=a6fd7f3f0e271856b7ecf5cd1e2906924a6b206a;p=p5sagit%2Fp5-mst-13.2.git

Add a BUGS section to Fatal.pm, see bug #38790

p4raw-id: //depot/perl@28040
---

diff --git a/lib/Fatal.pm b/lib/Fatal.pm
index d135731..b939f0c 100644
--- a/lib/Fatal.pm
+++ b/lib/Fatal.pm
@@ -177,6 +177,12 @@ values are ignored.  For example
 	# not checked, so error raises an exception
 	close FH;
 
+=head1 BUGS
+
+You should not fatalize functions that are called in list context, because this
+module tests whether a function has failed by testing the boolean truth of its
+return value in scalar context.
+
 =head1 AUTHOR
 
 Lionel Cons (CERN).