Bug 238780

Summary:	Convention to indicate caller is responsible for maintaining external ref
Product:	WebKit	Reporter:	Gabriel Nava Marino <gnavamarino>
Component:	WebCore Misc.	Assignee:	Nobody <webkit-unassigned>
Status:	NEW ---
Severity:	Normal	CC:	sam, webkit-bug-importer
Priority:	P2	Keywords:	InRadar
Version:	WebKit Nightly Build
Hardware:	Unspecified
OS:	Unspecified

Description Gabriel Nava Marino 2022-04-04 18:32:25 PDT

As recommended by Sam in bug 238747 and as this seems to be the preferred pattern to ensure a ref counted object remains for the scope of the call:

> I wonder ifs we should come up with some convention (naming or otherwise) to
> indicate that a caller is responsible for maintaining an external ref. Like,
> Document::close_mayDestroy(), or perhaps even take it a step further and
> require a separate type to call close()?  
> 
> Ref closer = document.closer()
> closer.close()

Comment 1 Radar WebKit Bug Importer 2022-04-11 18:33:15 PDT

<rdar://problem/91601054>