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

Ulrich Weigand
2008-09-08T11:45:56Z

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.

<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>