Index: lib/DateTime/Duration.pm
===================================================================
RCS file: /cvsroot/perl-date-time/modules/DateTime.pm/lib/DateTime/Duration.pm,v
retrieving revision 1.50
diff -u -r1.50 Duration.pm
--- lib/DateTime/Duration.pm	2 Sep 2005 01:52:32 -0000	1.50
+++ lib/DateTime/Duration.pm	6 Jan 2006 17:58:14 -0000
@@ -356,8 +356,9 @@
   my $bigger  = $dur1 * 3;
 
   my $base_dt = DateTime->new( year => 2000 );
-  my @sorted =
-      sort { DateTime::Duration->compare( $a, $b, $base_dt ) } @durations;
+  my @sorted = sort {
+      DateTime::Duration->compare( $a, $b, $base_dt )
+  } @durations;
 
   # Human-readable accessors, always positive, but use
   # DateTime::Format::Duration instead
@@ -540,6 +541,10 @@
 =item * DateTime::Duration->compare( $duration1, $duration2, $base_datetime )
 
 This is a class method that can be used to compare or sort durations.
+As with all uses of C<sort>, C<compare()> returns 1 when the first duration
+is longer, -1 when the second duration is longer, and 0 when they are the
+same.
+
 Comparison is done by adding each duration to the specified
 C<DateTime.pm> object and comparing the resulting datetimes.  This is
 necessary because without a base, many durations are not comparable.