Eli Zaretskii <eliz@gnu.org> writes:

>> From: Jeremy Bryant <jb@jeremybryant.net>
>>  and then release it afterwards with:
>>  
>> -     (gdb) call mps_arena_release(arena)
>> +     (gdb) call mps_arena_release(global_igc->arena)
>
> Is it really true that the arena pointer is always global_igc->arena
> in Emacs?  If so, I would suggest to tell that separately, because the
> GDB calls to functions can have arguments constructed in many
> different ways.  Something like
>
>   In Emacs, the arena is usually stored in 'global_igc->arena'.
>
> and leave the examples in their current general form.

OK, on that basis please find attached patch adding that line, with 'usually'.

I believe that there is only one global arena on the basis of the
comments below.


igc.c:
/* The registry for an MPS arena.  There is only one arena used.  */


igc.org:
- Arena.  We tell MPS to create the global arena that is used for all
  objects.

All other model objects are handled in the same way, threads, arenas,
pools, object formats and so on.

Igc collects all these MPS handles in a =struct igc=.  This "registry" of
MPS handles is found in the global variable =global_igc= and thus can be
accessed from anywhere.