Documentation tidyups

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

Source/GNUmakefile

@@ -368,6 +368,7 @@ DOCUMENT_NAME = Base
 
 Base_HEADER_FILES_DIR = $(HEADER_DIR)
 Base_AGSDOC_FILES = Base.gsdoc $(AUTOGSDOC_HEADERS)
+Base_DOC_INSTALL_DIR = Developer
 Base_AGSDOC_FLAGS = \
 	-HeaderDirectory ../Headers/Foundation \
 	-Declared Foundation \

Source/NSCalendarDate.m

@@ -89,8 +89,10 @@ absoluteGregorianDay(int day, int month, int year)
      + (year - 1)/400);   // ...plus prior years divisible by 400
 }
 
-/*
- * External - so NSDate can use it.
+/**
+ * Convert a broken out time specification into a time interval
+ * since the reference date.<br />
+ * External - so NSDate and others can use it.
  */
 NSTimeInterval
 GSTime(int day, int month, int year, int h, int m, int s, int mil)
@@ -116,6 +118,8 @@ GSTime(int day, int month, int year, int h, int m, int s, int mil)
 
 @end
 
+@class	NSGDate;
+
 @implementation NSCalendarDate
 
 + (void) initialize
@@ -127,9 +131,9 @@ GSTime(int day, int month, int year, int h, int m, int s, int mil)
     }
 }
 
-//
-// Getting an NSCalendar Date
-//
+/**
+ * Getting an NSCalendar Date
+ */
 + (id) calendarDate
 {
   id	d = [[self alloc] init];

Source/NSDate.m

@@ -71,6 +71,16 @@ static Class	abstractClass = nil;
 static Class	concreteClass = nil;
 static Class	calendarClass = nil;
 
+/**
+ * Our concrete base class - NSCalendar date must share the ivar layout.
+ */
+@interface NSGDate : NSDate
+{
+@public
+  NSTimeInterval _seconds_since_ref;
+}
+@end
+
 @interface	GSDateSingle : NSGDate
 @end
 
@@ -117,6 +127,9 @@ otherTime(NSDate* other)
     return [other timeIntervalSinceReferenceDate];
 }
 
+/**
+ * Returns the current time (seconds since reference date) as an NSTimeInterval.
+ */
 NSTimeInterval
 GSTimeNow()
 {