Gecko:Obsolete API - Revision history

Ms2ger: Links; Updates

2010-03-21T18:46:32Z

Links; Updates

← Older revision		Revision as of 18:46, 21 March 2010
Line 3:		Line 3:
	If at all possible, please provide a) a suggested alternate class or function that provides similar functionality; and b) a link to a bug for removing the obsolete API from the codebase. The bug should contain rationale for obsoleting that API. To propose an API for obsolescence, please file a bug and add it to the proposed obsolete API section.		If at all possible, please provide a) a suggested alternate class or function that provides similar functionality; and b) a link to a bug for removing the obsolete API from the codebase. The bug should contain rationale for obsoleting that API. To propose an API for obsolescence, please file a bug and add it to the proposed obsolete API section.

	= Obsolete API =		== Obsolete API ==
	* nsIFileSpec, nsFileSpec		* nsIFileSpec, nsFileSpec
	** FileSpec has various issues, including being limited to the system character set for filenames. <!-- more? -->		** FileSpec has various issues, including being limited to the system character set for filenames. <!-- more? -->
	** Use nsIFile/nsILocalFile/nsILocalFile{In,Out}putStream		** Use nsIFile/nsILocalFile/nsILocalFile{In,Out}putStream
	** {{Bug\|38122}}		** {{Bug\|38122}}
	* nsIPref		* nsIPref ('''GONE''')
	** Use nsIPrefService/nsIPrefBranch/nsIPrefBranch2		** Use nsIPrefService/nsIPrefBranch/nsIPrefBranch2
	** {{Bug\|175193}}		** {{Bug\|175193}}
Line 48:		Line 48:
	** nsIDOMXULListener		** nsIDOMXULListener

	= Proposed Obsolete API =		== Proposed Obsolete API ==

	* NS_GET_IID, NS_DEFINE_IID, and T::GetIID, except when NS_GET_IID is used on a template parameter.		* NS_GET_IID, NS_DEFINE_IID, and T::GetIID, except when NS_GET_IID is used on a template parameter.
Line 56:		Line 56:
	* NS_NewAtom, NS_NewPermanentAtom		* NS_NewAtom, NS_NewPermanentAtom
	** use do_GetAtom, do_GetPermanentAtom instead		** use do_GetAtom, do_GetPermanentAtom instead
	* nsIRenderingContext, nsIDrawingSurface, nsIFontMetrics, nsTransform2D, nsFont, etc		* nsIRenderingContext, nsIDrawingSurface, nsIFontMetrics, nsTransform2D, nsFont, etc. (see [[Gfx glue layer removal]].)
	** any substantial new rendering code should be written to Thebes directly; that is, gfxContext, gfx*Surface, gfxPlatform, gfxFontGroup, gfxTextRun.		** any substantial new rendering code should be written to Thebes directly; that is, gfxContext, gfx*Surface, gfxPlatform, gfxFontGroup, gfxTextRun.

Standard8: Improved bug links (use template), and add link to mailnews nsISupportsArray removal bug.

2008-02-18T21:22:25Z

Improved bug links (use template), and add link to mailnews nsISupportsArray removal bug.

← Older revision		Revision as of 21:22, 18 February 2008
Line 7:		Line 7:
	** FileSpec has various issues, including being limited to the system character set for filenames. <!-- more? -->		** FileSpec has various issues, including being limited to the system character set for filenames. <!-- more? -->
	** Use nsIFile/nsILocalFile/nsILocalFile{In,Out}putStream		** Use nsIFile/nsILocalFile/nsILocalFile{In,Out}putStream
	** ~~[https://bugzilla.mozilla.org/show_bug.cgi?id=38122~~ Bug 38122]		** {{Bug\|38122}}
	* nsIPref		* nsIPref
	** Use nsIPrefService/nsIPrefBranch/nsIPrefBranch2		** Use nsIPrefService/nsIPrefBranch/nsIPrefBranch2
	** ~~[https://bugzilla.mozilla.org/show_bug.cgi?id=175193~~ Bug 175193]		** {{Bug\|175193}}
	* ns(I)SupportsArray, nsIEnumerator		* ns(I)SupportsArray, nsIEnumerator
	** nsSupportsArray is very inefficient and has a bad API		** nsSupportsArray is very inefficient and has a bad API
	** Use any of the arrays in [[mdc:XPCOM_array_guide\|The Mozilla Array Guide]].		** Use any of the arrays in [[mdc:XPCOM_array_guide\|The Mozilla Array Guide]].
			** Mailnews Removal covered by {{bug\|394167}}
	* nsVoidArray		* nsVoidArray
	** Doesn't provide typesafety		** Doesn't provide typesafety
Line 29:		Line 30:
	* nsIBox		* nsIBox
	** This is now just a typedef for nsIFrame.		** This is now just a typedef for nsIFrame.
	* nsIDOMEventReceiver (~~[https://bugzilla.mozilla.org/show_bug.cgi?id=363089~~ Bug 363089]), and all specialized DOM event listener interfaces (better to use nsIDOMEventListener), e.g:		* nsIDOMEventReceiver ({{Bug\|363089}}, and all specialized DOM event listener interfaces (better to use nsIDOMEventListener), e.g:
	** nsIDOMCompositionListener		** nsIDOMCompositionListener
	** nsIDOMContextMenuListener		** nsIDOMContextMenuListener
Line 39:		Line 40:
	** nsIDOMMouseListener		** nsIDOMMouseListener
	** nsIDOMMouseMotionListener		** nsIDOMMouseMotionListener
	** nsIDOMMutationListener (unused, remove in 1.9?, ~~[https://bugzilla.mozilla.org/show_bug.cgi?id=360847~~ Bug 360847])		** nsIDOMMutationListener (unused, remove in 1.9?, {{Bug\|360847}})
	** nsIDOMPageTransitionListener (unused, remove in 1.9?, ~~[https://bugzilla.mozilla.org/show_bug.cgi?id=360847~~ Bug 360847])		** nsIDOMPageTransitionListener (unused, remove in 1.9?, {{Bug\|360847}})
	** nsIDOMPaintListener (unused, remove in 1.9?, ~~[https://bugzilla.mozilla.org/show_bug.cgi?id=360847~~ Bug 360847])		** nsIDOMPaintListener (unused, remove in 1.9?, {{Bug\|360847}})
	** nsIDOMScrollListener (unused, remove in 1.9?, ~~[https://bugzilla.mozilla.org/show_bug.cgi?id=360847~~ Bug 360847])		** nsIDOMScrollListener (unused, remove in 1.9?, {{Bug\|360847}})
	** nsIDOMTextListener		** nsIDOMTextListener
	** nsIDOMUIListener		** nsIDOMUIListener

Napolj2: /* Obsolete API */ fix bug links

2007-11-13T17:43:10Z

Obsolete API: fix bug links

← Older revision		Revision as of 17:43, 13 November 2007
Line 7:		Line 7:
	** FileSpec has various issues, including being limited to the system character set for filenames. <!-- more? -->		** FileSpec has various issues, including being limited to the system character set for filenames. <!-- more? -->
	** Use nsIFile/nsILocalFile/nsILocalFile{In,Out}putStream		** Use nsIFile/nsILocalFile/nsILocalFile{In,Out}putStream
	** https://bugzilla.mozilla.org/show_bug.cgi?id=38122		** [https://bugzilla.mozilla.org/show_bug.cgi?id=38122 Bug 38122]
	* nsIPref		* nsIPref
	** Use nsIPrefService/nsIPrefBranch/nsIPrefBranch2		** Use nsIPrefService/nsIPrefBranch/nsIPrefBranch2
	** https://bugzilla.mozilla.org/show_bug.cgi?id=175193		** [https://bugzilla.mozilla.org/show_bug.cgi?id=175193 Bug 175193]
	* ns(I)SupportsArray, nsIEnumerator		* ns(I)SupportsArray, nsIEnumerator
	** nsSupportsArray is very inefficient and has a bad API		** nsSupportsArray is very inefficient and has a bad API

Callek: Reverted edit of Mpb7628, changed back to last version by Pettay

2007-05-12T04:39:03Z

Reverted edit of Mpb7628, changed back to last version by Pettay

@@ Line 30: / Line 30: @@
 ** This is now just a typedef for nsIFrame.
 * nsIDOMEventReceiver ([https://bugzilla.mozilla.org/show_bug.cgi?id=363089 Bug 363089]), and all specialized DOM event listener interfaces (better to use nsIDOMEventListener), e.g:
-** nsIDOMCompositionListen
+** nsIDOMCompositionListener

Mpb7628 at 03:49, 12 May 2007

2007-05-12T03:49:50Z

@@ Line 30: / Line 30: @@
 ** This is now just a typedef for nsIFrame.
 * nsIDOMEventReceiver ([https://bugzilla.mozilla.org/show_bug.cgi?id=363089 Bug 363089]), and all specialized DOM event listener interfaces (better to use nsIDOMEventListener), e.g:
-** nsIDOMCompositionListener
+** nsIDOMCompositionListen

Pettay at 18:19, 8 December 2006

2006-12-08T18:19:10Z

← Older revision		Revision as of 18:19, 8 December 2006
Line 29:		Line 29:
	* nsIBox		* nsIBox
	** This is now just a typedef for nsIFrame.		** This is now just a typedef for nsIFrame.
	* nsIDOMEventReceiver, and all specialized DOM event listener interfaces (better to use nsIDOMEventListener), e.g:		* nsIDOMEventReceiver ([https://bugzilla.mozilla.org/show_bug.cgi?id=363089 Bug 363089]), and all specialized DOM event listener interfaces (better to use nsIDOMEventListener), e.g:
	** nsIDOMCompositionListener		** nsIDOMCompositionListener
	** nsIDOMContextMenuListener		** nsIDOMContextMenuListener
Line 39:		Line 39:
	** nsIDOMMouseListener		** nsIDOMMouseListener
	** nsIDOMMouseMotionListener		** nsIDOMMouseMotionListener
	** nsIDOMMutationListener (unused, remove in 1.9?, https://bugzilla.mozilla.org/show_bug.cgi?id=360847)		** nsIDOMMutationListener (unused, remove in 1.9?, [https://bugzilla.mozilla.org/show_bug.cgi?id=360847 Bug 360847])
	** nsIDOMPageTransitionListener (unused, remove in 1.9?, https://bugzilla.mozilla.org/show_bug.cgi?id=360847)		** nsIDOMPageTransitionListener (unused, remove in 1.9?, [https://bugzilla.mozilla.org/show_bug.cgi?id=360847 Bug 360847])
	** nsIDOMPaintListener (unused, remove in 1.9?, https://bugzilla.mozilla.org/show_bug.cgi?id=360847)		** nsIDOMPaintListener (unused, remove in 1.9?, [https://bugzilla.mozilla.org/show_bug.cgi?id=360847 Bug 360847])
	** nsIDOMScrollListener (unused, remove in 1.9?, https://bugzilla.mozilla.org/show_bug.cgi?id=360847)		** nsIDOMScrollListener (unused, remove in 1.9?, [https://bugzilla.mozilla.org/show_bug.cgi?id=360847 Bug 360847])
	** nsIDOMTextListener		** nsIDOMTextListener
	** nsIDOMUIListener		** nsIDOMUIListener

Pettay at 00:31, 16 November 2006

2006-11-16T00:31:41Z

← Older revision		Revision as of 00:31, 16 November 2006
Line 39:		Line 39:
	** nsIDOMMouseListener		** nsIDOMMouseListener
	** nsIDOMMouseMotionListener		** nsIDOMMouseMotionListener
	** nsIDOMMutationListener (unused, remove in 1.9?)		** nsIDOMMutationListener (unused, remove in 1.9?, https://bugzilla.mozilla.org/show_bug.cgi?id=360847)
	** nsIDOMPageTransitionListener (unused, remove in 1.9?)		** nsIDOMPageTransitionListener (unused, remove in 1.9?, https://bugzilla.mozilla.org/show_bug.cgi?id=360847)
	** nsIDOMPaintListener (unused, remove in 1.9?)		** nsIDOMPaintListener (unused, remove in 1.9?, https://bugzilla.mozilla.org/show_bug.cgi?id=360847)
	** nsIDOMScrollListener (unused, remove in 1.9?)		** nsIDOMScrollListener (unused, remove in 1.9?, https://bugzilla.mozilla.org/show_bug.cgi?id=360847)
	** nsIDOMTextListener		** nsIDOMTextListener
	** nsIDOMUIListener		** nsIDOMUIListener

Pettay at 22:52, 15 November 2006

2006-11-15T22:52:44Z

← Older revision		Revision as of 22:52, 15 November 2006
Line 29:		Line 29:
	* nsIBox		* nsIBox
	** This is now just a typedef for nsIFrame.		** This is now just a typedef for nsIFrame.
	* nsIDOMEventReceiver, and all specialized DOM event listener interfaces, e.g:		* nsIDOMEventReceiver, and all specialized DOM event listener interfaces (better to use nsIDOMEventListener), e.g:
	** nsIDOMCompositionListener		** nsIDOMCompositionListener
	** nsIDOMContextMenuListener		** nsIDOMContextMenuListener
Line 39:		Line 39:
	** nsIDOMMouseListener		** nsIDOMMouseListener
	** nsIDOMMouseMotionListener		** nsIDOMMouseMotionListener
	** nsIDOMMutationListener		** nsIDOMMutationListener (unused, remove in 1.9?)
	** nsIDOMPageTransitionListener		** nsIDOMPageTransitionListener (unused, remove in 1.9?)
	** nsIDOMPaintListener		** nsIDOMPaintListener (unused, remove in 1.9?)
	** nsIDOMScrollListener		** nsIDOMScrollListener (unused, remove in 1.9?)
	** nsIDOMTextListener		** nsIDOMTextListener
	** nsIDOMUIListener		** nsIDOMUIListener

Roc: /* Obsolete API */

2006-11-05T22:37:42Z

Obsolete API

← Older revision		Revision as of 22:37, 5 November 2006
Line 17:		Line 17:
	** Doesn't provide typesafety		** Doesn't provide typesafety
	** Prefer to use nsTArray or nsCOMArray.		** Prefer to use nsTArray or nsCOMArray.
			* nsAutoVoidArray
			** Use nsAutoTArray
			* nsAutoBuffer
			** Use nsAutoTArray
	* nsStringArray, nsCStringArray		* nsStringArray, nsCStringArray
	** Malloc-happy		** Malloc-happy

Jst: /* Obsolete API */

2006-10-16T22:31:47Z

Obsolete API

@@ Line 25: / Line 25: @@
 * nsIBox
 ** This is now just a typedef for nsIFrame.
 = Proposed Obsolete API =