OSDN Git Service

*** empty log message ***
authorhunt <hunt>
Thu, 16 May 2002 01:11:39 +0000 (01:11 +0000)
committerhunt <hunt>
Thu, 16 May 2002 01:11:39 +0000 (01:11 +0000)
gdb/gdbtk/library/help/register.html

index b8fff0e..694efe5 100644 (file)
@@ -4,7 +4,6 @@
 </HEAD>
 <BODY>
 <H1>The Register Window</H1>
-<H2>Overview</H2>
 <P>The Register Window lists all the registers and their contents for
 the selected stack frame. It permits viewing the contents of registers
 in different formats, editing register values, and some display
@@ -12,103 +11,32 @@ customizations.</P>
 
 <P>The Register Window will update the register contents in the display
 to match the stack frame currently being viewed in the <A HREF="source.html">
-Source Window</A> and <A HREF="stack.html">Stack Winodw</A>.</P>
-
-<P>Register Window topics:
+Source Window</A> and <A HREF="stack.html">Stack Window</A>.</P>
+<p>Each time the program stops, the register window will automatically update.
+Registers that have changed since the last stop will be displayed in blue.</p>
+<H3>The Register Display</H3>
 <UL>
-    <LI><UL><A HREF="#menus">Register Menu</A>
-            <LI><A HREF="#menus_edit">Edit</A>
-            <LI><A HREF="#menus_fmt">Format</A>
-            <LI><A HREF="#menus_remove">Remove from Display</A>
-            <LI><A HREF="#menus_all">Display All Registers</A>
-        </UL>
-    <LI><UL><A HREF="#display">Register Display</A>
-            <LI><A HREF="#display_nav">Navigating the Register Display</A>
-            <LI><A HREF="#display_popup">Register Pop-up Menu</A>
-            <LI><A HREF="#display_edit">Editing a Register</A>
-            <LI><A HREF="#display_format">Changing the Display Format of
-                a Register</A>
-            <LI><A HREF="#display_remove">Removing a Register
-                 from the display</A>
-            <LI><A HREF="#display_all">Displaying all Registers</A>
-        </UL>
-</UL></P>
-
-<H3><A NAME="menus">Register Menu</A></H3>
-The Register Menu provides on-screen access to the functionality of the
-Register Window. To use any item from this menu, first use the mouse and
-select (click the left mouse button) on any register cell. Users may then
-select:
-<BR>
-<DL>
-    <DT><A NAME="menus_edit"><A HREF="#display_edit">Edit</A></A>
-        <DD>Edit the contents of the selected register
-    <DT><A NAME="menus_fmt"><A HREF="#display_format">Format</A></A>
-        <DD>Change the display format of the selected register
-    <DT><A NAME="menus_remove"><A HREF="#display_remove">Remove
-        from Display</A></A>
-        <DD>Remove the selected register from the Register
-            Window Display
-    <DT><A NAME="menus_all"><A HREF="#display_all">Display All
-        Registers</A></A>
-        <DD>Display all registers in the Display. This item
-            is only available when a register was previously
-            removed from the Display.
-</DL>
-
-<H3><A NAME="display">Register Display</A></H3>
-The Register Display contains name and value pairs for each register
-available on the target hardware. These "cells" are layed out as a
-spreadsheet for ease of use.
-
-<P><A NAME="display_nav"></A>To navigate the Register Display, use either
-the mouse and left mouse button or the arrow keys on the keyboard to
-highlight the appropriate cell. Users may then use the <A HREF="#menus">
-Register Menu</A> or use the Register Pop-up Menu to access special display
-and editing options for the Register Window.</P>
-<BR>
+        <LI><A HREF="#display_edit">Editing a Register</A></LI>
+        <LI><A HREF="#display_popup">Register Pop-up Menu</A></LI>
+</UL>
 
+<H4><A NAME="display_edit">Editing a Register</A> </H4>
+<P>
+To edit a register, simply click on it with the left mouse button.  Type
+in the new value and hit enter.  You can enter a decimal, hex, or float number and
+the type will be converted if possible. You may also enter an expression to be evaluated.
+For example, to set  $r3 to the same as $r4, edit $r3 and enter "$r4" as the value.  In the same
+way, you can set $pc to "main".
+The value of the register is set to the current value of the expression; it will not be reevaluated
+if the expression's value later changes.
+</P>
+<P>Press the escape key on the keyboard to cancel your edit.</P>
 <H4><A NAME="display_popup">The Register Pop-up Menu</A></H4>
-All of the special functions of the register window are accessed through
-the Register Pop-up Menu. To use the Menu, simply select a register (see
-<A HREF="#display_nav">Navigating the Register Display</A>) and click the
-right mouse button. The Menu offers:
-<DL>
-    <DT><A NAME="display_edit">Edit</A>
-        <DD>Edit the contents of the selected register. This item
-            is also accessible by simply double-clicking the left
-            mouse button on any register in the Display. The value
-            of the register is set to the entered value -- the debugger
-            does diffferentiate between decimal, hexadecimal, octal,
-            and binary input. Press the escape key on the keyboard
-            to cancel.
-    <DT><A NAME="display_format">Format</A>
-        <DD><DL>Change the display format of the register. Valid display types
-            are:
-                <DT>Hex
-                    <DD>The register's contents are displayed in
-                        hexadecimal (base 16).
-                <DT>Decimal
-                    <DD>The value is shown as
-                        a decimal number (base 10).
-                <DT>Natural
-                    <DD>The register is displayed in its natural format.
-                <DT>Binary
-                    <DD>The contents of the register are displayed 
-                        as a binary number (base 2).
-                <DT>Octal
-                    <DD>The register's contents are shown in octal (base 8).
-                <DT>Raw
-                    <DD>The raw contents of the register are shown.
-             </DL>
-    <DT><A NAME="display_remove">Remove</A>
-        <DD>Remove the selected register from the display. To display
-            the removed register again, select the "Display All Registers"
-            option from the Register Menu or the Register Pop-up Menu.
-    <DT><A NAME="display_all">Display All Registers</A>
-        <DD>Causes the Register Window Display to show all registers,
-            including those which were previously "removed". This menu
-            item is only available when removed registers exist.
-</DL>
+<P>
+To activate the pop-up menu, click the right mouse button over a register.
+This will allow you change the way the register is displayed, or to remove
+it from the display.  Or you can add the register to the watch window.
+For integer registers, you can also open a memory window at the
+location pointed to by the register.</P>
 </BODY>
 </HTML>