<div class="gmail_quote">On Fri, Jun 15, 2012 at 12:14 PM, Maciej Stachowiak <span dir="ltr"><<a href="mailto:mjs@apple.com" target="_blank">mjs@apple.com</a>></span> wrote:<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I am not sure how to get the key points across without being accurate or misleading. A version that I think explains the complete design without saying anything false or misleading:<br>
<br>
refTheDocumentItselfButUnlikeTheRegularRefDontPreventTheDocumentsChildrenFromBeingRemovedToAvoidCyclesWhenRefingTheOwnerDocument<br>
<br>
To make a reasonable name we probably need to focus on one of these aspects. Perhaps one approach is to focus on when and why you should use this call, rather than what it does:<br>
<br>
refAsOwnerDocument() / m_refCountAsOwnerDocument (or m_ownerDocumentRefCount)<br>
refAvoidingCycles() (or cycleAvoidingRef()) / m_cycleAvoidingRefCount<br></blockquote><div><br></div><div>We probably need to qualify kinds of cycles we're avoiding: ones through descendents (or subtree); e.g. this doesn't avoid cycles with JSC/V8 objects.</div>
<div><br></div><div>- Ryosuke</div><div><br></div></div>