Re: MI solib notification

[Eli Zaretskii <eliz@gnu.org>]

> From:  Vladimir Prus <vladimir@codesourcery.com>
> Date:  Wed, 18 Feb 2009 00:37:29 +0300
> 
> >     @item =library-loaded,@var{info}
> >     Reports that a new library file was loaded by the program.  @var{info}
> >     includes 4 fields:
> > 
> >     @table @code
> >     @item id="@var{id}"
> >     Opaque identifier of the library.
> >     @item target-name="@var{target-name}"
> >     @itemx host-name="@var{host-name}"
> >     For remote debugging case, @var{target-name} and @var{host-name}
> >     fields give the name of the library file on the target, and on the
> >     host respectively.  For native debugging, both those fields have the
> >     same value.
> >     ...
> > 
> > etc., you get the idea.  What you suggested now is very close to this,
> > but I think my suggestion makes it easier to read and grasp.
> 
> I think the way you suggest is more complex. It introduces a new symbol 'info' 
> that does not actually correspond to standalone entity in MI output and users
> might begin to wonder what info actually is, and how it includes fields. Saying
> that notification itself has 4 fields is more direct.

OK, but then how about using a @table to describe those 4 fields?