From e028f938706f61d909aff8000366fa9a7ad445fe Mon Sep 17 00:00:00 2001 From: "valeski%netscape.com" Date: Sat, 24 Mar 2001 00:22:18 +0000 Subject: [PATCH] r=rpotts. comment changes only. 48726. adding status to idl files of api rev. ifaces. git-svn-id: svn://10.0.0.236/trunk@90298 18797224-902f-48f8-a5cc-f745e15eee43 --- mozilla/content/base/public/nsISelection.idl | 4 ++++ mozilla/docshell/base/nsIGlobalHistory.idl | 10 ++++++---- mozilla/docshell/base/nsIWebNavigation.idl | 2 ++ .../browser/webBrowser/nsICommandHandler.idl | 4 ++++ .../browser/webBrowser/nsIContextMenuListener.idl | 2 ++ .../browser/webBrowser/nsIWebBrowser.idl | 2 ++ .../browser/webBrowser/nsIWebBrowserChrome.idl | 2 ++ .../browser/webBrowser/nsIWebBrowserFocus.idl | 2 ++ .../browser/webBrowser/nsIWebBrowserPersist.idl | 4 ++++ .../browser/webBrowser/nsIWebBrowserSetup.idl | 2 ++ .../webBrowser/nsIWebBrowserSiteWindow.idl | 2 ++ mozilla/gfx/idl/nsIPrintOptions.idl | 2 ++ mozilla/gfx/idl/nsIPrintSettings.idl | 2 ++ mozilla/modules/libpref/public/nsIPref.idl | 4 ++++ mozilla/netwerk/base/public/nsILoadGroup.idl | 2 ++ mozilla/netwerk/base/public/nsIPrompt.idl | 4 ++++ mozilla/netwerk/base/public/nsIRequest.idl | 4 ++++ mozilla/netwerk/base/public/nsIStreamObserver.idl | 6 ++++++ mozilla/netwerk/base/public/nsIURI.idl | 2 ++ mozilla/netwerk/base/public/nsIURL.idl | 2 ++ .../protocol/http/public/nsIHTTPHeader.idl | 4 ++++ mozilla/profile/public/nsIProfile.idl | 8 +++++++- mozilla/uriloader/base/nsIURIContentListener.idl | 15 +++++++++------ mozilla/uriloader/base/nsIWebProgress.idl | 2 ++ mozilla/uriloader/base/nsIWebProgressListener.idl | 2 ++ mozilla/webshell/public/nsIClipboardCommands.idl | 4 ++++ mozilla/xpcom/base/nsIWeakReference.idl | 2 ++ mozilla/xpcom/ds/nsIEnumerator.idl | 7 +++++++ mozilla/xpcom/io/nsIDirectoryService.idl | 5 +++++ mozilla/xpcom/io/nsIFile.idl | 10 +++++++--- mozilla/xpcom/io/nsILocalFile.idl | 4 ++++ .../history/public/nsIGlobalHistory.idl | 10 ++++++---- .../ucth/public/nsIHelperAppLauncherDialog.idl | 14 +++++++++----- 33 files changed, 128 insertions(+), 23 deletions(-) diff --git a/mozilla/content/base/public/nsISelection.idl b/mozilla/content/base/public/nsISelection.idl index 9eddaf97fec..365161fd7c8 100644 --- a/mozilla/content/base/public/nsISelection.idl +++ b/mozilla/content/base/public/nsISelection.idl @@ -33,7 +33,11 @@ class nsIDOMRange; /** * Interface for manipulating and querying the current selected range * of nodes within the document. + * + * @status FROZEN + * @version 1.0 */ + [scriptable, uuid(B2C7ED59-8634-4352-9E37-5484C8B6E4E1)] interface nsISelection : nsISupports { diff --git a/mozilla/docshell/base/nsIGlobalHistory.idl b/mozilla/docshell/base/nsIGlobalHistory.idl index 47f1bae3a10..3ebcc59213b 100644 --- a/mozilla/docshell/base/nsIGlobalHistory.idl +++ b/mozilla/docshell/base/nsIGlobalHistory.idl @@ -20,10 +20,12 @@ * Contributor(s): */ -/* - - The interface to global history. - +/** + * + * The interface to global history. + * + * @status FROZEN + * @version 1.0 */ #include "nsISupports.idl" diff --git a/mozilla/docshell/base/nsIWebNavigation.idl b/mozilla/docshell/base/nsIWebNavigation.idl index 826e236b069..aa58e5de309 100644 --- a/mozilla/docshell/base/nsIWebNavigation.idl +++ b/mozilla/docshell/base/nsIWebNavigation.idl @@ -28,6 +28,8 @@ * It provides methods and attributes to direct an object to navigate to a new * location, stop or restart an in process load or determine where the object, * has previously gone. + * + * @status UNDER_REVIEW */ interface nsISHistory; diff --git a/mozilla/embedding/browser/webBrowser/nsICommandHandler.idl b/mozilla/embedding/browser/webBrowser/nsICommandHandler.idl index 7281b4238b9..31e4f16a6f9 100644 --- a/mozilla/embedding/browser/webBrowser/nsICommandHandler.idl +++ b/mozilla/embedding/browser/webBrowser/nsICommandHandler.idl @@ -24,6 +24,10 @@ #include "nsISupports.idl" #include "domstubs.idl" +/** + * @status UNDER_REVIEW + */ + [scriptable, uuid(731C6C50-67D6-11d4-9529-0020183BF181)] interface nsICommandHandlerInit : nsISupports { diff --git a/mozilla/embedding/browser/webBrowser/nsIContextMenuListener.idl b/mozilla/embedding/browser/webBrowser/nsIContextMenuListener.idl index 35b9f405df9..5c9ab28dda5 100644 --- a/mozilla/embedding/browser/webBrowser/nsIContextMenuListener.idl +++ b/mozilla/embedding/browser/webBrowser/nsIContextMenuListener.idl @@ -31,6 +31,8 @@ interface nsIDOMNode; /** * The nsIContextMenuListener interface is called on embedding clients when * a context menu should be displayed. + * + * @status UNDER_REVIEW */ [uuid(3478b6b0-3875-11d4-94ef-0020183bf181)] diff --git a/mozilla/embedding/browser/webBrowser/nsIWebBrowser.idl b/mozilla/embedding/browser/webBrowser/nsIWebBrowser.idl index df7fa45bd8f..7038049a78b 100644 --- a/mozilla/embedding/browser/webBrowser/nsIWebBrowser.idl +++ b/mozilla/embedding/browser/webBrowser/nsIWebBrowser.idl @@ -30,6 +30,8 @@ interface nsIWeakReference; /** * The nsIWebBrowser + * + * @status UNDER_REVIEW */ [scriptable, uuid(69E5DF00-7B8B-11d3-AF61-00A024FFC08C)] diff --git a/mozilla/embedding/browser/webBrowser/nsIWebBrowserChrome.idl b/mozilla/embedding/browser/webBrowser/nsIWebBrowserChrome.idl index 6a39d1f07ad..72920227cdc 100644 --- a/mozilla/embedding/browser/webBrowser/nsIWebBrowserChrome.idl +++ b/mozilla/embedding/browser/webBrowser/nsIWebBrowserChrome.idl @@ -27,6 +27,8 @@ interface nsIDocShellTreeItem; /** * The nsIWebBrowserChrome + * + * @status UNDER_REVIEW */ [scriptable, uuid(BA434C60-9D52-11d3-AFB0-00A024FFC08C)] diff --git a/mozilla/embedding/browser/webBrowser/nsIWebBrowserFocus.idl b/mozilla/embedding/browser/webBrowser/nsIWebBrowserFocus.idl index 4149a0e4dd3..fc08815d447 100644 --- a/mozilla/embedding/browser/webBrowser/nsIWebBrowserFocus.idl +++ b/mozilla/embedding/browser/webBrowser/nsIWebBrowserFocus.idl @@ -33,6 +33,8 @@ interface nsIDOMElement; * embedding application's top level window is disabled, deactivate() must * be called, and activate() called again when the top level window is * reactivated for the browser's focus memory to work correctly. + * + * @status UNDER_REVIEW */ [scriptable, uuid(9c5d3c58-1dd1-11b2-a1c9-f3699284657a)] diff --git a/mozilla/embedding/browser/webBrowser/nsIWebBrowserPersist.idl b/mozilla/embedding/browser/webBrowser/nsIWebBrowserPersist.idl index aeb78d3504d..9fcd917a94b 100644 --- a/mozilla/embedding/browser/webBrowser/nsIWebBrowserPersist.idl +++ b/mozilla/embedding/browser/webBrowser/nsIWebBrowserPersist.idl @@ -26,6 +26,10 @@ interface nsIURI; interface nsIInputStream; interface nsIDOMDocument; +/** + * @status UNDER_REVIEW + */ + [scriptable, uuid(F823C5B0-AF6C-11d4-9597-0020183BF181)] interface nsIWebBrowserPersistProgress : nsISupports { diff --git a/mozilla/embedding/browser/webBrowser/nsIWebBrowserSetup.idl b/mozilla/embedding/browser/webBrowser/nsIWebBrowserSetup.idl index adf678473e8..27ac48f1d9d 100644 --- a/mozilla/embedding/browser/webBrowser/nsIWebBrowserSetup.idl +++ b/mozilla/embedding/browser/webBrowser/nsIWebBrowserSetup.idl @@ -25,6 +25,8 @@ /** * The nsIWebBrowserSetup + * + * @status UNDER_REVIEW */ [scriptable, uuid(F15398A0-8018-11d3-AF70-00A024FFC08C)] diff --git a/mozilla/embedding/browser/webBrowser/nsIWebBrowserSiteWindow.idl b/mozilla/embedding/browser/webBrowser/nsIWebBrowserSiteWindow.idl index 5df0d1efeec..81dedb575a4 100644 --- a/mozilla/embedding/browser/webBrowser/nsIWebBrowserSiteWindow.idl +++ b/mozilla/embedding/browser/webBrowser/nsIWebBrowserSiteWindow.idl @@ -26,6 +26,8 @@ * The nsIWebBrowserSiteWindow is implemented by the embedder on the chrome * object to provide the web browser with the means to resize the host window, * and to the query for some of its properties. + * + * @status UNDER_REVIEW */ [scriptable, uuid(3E5432CD-9568-4bd1-8CBE-D50ABA110743)] diff --git a/mozilla/gfx/idl/nsIPrintOptions.idl b/mozilla/gfx/idl/nsIPrintOptions.idl index b9f042f5314..a9142f3276b 100644 --- a/mozilla/gfx/idl/nsIPrintOptions.idl +++ b/mozilla/gfx/idl/nsIPrintOptions.idl @@ -37,6 +37,8 @@ /** * Simplified graphics interface for JS rendering. + * + * @status UNDER_REVIEW */ [scriptable, uuid(CAE87E20-479E-11d4-A856-00105A183419)] diff --git a/mozilla/gfx/idl/nsIPrintSettings.idl b/mozilla/gfx/idl/nsIPrintSettings.idl index ced99f508f9..475f4a2a349 100644 --- a/mozilla/gfx/idl/nsIPrintSettings.idl +++ b/mozilla/gfx/idl/nsIPrintSettings.idl @@ -37,6 +37,8 @@ /** * Simplified graphics interface for JS rendering. + * + * @status UNDER_REVIEW */ [scriptable, uuid(83427530-F790-11d4-A869-00105A183419)] diff --git a/mozilla/modules/libpref/public/nsIPref.idl b/mozilla/modules/libpref/public/nsIPref.idl index 74758cbbb52..d0f219214bc 100644 --- a/mozilla/modules/libpref/public/nsIPref.idl +++ b/mozilla/modules/libpref/public/nsIPref.idl @@ -24,6 +24,10 @@ #include "nsILocalFile.idl" #include "nsIObserver.idl" +/** + * @status UNDER_REVIEW + */ + %{C++ diff --git a/mozilla/netwerk/base/public/nsILoadGroup.idl b/mozilla/netwerk/base/public/nsILoadGroup.idl index 0e4d69125a1..3e6249ca9b7 100644 --- a/mozilla/netwerk/base/public/nsILoadGroup.idl +++ b/mozilla/netwerk/base/public/nsILoadGroup.idl @@ -38,6 +38,8 @@ interface nsILoadGroupListenerFactory : nsISupports /** * A load group maintains a collection of active URL requests. + * + * @status UNDER_REVIEW */ [scriptable, uuid(19845248-29ab-11d3-8cce-0060b0fc14a3)] interface nsILoadGroup : nsIRequest diff --git a/mozilla/netwerk/base/public/nsIPrompt.idl b/mozilla/netwerk/base/public/nsIPrompt.idl index 5f92531f749..23204578771 100644 --- a/mozilla/netwerk/base/public/nsIPrompt.idl +++ b/mozilla/netwerk/base/public/nsIPrompt.idl @@ -20,6 +20,10 @@ * Contributor(s): */ +/** + * @status UNDER_REVIEW + */ + #include "nsISupports.idl" [scriptable, uuid(a63f70c0-148b-11d3-9333-00104ba0fd40)] diff --git a/mozilla/netwerk/base/public/nsIRequest.idl b/mozilla/netwerk/base/public/nsIRequest.idl index 5aa5d2a0069..4b29b2a1bb0 100644 --- a/mozilla/netwerk/base/public/nsIRequest.idl +++ b/mozilla/netwerk/base/public/nsIRequest.idl @@ -22,6 +22,10 @@ #include "nsISupports.idl" +/** + * @status UNDER_REVIEW + */ + [scriptable, uuid(F2CAABA0-2F25-11d3-A164-0050041CAF44)] interface nsIRequest : nsISupports { diff --git a/mozilla/netwerk/base/public/nsIStreamObserver.idl b/mozilla/netwerk/base/public/nsIStreamObserver.idl index 0edb6a86b5e..963ae0a2f16 100644 --- a/mozilla/netwerk/base/public/nsIStreamObserver.idl +++ b/mozilla/netwerk/base/public/nsIStreamObserver.idl @@ -25,6 +25,12 @@ interface nsIRequest; interface nsIEventQueue; +/** + * nsIStreamObserver + * + * @status UNDER_REVIEW + */ + [scriptable, uuid(fd91e2e0-1481-11d3-9333-00104ba0fd40)] interface nsIStreamObserver : nsISupports { diff --git a/mozilla/netwerk/base/public/nsIURI.idl b/mozilla/netwerk/base/public/nsIURI.idl index 0c48dea6871..3aa88cf38bf 100644 --- a/mozilla/netwerk/base/public/nsIURI.idl +++ b/mozilla/netwerk/base/public/nsIURI.idl @@ -52,6 +52,8 @@ * stream to a URI as a source/destination, as well as providing additional * accessors to destructure the path, query and reference portions typically * associated with URLs. + * + * @status UNDER_REVIEW */ %{C++ diff --git a/mozilla/netwerk/base/public/nsIURL.idl b/mozilla/netwerk/base/public/nsIURL.idl index 72dd1fd5f09..239bb66aaab 100644 --- a/mozilla/netwerk/base/public/nsIURL.idl +++ b/mozilla/netwerk/base/public/nsIURL.idl @@ -38,6 +38,8 @@ * ---------------------------- * | * filePath + * + * @status UNDER_REVIEW */ [scriptable, uuid(d6116970-8034-11d3-9399-00104ba0fd40)] interface nsIURL : nsIURI diff --git a/mozilla/netwerk/protocol/http/public/nsIHTTPHeader.idl b/mozilla/netwerk/protocol/http/public/nsIHTTPHeader.idl index dfa72d80e8e..9aedaad9607 100644 --- a/mozilla/netwerk/protocol/http/public/nsIHTTPHeader.idl +++ b/mozilla/netwerk/protocol/http/public/nsIHTTPHeader.idl @@ -25,6 +25,10 @@ #include "nsISupports.idl" interface nsIAtom; + +/** + * @status UNDER_REVIEW + */ [scriptable, uuid(a3ec67f0-465a-11d3-9a89-0080c7cb1080)] interface nsIHTTPHeader : nsISupports diff --git a/mozilla/profile/public/nsIProfile.idl b/mozilla/profile/public/nsIProfile.idl index da5e6676a99..2ebac1b3dc9 100644 --- a/mozilla/profile/public/nsIProfile.idl +++ b/mozilla/profile/public/nsIProfile.idl @@ -23,7 +23,6 @@ #include "nsISupports.idl" #include "nsIFile.idl" - %{C++ #define NS_PROFILE_CID \ @@ -41,6 +40,13 @@ "profile-startup-category" %} +/** + * nsIProfile + * + * @status FROZEN + * @version 1.0 + */ + [scriptable, uuid(02b0625a-e7f3-11d2-9f5a-006008a6efe9)] interface nsIProfile : nsISupports { diff --git a/mozilla/uriloader/base/nsIURIContentListener.idl b/mozilla/uriloader/base/nsIURIContentListener.idl index 24ce82a97f3..fa28c8aaece 100644 --- a/mozilla/uriloader/base/nsIURIContentListener.idl +++ b/mozilla/uriloader/base/nsIURIContentListener.idl @@ -20,12 +20,15 @@ * Contributor(s): */ -/* nsIURIContentListener is an interface used by classes which - want to know (and have a chance to handle) a particular content type. - Typical useage scenarios will include running applications which register - a nsIURIContentListener for each of its content windows with the uri dispatcher - service. -*/ +/** + * nsIURIContentListener is an interface used by classes which + * want to know (and have a chance to handle) a particular content type. + * Typical useage scenarios will include running applications which register + * a nsIURIContentListener for each of its content windows with the uri dispatcher + * service. + * + * @status UNDER_REVIEW + */ #include "nsISupports.idl" #include "nsIURILoader.idl" diff --git a/mozilla/uriloader/base/nsIWebProgress.idl b/mozilla/uriloader/base/nsIWebProgress.idl index 7182508f0bb..910033fe1b8 100644 --- a/mozilla/uriloader/base/nsIWebProgress.idl +++ b/mozilla/uriloader/base/nsIWebProgress.idl @@ -28,6 +28,8 @@ interface nsIWebProgressListener; /** * The nsIWebProgress interface is used to look at the progress of document * loading in a particular DOM Window. + * + * @status UNDER_REVIEW */ [scriptable, uuid(570F39D0-EFD0-11d3-B093-00A024FFC08C)] diff --git a/mozilla/uriloader/base/nsIWebProgressListener.idl b/mozilla/uriloader/base/nsIWebProgressListener.idl index a3b80cc92a4..3d067384091 100644 --- a/mozilla/uriloader/base/nsIWebProgressListener.idl +++ b/mozilla/uriloader/base/nsIWebProgressListener.idl @@ -25,6 +25,8 @@ /** * The nsIWebProgressListener interface is implemented by clients wishing to * listen in on the progress associated with the loading of documents. + * + * @status UNDER_REVIEW */ interface nsIRequest; diff --git a/mozilla/webshell/public/nsIClipboardCommands.idl b/mozilla/webshell/public/nsIClipboardCommands.idl index fa322960a99..7f802e25d03 100644 --- a/mozilla/webshell/public/nsIClipboardCommands.idl +++ b/mozilla/webshell/public/nsIClipboardCommands.idl @@ -21,6 +21,10 @@ #include "nsISupports.idl" +/** + * @status UNDER_REVIEW + */ + [scriptable, uuid(b8100c90-73be-11d2-92a5-00105a1b0d64)] interface nsIClipboardCommands : nsISupports { /** diff --git a/mozilla/xpcom/base/nsIWeakReference.idl b/mozilla/xpcom/base/nsIWeakReference.idl index 7126ebb8f30..335133be64d 100644 --- a/mozilla/xpcom/base/nsIWeakReference.idl +++ b/mozilla/xpcom/base/nsIWeakReference.idl @@ -35,6 +35,8 @@ * (hopefully short-lived) owning reference on demand, through which clients * can get useful access to the referent, while it still exists. * + * @status FROZEN + * @version 1.0 * @see nsISupportsWeakReference * @see nsWeakReference * @see nsWeakPtr diff --git a/mozilla/xpcom/ds/nsIEnumerator.idl b/mozilla/xpcom/ds/nsIEnumerator.idl index e3cdd90212d..3643c6591db 100644 --- a/mozilla/xpcom/ds/nsIEnumerator.idl +++ b/mozilla/xpcom/ds/nsIEnumerator.idl @@ -26,6 +26,13 @@ #define NS_ENUMERATOR_FALSE 1 %} +/** + * nsISimpleEnumerator + * + * @status FROZEN + * @version 1.0 + */ + [scriptable, uuid(D1899240-F9D2-11D2-BDD6-000064657374)] interface nsISimpleEnumerator : nsISupports { boolean hasMoreElements(); diff --git a/mozilla/xpcom/io/nsIDirectoryService.idl b/mozilla/xpcom/io/nsIDirectoryService.idl index 45fe8dfa3f4..f77c957a69a 100644 --- a/mozilla/xpcom/io/nsIDirectoryService.idl +++ b/mozilla/xpcom/io/nsIDirectoryService.idl @@ -23,6 +23,11 @@ #include "nsISupports.idl" #include "nsIFile.idl" +/** + * @status FROZEN + * @version 1.0 + */ + [scriptable, uuid(bbf8cab0-d43a-11d3-8cc2-00609792278c)] interface nsIDirectoryServiceProvider: nsISupports { diff --git a/mozilla/xpcom/io/nsIFile.idl b/mozilla/xpcom/io/nsIFile.idl index bf5a130fdcb..06fcc2b6733 100644 --- a/mozilla/xpcom/io/nsIFile.idl +++ b/mozilla/xpcom/io/nsIFile.idl @@ -24,9 +24,13 @@ */ -// This is the only correct cross-platform way to specify a file. -// Strings are not such a way. If you grew up on windows or unix, you -// may think they are. Welcome to reality. +/** + * This is the only correct cross-platform way to specify a file. + * Strings are not such a way. If you grew up on windows or unix, you + * may think they are. Welcome to reality. + * + * @status UNDER_REVIEW + */ #include "nsISupports.idl" interface nsISimpleEnumerator; diff --git a/mozilla/xpcom/io/nsILocalFile.idl b/mozilla/xpcom/io/nsILocalFile.idl index f353a5abb4d..bf33ef3e88b 100644 --- a/mozilla/xpcom/io/nsILocalFile.idl +++ b/mozilla/xpcom/io/nsILocalFile.idl @@ -25,6 +25,10 @@ #include "nsIFile.idl" +/** + * @status UNDER_REVIEW + */ + %{C++ #include "prio.h" #include "prlink.h" diff --git a/mozilla/xpfe/components/history/public/nsIGlobalHistory.idl b/mozilla/xpfe/components/history/public/nsIGlobalHistory.idl index 47f1bae3a10..3ebcc59213b 100644 --- a/mozilla/xpfe/components/history/public/nsIGlobalHistory.idl +++ b/mozilla/xpfe/components/history/public/nsIGlobalHistory.idl @@ -20,10 +20,12 @@ * Contributor(s): */ -/* - - The interface to global history. - +/** + * + * The interface to global history. + * + * @status FROZEN + * @version 1.0 */ #include "nsISupports.idl" diff --git a/mozilla/xpfe/components/ucth/public/nsIHelperAppLauncherDialog.idl b/mozilla/xpfe/components/ucth/public/nsIHelperAppLauncherDialog.idl index e10b963a905..12c058ac882 100644 --- a/mozilla/xpfe/components/ucth/public/nsIHelperAppLauncherDialog.idl +++ b/mozilla/xpfe/components/ucth/public/nsIHelperAppLauncherDialog.idl @@ -26,11 +26,15 @@ interface nsIHelperAppLauncher; interface nsILocalFile; -// nsIHelperAppLauncherDialog -// ========================== -// This service is used to display a confirmatino dialog before -// launching a "helper app" to handle content not handled by -// Mozilla. +/** + * nsIHelperAppLauncherDialog + * ========================== + * This service is used to display a confirmatino dialog before + * launching a "helper app" to handle content not handled by + * Mozilla. + * + * @status UNDER_REVIEW + */ [scriptable, uuid(d7ebddf0-4c84-11d4-807a-00600811a9c3)] interface nsIHelperAppLauncherDialog : nsISupports {