Subject: Re: bug#77125: [PATCH] igc ; * etc/DEBUG: Fix gdb examples to: call ... (global_igc->arena)

From: Eli Zaretskii <[email-masked]>
Date: Fri, 21 Mar 2025 10:30:59 +0200

> From: Jeremy Bryant <[email-masked]>
> Cc: [email-masked],  [email-masked],  [email-masked]
> Date: Thu, 20 Mar 2025 21:56:36 +0000
> 
> --- a/etc/DEBUG
> +++ b/etc/DEBUG
> @@ -1382,11 +1382,11 @@ states.  Two of these are important for debugging, the clamped and
>  parked states.  When debugging igc, you can clamp the arena before
>  inspecting memory:
>  
> -     (gdb) call mps_arena_clamp(arena)
> +     (gdb) call mps_arena_clamp(global_igc->arena)
>  
>  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.