diff --git a/ChangeLog b/ChangeLog
index 2cc2f985e..7b59dcf63 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -4,6 +4,7 @@
 	* Source/NSFontManager.m: Improved documentation
 	* Source/NSFontPanel.m: Improved documentation
 	* Source/NSMatrix.m: Improved documentation
+	* Source/NSPanel.m: Improved documentation
 
 2005-12-04  Fabien VALLON  <fabien@sonappart.net>
 
diff --git a/Source/NSPanel.m b/Source/NSPanel.m
index 1358af45e..d53524f4e 100644
--- a/Source/NSPanel.m
+++ b/Source/NSPanel.m
@@ -89,14 +89,19 @@
     [super keyDown: theEvent];
 }
 
-/*
- * Determining the Panel's Behavior
+/**<p>Returns whether the NSPanel is a floating panel, e.g. the window level
+   is NSFloatingWindowLevel instead of NSNormalWindowLevel.</p>
+   <p>See Also:  -setFloatingPanel: </p>
  */
 - (BOOL) isFloatingPanel
 {
   return _isFloatingPanel;
 }
 
+/**<p>Sets whether the NSPanel is a floating panel, e.g. the window level
+   is NSFloatingWindowLevel instead of NSNormalWindowLevel.</p>
+   <p>See Also:  -isFloatingPanel [NSWindow-setLevel:]</p>
+ */
 - (void) setFloatingPanel: (BOOL)flag
 {
   if (_isFloatingPanel != flag)
@@ -113,21 +118,38 @@
     }
 }
 
+/**<p>Returns whether the NSPanel can receive events when another window/panel
+   runs modally.</p><p>See Also: -setWorksWhenModal:
+   [NSApplication-runModalSession:]</p>
+ */
 - (BOOL) worksWhenModal
 {
   return _worksWhenModal;
 }
 
+/**<p>Sets whether the NSPanel can receive events when another window/panel
+   runs modally.</p>See Also: -worksWhenModal [NSApplication-runModalSession:]
+ */
 - (void) setWorksWhenModal: (BOOL)flag
 {
   _worksWhenModal = flag;
 }
 
+/**<p>Returns whether if the NSPanel becomes key window only when a view
+   require to be the first responder.</p>
+   <p>See Also: -setBecomesKeyOnlyIfNeeded: [NSView-needsPanelToBecomeKey]
+   [NSWindow-sendEvent:]</p>
+ */
 - (BOOL) becomesKeyOnlyIfNeeded
 {
   return _becomesKeyOnlyIfNeeded;
 }
 
+/**<p>Sets whether if the NSPanel becomes key window only when a view
+   require to be the first responder.</p>
+   <p>See Also: -setBecomesKeyOnlyIfNeeded: [NSView-needsPanelToBecomeKey]
+   [NSWindow-sendEvent:]</p>
+ */
 - (void) setBecomesKeyOnlyIfNeeded: (BOOL)flag
 {
   _becomesKeyOnlyIfNeeded = flag;