Image updates and doc.

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

ChangeLog

@@ -1,3 +1,20 @@
+2002-07-05  Adam Fedor  <fedor@gnu.org>
+
+	* Images/common_ArrowDown.tiff: Transparency fix.
+	* Images/common_ArrowDownH.tiff: Idem.
+	* Images/common_ArrowLeft.tiff: Idem.
+	* Images/common_ArrowLeftH.tiff: Idem.
+	* Images/common_ArrowRight.tiff: Idem.
+	* Images/common_ArrowRightH.tiff: Idem.
+	* Images/common_ArrowUp.tiff: Idem.
+	* Images/common_ArrowUpH.tiff: Idem. (From deek@d2dc.net.)
+
+	* Source/NSFont.h: Add documentation.
+	* Source/NSImage.m (-compositeToPoint:fromRect:operation:): Log
+	exception.
+	(-dissolveToPoint:fromRect:fraction:): Idem.
+	* Documentation/gsdoc/DefaultsSummary.gsdoc: Update.
+
 2002-07-04  Fred Kiefer <FredKiefer@gmx.de>
 
 	* Source/NSColor.m

Documentation/gsdoc/DefaultsSummary.gsdoc

@@ -184,12 +184,12 @@
 	  <term><em>System Colors</em></term>
 	  <desc>
           <p>
-          System colors may be set using the defaults system. System
-          colors are standard colors for drawing various GUI elements,
-          such as buttons, text, scroller, etc. The value is a
-          dictionary describing the color. The keys that can be
-          used for setting the system colors are described in the
-          documentation for NSColor.
+          System colors are standard colors for drawing various GUI elements,
+          such as buttons, text, scroller, etc. They can be set using
+	  the normal user defaults system. An NSColorList called
+	  "System"  is stored in the users's private color list
+	  directory. This color list can also be manipulated through the
+	  NSColorList class (typically through a preferences module).
           </p>
 	  </desc>
 	  <term><em>System Fonts</em></term>

Source/NSFont.m

@@ -50,6 +50,55 @@ static BOOL userFixedCacheNeedsRecomputing = NO;
 	     matrix: (const float*)fontMatrix;
 @end
 
+/**
+  <unit>
+  <heading>NSFont</heading>
+
+  <p>The NSFont class allows control of the fonts used for displaying
+  text anywhere on the screen. The primary methods for getting a
+  particular font are -fontWithName:matrix: and -fontWithName:size: which
+  take the name and size of a particular font and return the NSFont object
+  associated with that font. In addition there are several convenience
+  mathods which make it easier to get certain types of fonts. </p>
+  
+  <p>In particular, there are several methods to get the standard fonts
+  used by the Application to display text for a partiuclar purpose. See
+  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:
+  <list>
+    <item>NSBoldFont                Helvetica-Bold</item>
+    <item>NSControlContentFont      Helvetica</item>
+    <item>NSFont                    Helvetica (System Font)</item>
+    <item>NSLabelFont               Helvetica</item>
+    <item>NSMenuFont                Helvetica</item>
+    <item>NSMessageFont             Helvetica</item>
+    <item>NSPaletteFont             Helvetica-Bold</item>
+    <item>NSTitleBarFont            Helvetica-Bold</item>
+    <item>NSToolTipsFont            Helvetica</item>
+    <item>NSUserFixedPitchFont      Courier</item>
+    <item>NSUserFont                Helvetica</item>
+  </list>
+  The defualt sizes are:
+  <list>
+    <item>NSBoldFontSize            (none)</item>
+    <item>NSControlContentFontSize  (none)</item>
+    <item>NSFontSize                12 (System Font Size)</item>
+    <item>NSLabelFontSize           12</item>
+    <item>NSMenuFontSize            (none)</item>
+    <item>NSMessageFontSize         (none)</item>
+    <item>NSPaletteFontSize         (none)</item>
+    <item>NSSmallFontSize           9</item>
+    <item>NSTitleBarFontSize        (none)</item>
+    <item>NSToolTipsFontSize        (none)</item>
+    <item>NSUserFixedPitchFontSize  (none)</item>
+    <item>NSUserFontSize            (none)</item>
+  </list>
+  Font sizes list with (none) default to NSFontSize.
+  </p>
+
+  </unit> */
+  
 @implementation NSFont
 
 /* Class variables*/

Source/NSImage.m

@@ -699,6 +699,8 @@ repd_for_rep(NSArray *_reps, NSImageRep *rep)
     }
   NS_HANDLER
     {
+      NSLog(@"NSImage: composite failed due to %@: %@", 
+	    [exception name], [exception reason]);
       if ([_delegate respondsToSelector: @selector(imageDidNotDraw:inRect:)])
         {
 	  NSImage *image = [_delegate imageDidNotDraw: self inRect: aRect];
@@ -778,6 +780,8 @@ repd_for_rep(NSArray *_reps, NSImageRep *rep)
     }
   NS_HANDLER
     {
+      NSLog(@"NSImage: dissolve failed due to %@: %@", 
+	    [exception name], [exception reason]);
       if ([_delegate respondsToSelector: @selector(imageDidNotDraw:inRect:)])
         {
 	  NSImage *image = [_delegate imageDidNotDraw: self inRect: aRect];