[SCM] WebKit Debian packaging branch, debian/unstable, updated. debian/1.1.15-1-40151-g37bb677

[mjs]

The following commit has been merged in the debian/unstable branch:
commit 550c900465ab94ca5c97919da14dfa9b8f4b19c0
Author: mjs <mjs at 268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Date:   Mon Sep 23 22:17:28 2002 +0000

            * Panels.subproj/WebStandardPanels.h: Added inline header docs.
    
    
    git-svn-id: http://svn.webkit.org/repository/webkit/trunk@2128 268f45cc-cd09-0410-ab3c-d52691b4dbfc

diff --git a/WebKit/ChangeLog b/WebKit/ChangeLog
index 2222a40..3826a12 100644
--- a/WebKit/ChangeLog
+++ b/WebKit/ChangeLog
@@ -1,5 +1,9 @@
 2002-09-23  Maciej Stachowiak  <mjs at apple.com>
 
+        * Panels.subproj/WebStandardPanels.h: Added inline header docs.
+
+2002-09-23  Maciej Stachowiak  <mjs at apple.com>
+
         * WebView.subproj/WebWindowContext.h: Added inline header docs.
 
 2002-09-23  Ken Kocienda  <kocienda at apple.com>
diff --git a/WebKit/ChangeLog-2002-12-03 b/WebKit/ChangeLog-2002-12-03
index 2222a40..3826a12 100644
--- a/WebKit/ChangeLog-2002-12-03
+++ b/WebKit/ChangeLog-2002-12-03
@@ -1,5 +1,9 @@
 2002-09-23  Maciej Stachowiak  <mjs at apple.com>
 
+        * Panels.subproj/WebStandardPanels.h: Added inline header docs.
+
+2002-09-23  Maciej Stachowiak  <mjs at apple.com>
+
         * WebView.subproj/WebWindowContext.h: Added inline header docs.
 
 2002-09-23  Ken Kocienda  <kocienda at apple.com>
diff --git a/WebKit/Panels.subproj/WebStandardPanels.h b/WebKit/Panels.subproj/WebStandardPanels.h
index e377f35..ff767ff 100644
--- a/WebKit/Panels.subproj/WebStandardPanels.h
+++ b/WebKit/Panels.subproj/WebStandardPanels.h
@@ -11,6 +11,9 @@
 
 /*!
     @class WebStandardPanels
+    @discussion This class allows the use of standard, WebKit-provided
+    panels for particular UI that requires panel interaction. The only
+    one available currently is authentication.
 */
 @interface WebStandardPanels : NSObject
 {
@@ -20,37 +23,53 @@
 
 /*!
     @method sharedStandardPanels
+    @abstract Get the shared singleton standard panels object
+    @result The shared standard panels instance
 */
 +(WebStandardPanels *)sharedStandardPanels;
 
 /*!
     @method setUseStandardAuthenticationPanel:
-    @param use
+    @abstract Request that the standard authentication panel be used or not used.
+    @param use YES if the standard authentication panel should be used, NO otherwise
 */
 -(void)setUseStandardAuthenticationPanel:(BOOL)use;
 
 /*!
     @method useStandardAuthenticationPanel
+    @abstract Determine whether the standard authentication panelwill  be used or not used.
+    @result YES if the standard authentication panel should be used, NO otherwise
 */
 -(BOOL)useStandardAuthenticationPanel;
 
 /*!
     @method didStartLoadingURL:inWindow:
-    @param URL
-    @param window
+    @abstract Notify the standard panel mechanism of the start of a resource load
+    @param URL The URL that is starting to load
+    @param window The window associated with the load.
+    @discussion This is only needed for resources that are not being
+    loaded via WebKit. WebKit takes care of this bookkeeping
+    automatically, for resources that it loads.
 */
 -(void)didStartLoadingURL:(NSURL *)URL inWindow:(NSWindow *)window;
 
 /*!
     @method didStopLoadingURL:inWindow:
-    @param URL
-    @param window
+    @abstract Notify the standard panel mechanism of the end of a resource load
+    @param URL The URL that finished loading
+    @param window The window associated with the load.
+    @discussion This is only needed for resources that are not being
+    loaded via WebKit. WebKit takes care of this bookkeeping
+    automatically, for resources that it loads.
 */
 -(void)didStopLoadingURL:(NSURL *)URL inWindow:(NSWindow *)window;
 
 /*!
     @method frontmostWindowLoadingURL:
-    @param URL
+    @abstract Get the frontmost window loading a URL
+    @param URL The URL in question
+    @discussion This may be useful for clients that want to implement their
+    own custom panels for special purposes.
 */
 -(NSWindow *)frontmostWindowLoadingURL:(NSURL *)URL;
 

-- 
WebKit Debian packaging