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

["Ulrich Weigand" <uweigand@de.ibm.com>]

Eli Zaretskii wrote:

> Then I suggest to rephrase:
> 
>  +@var{arch} is one of the architectures from the set accepted by
>  +@code{set architecture} (@pxref{Targets, ,Specifying a Debugging
>  +Target}).
> 
> > The wording I've used is copied above is copied from the description
> > of the <architecture> element
> 
> Please fix that one as well.
> 
> > See below for an updated patch.
> 
> Thanks, this is fine (with the above wording change).

Thanks!  For reference, here's the current version of the gdb.texinfo
changes.

Bye,
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
@@ -27637,9 +27638,33 @@ An @samp{<architecture>} element has thi
   <architecture>@var{arch}</architecture>
 @end smallexample
 
-@var{arch} is an architecture name from the same selection
-accepted by @code{set architecture} (@pxref{Targets, ,Specifying a
-Debugging Target}).
+@var{arch} is one of the architectures from the set 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 one of the architectures from the set 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