This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Re: [PATCH] Documentation patch for overload
[perl5.git] / 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