[DOC PATCH] Re: [PATCH]*3 Re: [RFC] "info powerpc"

[Paul Gilliam <pgilliam@us.ibm.com>]

[-- Attachment #1: Type: text/plain, Size: 1284 bytes --]

On Wednesday 14 September 2005 20:33, Eli Zaretskii wrote:
> > From: Paul Gilliam <pgilliam@us.ibm.com>
> > Date: Wed, 14 Sep 2005 17:10:39 -0700
> > 
> > The second, 'altivec_alias.patch', functions like the first, except that infcmd.c is not touched.  Instead, an 'info powerpc altivec' command
> > is added that turns itself into an alias for "info vector" the first time it's called.  This can't be done with add_com_alias because the alias and 
> > the command being aliased are on different command chains.
> > 
> > The final patch, 'no_more_altivec.patch' depreciates the "info powerpc" command prefix and changes the testsuite to use "info vector".  To make
> > this work, 'lookup_cmd_composition' in cli/cli-decode.c had to be changed so that a prefix command that has no sub-commands
> > can be depreciated.
> 
> Please accompany any changes to user-visible behavior (such as new
> commands or changes in how existing command behave) with appropriate
> changes to the user manual.  Thanks.
> 
> 
The "info powerpc" group of commands (all none of them) are not documented.

If we decide to just get rid of it, then no user manual changes are needed.

If we decide to keep it and make 'info powerpc altivec' an alias for "info vector", then we can use the attached doc patch.

[-- Attachment #2: doc.patch --]
[-- Type: text/x-diff, Size: 1482 bytes --]

? doc.patch
Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.278
diff -a -u -r1.278 gdb.texinfo
--- gdb.texinfo	27 Aug 2005 12:51:28 -0000	1.278
+++ gdb.texinfo	15 Sep 2005 18:27:23 -0000
@@ -4991,6 +4991,7 @@
 * Registers::                   Registers
 * Floating Point Hardware::     Floating point hardware
 * Vector Unit::                 Vector Unit
+* PowerPC Features::            PowerPC hardware features
 * OS Information::              Auxiliary data provided by operating system
 * Memory Region Attributes::    Memory region attributes
 * Dump/Restore Files::          Copy between memory and a file
@@ -6247,6 +6248,22 @@
 layout vary depending on the hardware.
 @end table
 
+@node PowerPC Features
+@section PowerPC Features
+@cindex PowerPC Features
+
+Some PowerPC chips have features that are in addition to the core functionality
+of the architecture.  Depending on the configuration, @value{GDBN} may be able
+to give you information about the status of those features.
+
+@table @code
+@kindex info powerpc altivec
+@item info powerpc altivec
+Display information about the Altivec unit.  This will consist of the contents
+of the Altivec registers @code(vr0) through @code(vr31), along with that of the
+@code(vrsave) and @code(vsrc) registers.
+@end table
+
 @node OS Information
 @section Operating system auxiliary information
 @cindex OS information