New issue
Advanced search Search tips

Issue 655787 link

Starred by 0 users

Issue metadata

Status: Untriaged
Owner: ----
Components:
EstimatedDays: ----
NextAction: ----
OS: ----
Pri: 3
Type: Bug



Sign in to add a comment

Need better Oilpan documentation

Project Member Reported by atotic@chromium.org, Oct 13 2016

Issue description

Working with Olipan can get frustrating when I need to use features that are not well documented. I consult:

https://chromium.googlesource.com/chromium/src/+/master/third_party/WebKit/Source/platform/heap/BlinkGCAPIReference.md

https://www.chromium.org/developers/blink-gc-plugin-errors

In the last couple of days, these are undocumented questions
I wrestled with:

1) Collections:
Picking the right collection can be tricky. 
Documenting which Oilpan collections exist, and their usage constraints would be great:
- what triggers finalization
- which ones can be used with WeakMember, Member

In particular, HeapLinkedHashSet is the only ordered set that works with WeakMember. It'd be great if HeapArray would suggest HeapLinkedHashSet when you try to use it with WeakMember.

2) TRACE_AFTER_DISPATCH
- when is it needed, how does it work?

3) finalizeGarbageCollectedObject
- when and why is it needed, usage exaple.
 

Sign in to add a comment