From 09991fa0eee7d10733f7a5b7b9420981af849c7e Mon Sep 17 00:00:00 2001
From: Jim Blandy <jimb@codesourcery.com>
Date: Mon, 9 Aug 2004 18:43:21 +0000
Subject: [PATCH] * rs6000-tdep.c (set_sim_regno, init_sim_regno_table,
 rs6000_register_sim_regno): Doc fixes.

---
 gdb/ChangeLog     |  5 +++++
 gdb/rs6000-tdep.c | 15 +++++++++++++++
 2 files changed, 20 insertions(+)

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 62a5b482c36..f8e98ee3a28 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,8 @@
+2004-08-09  Jim Blandy  <jimb@redhat.com>
+
+	* rs6000-tdep.c (set_sim_regno, init_sim_regno_table,
+	rs6000_register_sim_regno): Doc fixes.
+
 2004-08-08  Joel Brobecker  <brobecker@gnat.com>
 
 	* mips-tdep.c: Include "floatformat.h".
diff --git a/gdb/rs6000-tdep.c b/gdb/rs6000-tdep.c
index fcd14635938..36741c5e5e2 100644
--- a/gdb/rs6000-tdep.c
+++ b/gdb/rs6000-tdep.c
@@ -192,6 +192,14 @@ ppc_floating_point_unit_p (struct gdbarch *gdbarch)
           && tdep->ppc_fpscr_regnum >= 0);
 }
 
+
+/* Check that TABLE[GDB_REGNO] is not already initialized, and then
+   set it to SIM_REGNO.
+
+   This is a helper function for init_sim_regno_table, constructing
+   the table mapping GDB register numbers to sim register numbers; we
+   initialize every element in that table to -1 before we start
+   filling it in.  */
 static void
 set_sim_regno (int *table, int gdb_regno, int sim_regno)
 {
@@ -201,6 +209,10 @@ set_sim_regno (int *table, int gdb_regno, int sim_regno)
   table[gdb_regno] = sim_regno;
 }
 
+
+/* Initialize ARCH->tdep->sim_regno, the table mapping GDB register
+   numbers to simulator register numbers, based on the values placed
+   in the ARCH->tdep->ppc_foo_regnum members.  */
 static void
 init_sim_regno_table (struct gdbarch *arch)
 {
@@ -281,6 +293,9 @@ init_sim_regno_table (struct gdbarch *arch)
   tdep->sim_regno = sim_regno;
 }
 
+
+/* Given a GDB register number REG, return the corresponding SIM
+   register number.  */
 static int
 rs6000_register_sim_regno (int reg)
 {