Make documentation a little more explicit about the ownership model. Bug

283108, r=biesi, sr=darin


git-svn-id: svn://10.0.0.236/trunk@169636 18797224-902f-48f8-a5cc-f745e15eee43
This commit is contained in:
bzbarsky%mit.edu 2005-02-23 06:14:44 +00:00
parent b0eca57bf6
commit 7a84efbcc5
2 changed files with 15 additions and 5 deletions

View File

@ -148,11 +148,13 @@ interface nsIWebBrowser : nsISupports
* their own implementation if they intend to override or prevent
* how certain kinds of content are loaded.
*
* @note The implementation should not refcount this interface; it
* should assume that a non nsnull value is always valid.
* The embedder should explicitly set this value back to nsnull
* if the parent content listener is destroyed before the
* browser object.
* @note If this attribute is set to an object that implements
* nsISupportsWeakReference, the implementation should get the
* nsIWeakReference and hold that. Otherwise, the implementation
* should not refcount this interface; it should assume that a non
* null value is always valid. In that case, the embedder should
* explicitly set this value back to null if the parent content
* listener is destroyed before the browser object.
*
* @see nsIURIContentListener
*/

View File

@ -153,6 +153,14 @@ interface nsIURIContentListener : nsISupports
/**
* The parent content listener if this particular listener is part of a chain
* of content listeners (i.e. a docshell!)
*
* @note If this attribute is set to an object that implements
* nsISupportsWeakReference, the implementation should get the
* nsIWeakReference and hold that. Otherwise, the implementation
* should not refcount this interface; it should assume that a non
* null value is always valid. In that case, the caller is
* responsible for explicitly setting this value back to null if the
* parent content listener is destroyed.
*/
attribute nsIURIContentListener parentContentListener;
};