This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Re: [PATCH] Documentation patch for overload
authorSteffen Müller <0mgwtfbbq@sneakemail.com>
Mon, 6 Feb 2006 10:58:44 +0000 (11:58 +0100)
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>
Tue, 7 Feb 2006 14:37:15 +0000 (14:37 +0000)
Message-ID: <43E71DD4.5010108@sneakemail.com>

p4raw-id: //depot/perl@27120

lib/overload.pm

index 943d836..d511f2c 100644 (file)
@@ -672,8 +672,9 @@ value is a scalar and not a reference.
 
 Since some operations can be automatically generated from others, there is
 a minimal set of operations that need to be overloaded in order to have
-the complete set of overloaded operations at one's disposal. This minimal
-set is:
+the complete set of overloaded operations at one's disposal.
+Of course, the autogenerated operations may not do exactly what the user
+expects. See L<MAGIC AUTOGENERATION> above. The minimal set is:
 
     + - * / % ** << >> x
     <=> cmp
@@ -681,10 +682,8 @@ set is:
     atan2 cos sin exp log sqrt int
 
 Additionally, you need to define at least one of string, boolean or
-numeric conversions. The string conversion can also be used to
-emulate concatenation, so we'll assume string conversion is defined.
-It usually makes sense to explicitly overload all conversion
-operations.
+numeric conversions because any one can be used to emulate the others.
+The string conversion can also be used to emulate concatenation.
 
 =head1 Losing overloading