From 74c53fdc5a7f945356f6ebaadbc9a593275f1c9e Mon Sep 17 00:00:00 2001 From: "timeless@mozdev.org" Date: Fri, 6 Aug 2010 16:16:31 +0300 Subject: [PATCH] Bug 584967 mark deprecated dom interfaces and methods with [deprecated]; r=smaug a=jst --HG-- extra : rebase_source : d7d6f197b8df6cc87c93cc101e9cae5dbff5b82f --- content/base/public/nsIDOMFile.idl | 12 ++++++++---- content/base/public/nsISyncLoadDOMService.idl | 4 +++- content/base/public/nsIXMLHttpRequest.idl | 4 ++-- content/xslt/public/nsIXSLTProcessorObsolete.idl | 4 ++-- dom/interfaces/base/nsIDOMJSWindow.idl | 10 +++++----- dom/interfaces/events/nsIDOMNSEvent.idl | 4 ++-- dom/interfaces/html/nsIDOMNSHTMLDocument.idl | 6 +++--- dom/interfaces/offline/nsIDOMOfflineResourceList.idl | 12 ++++++------ 8 files changed, 31 insertions(+), 25 deletions(-) diff --git a/content/base/public/nsIDOMFile.idl b/content/base/public/nsIDOMFile.idl index 9cb5bdca0418..d607df7c557f 100644 --- a/content/base/public/nsIDOMFile.idl +++ b/content/base/public/nsIDOMFile.idl @@ -68,10 +68,14 @@ interface nsIDOMFile : nsIDOMBlob // This performs no security checks! [noscript] readonly attribute DOMString mozFullPathInternal; - // These are all deprecated and not in spec. Will be removed in a future - // release - readonly attribute DOMString fileName; - readonly attribute unsigned long long fileSize; + /** + * @deprecated + */ + [deprecated] readonly attribute DOMString fileName; + /** + * @deprecated + */ + [deprecated] readonly attribute unsigned long long fileSize; DOMString getAsText(in DOMString encoding); // raises(FileException) on retrieval DOMString getAsDataURL(); // raises(FileException) on retrieval DOMString getAsBinary(); // raises(FileException) on retrieval diff --git a/content/base/public/nsISyncLoadDOMService.idl b/content/base/public/nsISyncLoadDOMService.idl index 8fa28b1c1e6c..d525901e5668 100644 --- a/content/base/public/nsISyncLoadDOMService.idl +++ b/content/base/public/nsISyncLoadDOMService.idl @@ -64,9 +64,11 @@ interface nsIChannel; /** * The nsISyncDOMLoadService interface can be used to synchronously load * a document. + * + * @deprecated use XMLHttpRequest instead */ -[scriptable, uuid(8095998d-ae1c-4cfa-9b43-0973e5d77eb0)] +[deprecated, scriptable, uuid(8095998d-ae1c-4cfa-9b43-0973e5d77eb0)] interface nsISyncLoadDOMService : nsISupports { /** diff --git a/content/base/public/nsIXMLHttpRequest.idl b/content/base/public/nsIXMLHttpRequest.idl index 743ef0de4dee..d773386ebb8a 100644 --- a/content/base/public/nsIXMLHttpRequest.idl +++ b/content/base/public/nsIXMLHttpRequest.idl @@ -391,9 +391,9 @@ interface nsIXHRSendable : nsISupports { }; /** - * DEPRECATED. + * @deprecated */ -[scriptable, uuid(423fdd3d-41c9-4149-8fe5-b14a1d3912a0)] +[deprecated, scriptable, uuid(423fdd3d-41c9-4149-8fe5-b14a1d3912a0)] interface nsIJSXMLHttpRequest : nsISupports { /** * Meant to be a script-only mechanism for setting an upload progress event diff --git a/content/xslt/public/nsIXSLTProcessorObsolete.idl b/content/xslt/public/nsIXSLTProcessorObsolete.idl index 4ff46ae6f1b4..9de50555991b 100644 --- a/content/xslt/public/nsIXSLTProcessorObsolete.idl +++ b/content/xslt/public/nsIXSLTProcessorObsolete.idl @@ -44,10 +44,10 @@ interface nsIDOMNode; interface nsIDOMDocument; /** - * DEPRECATED! Don't use this interface! Use nsIXSLTProcessor instead!! + * @deprecated Use nsIXSLTProcessor instead!! */ -[scriptable, uuid(3fbff728-2d20-11d3-aef3-00108300ff91)] +[deprecated, scriptable, uuid(3fbff728-2d20-11d3-aef3-00108300ff91)] interface nsIXSLTProcessorObsolete : nsISupports { void transformDocument(in nsIDOMNode aSourceDOM, diff --git a/dom/interfaces/base/nsIDOMJSWindow.idl b/dom/interfaces/base/nsIDOMJSWindow.idl index 31d6c839215f..6e2d4de99747 100644 --- a/dom/interfaces/base/nsIDOMJSWindow.idl +++ b/dom/interfaces/base/nsIDOMJSWindow.idl @@ -70,11 +70,11 @@ interface nsIDOMJSWindow : nsISupports * @deprecated These are old Netscape 4 methods. Do not use, * the implementation is no-op. */ - void captureEvents(in long eventFlags); - void releaseEvents(in long eventFlags); - void routeEvent(in nsIDOMEvent evt); - void enableExternalCapture(); - void disableExternalCapture(); + [deprecated] void captureEvents(in long eventFlags); + [deprecated] void releaseEvents(in long eventFlags); + [deprecated] void routeEvent(in nsIDOMEvent evt); + [deprecated] void enableExternalCapture(); + [deprecated] void disableExternalCapture(); /** * This is the scriptable version of nsIDOMWindowInternal::open() diff --git a/dom/interfaces/events/nsIDOMNSEvent.idl b/dom/interfaces/events/nsIDOMNSEvent.idl index d01fe33a4c46..49175d2a9725 100644 --- a/dom/interfaces/events/nsIDOMNSEvent.idl +++ b/dom/interfaces/events/nsIDOMNSEvent.idl @@ -107,12 +107,12 @@ interface nsIDOMNSEvent : nsISupports /** * @deprecated Use nsIDOMEvent::stopPropagation. */ - void preventBubble(); + [deprecated] void preventBubble(); /** * @deprecated Use nsIDOMEvent::stopPropagation. */ - void preventCapture(); + [deprecated] void preventCapture(); boolean getPreventDefault(); diff --git a/dom/interfaces/html/nsIDOMNSHTMLDocument.idl b/dom/interfaces/html/nsIDOMNSHTMLDocument.idl index 845a45af75ad..5725d093f6bc 100644 --- a/dom/interfaces/html/nsIDOMNSHTMLDocument.idl +++ b/dom/interfaces/html/nsIDOMNSHTMLDocument.idl @@ -72,9 +72,9 @@ interface nsIDOMNSHTMLDocument : nsISupports * @deprecated These are old Netscape 4 methods. Do not use, * the implementation is no-op. */ - void captureEvents(in long eventFlags); - void releaseEvents(in long eventFlags); - void routeEvent(in nsIDOMEvent evt); + [deprecated] void captureEvents(in long eventFlags); + [deprecated] void releaseEvents(in long eventFlags); + [deprecated] void routeEvent(in nsIDOMEvent evt); // returns "BackCompat" if we're in quirks mode, // or "CSS1Compat" if we're in strict mode diff --git a/dom/interfaces/offline/nsIDOMOfflineResourceList.idl b/dom/interfaces/offline/nsIDOMOfflineResourceList.idl index 999efa962866..6efdfba9e273 100644 --- a/dom/interfaces/offline/nsIDOMOfflineResourceList.idl +++ b/dom/interfaces/offline/nsIDOMOfflineResourceList.idl @@ -58,17 +58,17 @@ interface nsIDOMOfflineResourceList : nsISupports /** * Get the number of dynamically-managed entries. - * @status DEPRECATED - * Clients should use the "items" attribute. + * + * @deprecated Clients should use the "items" attribute. */ - readonly attribute unsigned long mozLength; + [deprecated] readonly attribute unsigned long mozLength; /** * Get the URI of a dynamically-managed entry. - * @status DEPRECATED - * Clients should use the "items" attribute. + * + * @deprecated Clients should use the "items" attribute. */ - DOMString mozItem(in unsigned long index); + [deprecated] DOMString mozItem(in unsigned long index); /** * Add an item to the list of dynamically-managed entries. The resource