Documentation fixups

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

ChangeLog

@@ -1,3 +1,12 @@
+2002-08-29  Richard Frith-Macdonald <rfm@gnu.org>
+
+	* Source/GSDisplayServer.m:
+	* Source/NSApplication.m:
+	* Source/NSFont.m:
+	* Source/NSInterfaceStyle.m:
+	* Source/NSTableColumn.m:
+	Documentation fixups ... correct gsdoc markup etc.
+
 2002-08-28  Fred Kiefer <FredKiefer@gmx.de>
 
 	* Source/NSBezierPath.m

Source/GSDisplayServer.m

@@ -142,11 +142,13 @@ GSCurrentServer(void)
     be initialized. Typically these values are specific to the
     concrete implementation. The current set of attributes that can be
     used with GSDisplayServer is.
+   </p>
    <list>
-     <item>GSDisplayName</item>,
+     <item>GSDisplayName</item>
-     <item>GSDisplayNumber</item>,
+     <item>GSDisplayNumber</item>
-     <item>GSScreenNumber</item>,
+     <item>GSScreenNumber</item>
    </list>
+   <p>
    GSDisplayName is window server specific and shouldn't be used when
    creating a GSDisplayServer (although you can retrieve the value with
    the -attributes method). On X-Windows the value might be set to something

Source/NSApplication.m

@@ -1177,8 +1177,8 @@ variable. Before processing the event, it makes the session window key
 and orders the window front, so there is no need to do this
 separately. When finished, it returns the state of the session (i.e.
 whether it is still running or has been stopped, etc) 
-<p>
 </p>
+<p>
 See Also: -runModalForWindow:
 </p>
 */
@@ -1303,8 +1303,8 @@ See Also: -runModalForWindow:
 /**
 <p>
    Returns the window that is part of the current modal session, if any.
-<p>
 </p>
+<p>
 See -runModalForWindow:
 </p>
 */

Source/NSFont.m

@@ -66,6 +66,7 @@ static BOOL userFixedCacheNeedsRecomputing = NO;
   the class methods listed below for more information. These default
   fonts can be set using the user defaults system. The default
   font names available are:
+  </p>
   <list>
     <item>NSBoldFont                Helvetica-Bold</item>
     <item>NSControlContentFont      Helvetica</item>
@@ -79,7 +80,9 @@ static BOOL userFixedCacheNeedsRecomputing = NO;
     <item>NSUserFixedPitchFont      Courier</item>
     <item>NSUserFont                Helvetica</item>
   </list>
-  The defualt sizes are:
+  <p>
+  The default sizes are:
+  </p>
   <list>
     <item>NSBoldFontSize            (none)</item>
     <item>NSControlContentFontSize  (none)</item>
@@ -94,6 +97,7 @@ static BOOL userFixedCacheNeedsRecomputing = NO;
     <item>NSUserFixedPitchFontSize  (none)</item>
     <item>NSUserFontSize            (none)</item>
   </list>
+  <p>
   Font sizes list with (none) default to NSFontSize.
   </p>
 

Source/NSInterfaceStyle.m

@@ -76,18 +76,20 @@ typedef struct {
    <p>
    Styles can be set using the user defaults system. Currently available
    styles are 
+   </p>
    <list>
-     <item>NSNextStepInterfaceStyle</item>,
+     <item>NSNextStepInterfaceStyle</item>
-     <item>NSMacintoshInterfaceStyle</item>, 
+     <item>NSMacintoshInterfaceStyle</item> 
-     <item>NSWindows95InterfaceStyle</item>, 
+     <item>NSWindows95InterfaceStyle</item> 
-     <item>GSWindowMakerInterfaceStyle</item>. 
+     <item>GSWindowMakerInterfaceStyle</item>
    </list>
+   <p>
    You can set a default style
    for all UI elements using the <code>NSInterfaceStyleDefault</code> key:
+   </p>
    <example>
    defaults write NSGlobalDomain NSInterfaceStyleDefault GSWindowMakerInterfaceStyle 
    </example>
-   </p>
 */
 extern  NSInterfaceStyle
 NSInterfaceStyleForKey(NSString *key, NSResponder *responder)
@@ -99,7 +101,8 @@ NSInterfaceStyleForKey(NSString *key, NSResponder *responder)
    */
   if (responder)
     {
-      style = (NSInterfaceStyle)((accessToResponder)responder)->_interface_style;
+      style
+	= (NSInterfaceStyle)((accessToResponder)responder)->_interface_style;
       if (style != NSNoInterfaceStyle)
 	{
 	  return style;

Source/NSTableColumn.m

@@ -22,21 +22,9 @@
    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.
-*/
 
-#include <Foundation/NSNotification.h>
+ <chapter>
-#include <Foundation/NSValue.h>
+  <heading>Overview of NSTableColumn</heading>
-#include <AppKit/NSTableHeaderCell.h>
-#include <AppKit/NSTableColumn.h>
-#include <AppKit/NSTableView.h>
-
-/**
-  <unit>
-  <heading>Class Description</heading>
-
-  <p>
-  NSTableColumn objects represent columns in NSTableViews.  
-  </p>
   <section>
     <heading>The Column Identifier</heading>
     <p>
@@ -70,8 +58,20 @@
     of this header cell to the desired title.
     </p>
   </section>
-  </unit>
+ </chapter>
 */  
+
+#include <Foundation/NSNotification.h>
+#include <Foundation/NSValue.h>
+#include <AppKit/NSTableHeaderCell.h>
+#include <AppKit/NSTableColumn.h>
+#include <AppKit/NSTableView.h>
+
+/**
+  <p>
+  NSTableColumn objects represent columns in NSTableViews.  
+  </p>
+ */
 @implementation NSTableColumn
 
 /*