xo-gc: doc: + comment on GCObjectVisitor entry points

This commit is contained in:
Roland Conybeare 2026-04-12 15:38:42 -04:00
commit c3c9d9c94d
2 changed files with 7 additions and 3 deletions

View file

@ -60,10 +60,12 @@ public:
/** destroy instance @p d; calls c++ dtor only for actual runtime type; does not recover memory **/
virtual void _drop(Opaque d) const noexcept = 0;
/** allocation metadata for gc-aware data at address @p gco.
@p gco must be the result of a call to collector's alloc() function **/
@p gco must be the result of a call to collector's alloc() function
note: load-bearing for xo-gc/MutationLogStore **/
virtual AllocInfo alloc_info(Copaque data, void * addr) const = 0;
/** generation to which pointer @p addr belongs, given role @p r;
sentinel if @p addr is not owned by collector **/
sentinel if @p addr is not owned by collector.
note: load-bearing for xo-gc/MutationLogStore **/
virtual Generation generation_of(Copaque data, Role r, const void * addr) const noexcept = 0;
// nonconst methods