Documentation tweaks

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

Source/GSServicesManager.m

@@ -1319,7 +1319,7 @@ GSContactApplication(NSString *appName, NSString *port, NSDate *expire)
     }
   if (expire == nil)
     {
-      expire = [NSDate datyeWithTimeIntervalSinceNow: 30.0];
+      expire = [NSDate dateWithTimeIntervalSinceNow: 30.0];
     }
   if (providerName != nil && [port isEqual: providerName] == YES)
     {

Source/NSApplication.m

@@ -1600,14 +1600,14 @@ IF_NO_GC(NSAssert([event retainCount] > 0, NSInternalInconsistencyException));
 }
 
 /** 
-<p>
-Returns the target object that will respond to aSelector, if any. The
-method first checks if any of the key window's first responders, the
-key window or its delegate responds. Next it checks the main window in
-the same way. Finally it checks the receiver (NSApplication) and it's
-delegate.
-</p>
-*/
+ * <p>
+ *   Returns the target object that will respond to aSelector, if any. The
+ *   method first checks if any of the key window's first responders, the
+ *   key window or its delegate responds. Next it checks the main window in
+ *   the same way. Finally it checks the receiver (NSApplication) and it's
+ *   delegate.
+ * </p>
+ */
 - (id) targetForAction: (SEL)aSelector
 {
   NSWindow	*keyWindow;
@@ -2334,7 +2334,8 @@ image.
 /**
  * Sets the object which provides services to other applications.<br />
  * Passing a nil value for anObject will result in the provision of
- * services to other applications by this application being disabled.
+ * services to other applications by this application being disabled.<br />
+ * See [NSPasteboard] for information about providing services.
  */
 - (void) setServicesProvider: (id)anObject
 {
@@ -2432,11 +2433,62 @@ image.
     }
 }
 
+/**
+ * Returns the applications delegate, as set by the -setDelegate: method.<br />
+ * <p>The application delegate will automatically be sent various
+ * notifications (as long as it implements the appropriate methods)
+ * when application events occur.  The method to handle each of these
+ * notifications has name mirroring the notification name, so for instance
+ * an <em>NSApplicationDidBecomeActiveNotification</em> is handled by an
+ * <code>applicationDidBecomeActive:</code> method.
+ * </p> 
+ * <list>
+ *   <item>NSApplicationDidBecomeActiveNotification</item>
+ *   <item>NSApplicationDidFinishLaunchingNotification</item>
+ *   <item>NSApplicationDidHideNotification</item>
+ *   <item>NSApplicationDidResignActiveNotification</item>
+ *   <item>NSApplicationDidUnhideNotification</item>
+ *   <item>NSApplicationDidUpdateNotification</item>
+ *   <item>NSApplicationWillBecomeActiveNotification</item>
+ *   <item>NSApplicationWillFinishLaunchingNotification</item>
+ *   <item>NSApplicationWillHideNotification</item>
+ *   <item>NSApplicationWillResignActiveNotification</item>
+ *   <item>NSApplicationWillTerminateNotification</item>
+ *   <item>NSApplicationWillUnhideNotification</item>
+ *   <item>NSApplicationWillUpdateNotification</item>
+ * </list>
+ * <p>The delegate is also sent various messages to ask for authorisation
+ * to perform actions, or to ask it to perform actions (again, as long
+ * as it implements the appropriate methods).
+ * </p>
+ * <list>
+ *   <item>applicationShouldTerminateAfterLastWindowClosed:</item>
+ *   <item>applicationShouldOpenUntitledFile:</item>
+ *   <item>applicationOpenUntitledFile:</item>
+ *   <item>applicationShouldTerminate:</item>
+ * </list>
+ * <p>The delegate is also called upon to respond to any actions which
+ *   are not handled by a window, a window delgate, or by the application
+ *   object itsself..  This is controlled by the -targetForAction: method. 
+ * </p>
+ * <p>Finally, the application delegate is responsible for handling
+ *   messages sent to the application from remote processes (see the
+ *   section documenting distributed objects for [NSPasteboard]).
+ * </p>
+ */
 - (id) delegate
 {
   return _delegate;
 }
 
+/**
+ * Sets the delegate of the application to anObject.<br />
+ * <p><em>Beware</em>, this does not retain anObject, so you must be sure
+ * that, in the event of anObject being deallocated, you
+ * stop it being the application delagate by calling this
+ * method again with another object (or nil) as the argument.
+ * </p>
+ */
 - (void) setDelegate: (id)anObject
 {
   if (_delegate)

Source/NSPasteboard.m

@@ -176,7 +176,7 @@
       The services system provides a standardised mechanism for an application
       to provide services to other applications.  Like cut and paste, or
       drag and drop, the use of an application service is normally initiated
-      by the suer selecting some data to work with.  The user then goes to
+      by the user selecting some data to work with.  The user then goes to
       the services menu, and selects a service listed there.  The selection
       of a menu item causes the data to be placed on a pasteboard and
       transferred to the service providing application, where the action of
@@ -211,7 +211,11 @@
       When your application is installed in one of the standard locations,
       and the <em>make_services</em> tool is run to update the cache of
       services information, your service automatically becomes available
-      on the services menu of every application you run.
+      on the services menu of every application you run.<br />
+      At runtime, you use [NSApplication-setServicesProvider:] to specify
+      the object which implements the method to perform the service,
+      or, if you are providing the service from a process other than a
+      gui application, you use the NSRegisterServicesProvider() function.
     </p>
     <p>
       Your Info.plist should contain an array named <code>NSServices</code>
@@ -228,7 +232,7 @@
 	for these types, so the string "NSStringPboardType" would match
 	the use of the <code>NSStringPboardType</code> in your code.<br />
 	Similarly, the functions NSCreateFileContentsPboardType() and
-	NSCreateFilenamesPboardType() return types whose string values
+	NSCreateFilenamePboardType() return types whose string values
 	are found by appending the filename extension concerned to the
 	strings "NSTypedFileContentsPboardType:" and
 	"NSTypedFilenamesPboardType:" respectively.