Minor tidyups

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@14616 72102866-910b-0410-8b05-ffd578937521

Source/NSCalendarDate.m

@@ -1369,7 +1369,11 @@ static inline int getDigits(const char *from, char *to, int limit)
   return y;
 }
 
-// Providing Adjusted Dates
+/**
+ * This method exists solely for conformance to the OpenStep spec.
+ * Its use is deprecated ... it simply calls
+ * -dateByAddingYears:months:days:hours:minutes:seconds:
+ */
 - (NSCalendarDate*) addYear: (int)year
 		      month: (int)month
 			day: (int)day
@@ -1770,6 +1774,16 @@ static inline int getDigits(const char *from, char *to, int limit)
 
 @implementation NSCalendarDate (OPENSTEP)
 
+/**
+ * <p>Returns a calendar date formed by adding the specified offsets to the
+ * receiver.  The offsets are added in order, years, then months, then
+ * days, then hours then minutes then seconds, so if you add 1 month and
+ * forty days to 20th September, the result will be 9th November.
+ * </p>
+ * <p>This method understands leap years and tries to adjust for daylight
+ * savings time changes so that it preserves expected clock time.
+ * </p>
+ */
 - (NSCalendarDate*) dateByAddingYears: (int)years
 			       months: (int)months
 				 days: (int)days