From 0837b2e78a283d27a288ca3bfe49490f940a77b9 Mon Sep 17 00:00:00 2001 From: Russ Allbery Date: Thu, 20 Sep 2007 00:38:23 +0000 Subject: Update the documentation to get rid of the stupid error return from attr and instead tell the caller to call error() on an empty return to see if there was a problem. --- perl/Wallet/Object/Base.pm | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'perl') diff --git a/perl/Wallet/Object/Base.pm b/perl/Wallet/Object/Base.pm index b366d6e..fff06f4 100644 --- a/perl/Wallet/Object/Base.pm +++ b/perl/Wallet/Object/Base.pm @@ -646,8 +646,9 @@ be an attribute type known to the underlying object implementation. The default implementation of this method rejects all attributes as unknown. If no other arguments besides ATTRIBUTE are given, returns the values of -that attribute, if any, as a list. On error, returns a list containing one -undefined element. +that attribute, if any, as a list. On error, returns the empty list. To +distinguish between an error and an empty return, call error() afterwards. +It is guaranteed to return undef unless there was an error. If other arguments are given, sets the given ATTRIBUTE values to VALUES, which must be a reference to an array (even if only one value is being set). -- cgit v1.2.3