Heisenbug involving Destructors & GC - Help Needed

[Etienne via Digitalmars-d]

On Tuesday, 30 June 2015 at 14:04:45 UTC, Etienne wrote:
> On Tuesday, 30 June 2015 at 13:01:46 UTC, Steven Schveighoffer 
> wrote:
>> [...]
>
> I don't think there's a problem with destroy in the first 
> place. The problem is that it's being advertised as calling the 
> destructors:
>
> http://dlang.org/library/object/type_info.destroy.html
> http://dlang.org/library/object/destroy.html
>
> The function would need a documentation section itself, since 
> it's being advertised as a replacement for `delete` and 
> expected to do the same wherever there's something to read 
> about it.

We probably just need a new page in the `D Reference` about 
Lifetime. Documenting the general behavior and good practices of 
anything that manages lifetime, e.g. malloc, free, delete, 
destroy, new, pointers, classes, base types, etc.