* Makefile.in (VERSION): Version 4.15 released.
authorFred Fish <fnf@specifix.com>
Wed, 11 Oct 1995 22:27:33 +0000 (22:27 +0000)
committerFred Fish <fnf@specifix.com>
Wed, 11 Oct 1995 22:27:33 +0000 (22:27 +0000)
* README: Updated for version 4.15.
* README.GDBTK: Updated for version 4.15
* NEWS: Updated for 4.15 release.

gdb/NEWS
gdb/README.GDBTK

index 18ec89da73347f56e8e6a791e14d80e809f7c0ff..a21bac975a0a9bbb900fe69132aa4320c6de8cec 100644 (file)
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -1,24 +1,70 @@
                What has changed in GDB?
             (Organized release by release)
 
+*** Changes since GDB-4.15:
+
+* New native configurations
+
+Microsoft NT and Microsoft Windows95           i[345]86-*-win32
+
+* New Targets
+
+ARM via RDP protocol                           arm-*-*
+
 *** Changes in GDB-4.15:
 
+* Psymtabs for XCOFF
+
+The symbol reader for AIX GDB now uses partial symbol tables.  This
+can greatly improve startup time, especially for large executables.
+
 * Remote targets use caching
 
 Remote targets now use a data cache to speed up communication with the
-remote side.
-The data cache could lead to incorrect results because it doesn't know
-about volatile variables, thus making it impossible to debug targets
-which use memory mapped I/O devices. `set remotecache off' turns the
-the data cache off.
+remote side.  The data cache could lead to incorrect results because
+it doesn't know about volatile variables, thus making it impossible to
+debug targets which use memory mapped I/O devices. `set remotecache
+off' turns the the data cache off.
 
-* New native configurations
+* Remote targets may have threads
 
-Microsoft NT and Microsoft Windows95           i[345]86-*-win32
+The standard remote protocol now includes support for multiple threads
+in the target system, using new protocol commands 'H' and 'T'.  See
+gdb/remote.c for details.
 
-* New Targets
+* NetROM support
 
-ARM via RDP protocol                           arm-*-*
+If GDB is configured with `--enable-netrom', then it will include
+support for the NetROM ROM emulator from XLNT Designs.  The NetROM
+acts as though it is a bank of ROM on the target board, but you can
+write into it over the network.  GDB's support consists only of
+support for fast loading into the emulated ROM; to debug, you must use
+another protocol, such as standard remote protocol.  The usual
+sequence is something like
+
+       target nrom <netrom-hostname>
+       load <prog>
+       target remote <netrom-hostname>:1235
+
+* Macintosh host
+
+GDB now includes support for the Apple Macintosh, as a host only.  It
+may be run as either an MPW tool or as a standalone application, and
+it can debug through the serial port.  All the usual GDB commands are
+available, but to the target command, you must supply "serial" as the
+device type instead of "/dev/ttyXX".  See mpw-README in the main
+directory for more information on how to build.  The MPW configuration
+scripts */mpw-config.in support only a few targets, and only the
+mips-idt-ecoff target has been tested.
+
+* Autoconf
+
+GDB configuration now uses autoconf.  This is not user-visible,
+but does simplify configuration and building.
+
+* hpux10
+
+Get now supports hpux10.
 
 *** Changes in GDB-4.14:
 
index 9df59ea0748b9dba3410ba6deaac28bfeb248907..ac68bcb69b58b08e0d7e6320e815972aa0788f90 100644 (file)
@@ -1,5 +1,6 @@
-                       README.GDBTK for gdb-4.14 release
-                    Created April 11, 1995 by Stu Grossman
+                                README.GDBTK
+                          Written by Stu Grossman
+             Updated 9/26/95 by Fred Fish for gdb 4.15 release
 
 This file describes how to build, install, use and hack on GDBtk, a TK based
 GUI for GDB, the GNU debugger.
@@ -50,7 +51,7 @@ In the current version, you can have up to 6 windows active at once.  They are:
 
        1) Command
        2) Source
-       3) Disassembly
+       3) Assembly
        4) Register
        5) Auto Command
        6) Expression
@@ -101,7 +102,7 @@ Source window:
        The mouse can also be used to set and clear breakpoints when clicked
        in the margin (on a breakpoint indicator).
 
-Disassembly window:
+Assembly window:
 
        This displays a disassembly of the current function.  It's buttons are
        similar to those of the source window, except that it uses Stepi and
@@ -279,3 +280,106 @@ then GDBtk wasn't installed properly.  You can set the GDBTK_FILENAME
 environment variable to point at the gdbtk.tcl in your source directory.  Note
 that the stack trace displayed here is not valid.  If you actually get an error
 in gdbtk.tcl, the stack trace is useful to pinpoint the location.
+
+Known Bugs
+==========
+
+generic problems
+
+    o  If you open an Assembly window before you have run the program, gdbtk
+       pops up a dialog box titled "Error in Tcl Script" with the contents
+       "Error: No function contains the specified address".  Trying to then
+       do other things brings up a dialog box with the contents "Error:
+       can't read 'current_asm_label': no such variable.
+
+       Solution:  Close Assembly window when there is no program running.
+
+    o  If you open Registers window before you have run the program, gdbtk
+       pops up a dialog box titled "Error in Tcl Script" with the contents
+       "Error: No registers".  Trying to then do other things, like use the
+       Start button to run the program, repeatedly produce the same dialog
+       box and the action is not performed.
+
+       Solution:  Close Registers window when there is no program running.
+
+    o  Expressions are sometimes not displayed correctly in the Expression
+       window.  I.E. "argc" works, as does "*(argv+argc)" but not "argv[argc]".
+
+       Solution:  None
+
+    o  The Breakpoint window does not get automatically updated and changes
+       made in the window are not reflected back in the results from "info br".
+       I.E. the breakpoint count in the window is not updated at each hit and
+       enabling/disabling the breakpoint from the Breakpoint window has no effect.
+
+       Solution:  Use the command interface to control breakpoints and don't
+       open a Breakpoint window.
+
+    o  Sometimes while an expression window is active you get a dialog box
+       that complains "Error: invalide command name ".expr.e5.expr" for 
+       example.  The Tcl stack trace looks something like:
+
+               invalid command name ".expr.e5.expr"
+                   while executing
+               "$e.expr get 0.0 end"
+                   invoked from within
+               "set expr [$e.expr get 0.0 end]..."
+                   (procedure "update_expr" line 17)
+                   invoked from within
+               "update_expr $expr_num"
+                   invoked from within
+               "if $expr_update_list($expr_num) {
+                   update_expr $expr_num
+                       .
+                       .
+                       .
+
+       Solution:  None except close expression window and reopen it.
+       
+    o  If you select the "Down" button in either the Source or Assembly
+       window while in the bottom (innermost) frame, the error message that
+       results goes just to the command window and may be missed if the
+       command window is not open.  This may also apply to other messages
+       as well.  It should probably put up a notification box instead.
+
+       Solution:  Keep Command window open to see error messages.
+
+    o  Not really a problem, but it would be nice to have a backtrace
+       window.
+
+       Solution:  Do bt in command window?
+
+    o  Also not really a problem, but it might be nice to have a frame/stack
+       window that displays the last N words on the stack, along with
+       indications about which function owns a particular frame, how the
+       frame pointers are chained, and possibly the names of variables
+       alongside their frame slots.
+
+m68k-hp-hpux9.00:
+
+    o  Attempting to use a Register window results in a Tcl Script Error
+       "Error: Erroneous arithmetic operation".  The Tcl stack trace is:
+
+           while executing
+       "gdb_fetch_registers $reg_format $regnum"
+           invoked from within
+       "set regval [gdb_fetch_registers $reg_format $regnum]..."
+           ("foreach" body line 2)
+           invoked from within
+       "foreach regnum $reg_display_list {
+                               set regval [gdb_fetch_registers $reg_format $regnum]
+                               set regval [format "%-*s" $valwidth $regval]
+                               $win del ..."
+           invoked from within
+       "if {$which == "all"} {
+                       set lineindex 1
+                       foreach regnum $reg_display_list {
+                               set regval [gdb_fetch_registers $reg_format $regnum]
+                               set regval [f ..."
+           (procedure "update_registers" line 16)
+           invoked from within
+       "update_registers all"
+               . 
+               . 
+               . 
+