Doc tidyups

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

Headers/gnustep/gui/NSApplication.h

@@ -1,4 +1,4 @@
-/* 
+/** 
    NSApplication.h
 
    The one and only application class
@@ -7,6 +7,11 @@
 
    Author:  Scott Christley <scottc@net-community.com>
    Date: 1996
+   Author: Felipe A. Rodriguez <far@ix.netcom.com>
+   Date: August 1998
+   Author: Richard Frith-Macdonald <richard@brainstorm.co.uk>
+   Date: December 1998
+
    
    This file is part of the GNUstep GUI Library.
 
@@ -24,6 +29,10 @@
    License along with this library; see the file COPYING.LIB.
    If not, write to the Free Software Foundation,
    59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+
+    AutogsdocSource: NSApplication.m
+    AutogsdocSource: GSServicesManager.m
+
 */ 
 
 #ifndef _GNUstep_H_NSApplication

Source/GSServicesManager.m

@@ -1217,6 +1217,15 @@ static NSString         *disabledName = @".GNUstepDisabled";
 @end /* GSServicesManager */
 
 
+/**
+ * <p>Establishes an NSConnection to the application listening at port
+ * (by convention usually the application name), launching appName 
+ * if necessary.  Returns the proxy to the remote application, or nil
+ * on failure.
+ * </p>
+ * The value of expire provides a timeout in case the application cannot
+ * be contacted promptly.
+ */
 id
 GSContactApplication(NSString *appName, NSString *port, NSDate *expire)
 {
@@ -1276,6 +1285,14 @@ GSContactApplication(NSString *appName, NSString *port, NSDate *expire)
   return app;
 }
 
+/**
+ * <p>Given the name of a serviceItem, and some data in a pasteboard
+ * this function sends the data to the service provider (launching
+ * another application if necessary) and retrieves the result of
+ * the service in the pastebaord.
+ * </p>
+ * Returns YES on success, NO otherwise.
+ */
 BOOL
 NSPerformService(NSString *serviceItem, NSPasteboard *pboard)
 {