Re: [rfc] [11/18] Cell multi-arch: Target description <compatible> infrastructure

["Ulrich Weigand" <uweigand at de dot ibm dot com>]

Eli Zaretskii wrote:

> > +@var{arch} is an architecture name from the same selection
> > +accepted by @code{set architecture} (@pxref{Targets, ,Specifying a
> > +Debugging Target}).
> 
> I don't understand the purpose of "the same" here.  Same as what?

This element accepts the same set of architecture names as the set 
accepted by the "set architecture" command.

The wording I've used is copied above is copied from the description
of the <architecture> element (which also accepts the same set of
architecture names).  If you can suggest a clearer way to express
this, I think both places should be fixed ...

> This begs a continuation:
> 
>   The way to describe this capability with @samp{<compatible>} is as
>   follows:
> 
>   @smallexample
>   ...
>   @end smallexample

Added.  See below for an updated patch.

Thanks,
Ulrich


Index: src/gdb/doc/gdb.texinfo
===================================================================
--- src.orig/gdb/doc/gdb.texinfo
+++ src/gdb/doc/gdb.texinfo
@@ -27586,6 +27586,7 @@ are explained further below.
 <!DOCTYPE target SYSTEM "gdb-target.dtd">
 <target version="1.0">
   @r{[}@var{architecture}@r{]}
+  @r{[}@var{compatible}@dots{}@r{]}
   @r{[}@var{feature}@dots{}@r{]}
 </target>
 @end smallexample
@@ -27641,6 +27642,32 @@ An @samp{<architecture>} element has thi
 accepted by @code{set architecture} (@pxref{Targets, ,Specifying a
 Debugging Target}).
 
+@subsection Compatible Architecture
+@cindex <compatible>
+
+A @samp{<compatible>} element has this form:
+
+@smallexample
+  <compatible>@var{arch}</compatible>
+@end smallexample
+
+@var{arch} is an architecture name from the same selection
+accepted by @code{set architecture} (@pxref{Targets, ,Specifying a
+Debugging Target}).
+
+A @samp{<compatible>} element is used to specify that the target
+is able to run binaries in some other than the main target architecture
+given by the @samp{<architecture>} element.  For example, on the
+Cell Broadband Engine, the main architecture is @code{powerpc:common}
+or @code{powerpc:common64}, but the system is able to run binaries
+in the @code{spu} architecture as well.  The way to describe this
+capability with @samp{<compatible>} is as follows:
+
+@smallexample
+  <architecture>@code{powerpc:common}</architecture>
+  <compatible>@code{spu}</compatible>
+@end smallexample
+
 @subsection Features
 @cindex <feature>
 


-- 
  Dr. Ulrich Weigand
  GNU Toolchain for Linux on System z and Cell BE
  Ulrich.Weigand@de.ibm.com