home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume3 / xdbx / part01 / README < prev    next >
Encoding:
Text File  |  1989-03-14  |  2.9 KB  |  68 lines
  1. 1. Introduction
  2.  
  3.     Xdbx implements an X Window interface to the dbx debugger.  It is written 
  4.     using X11R3 Toolkit Intrinsics and Athena widgets.  
  5.  
  6.     Xdbx provides buttons and action handlers for a subset of dbx commands:
  7.      run, cont, next, step, stop at, stop in, delete,
  8.      up, down, print, print *, func, file, quit
  9.  
  10.     Xdbx uses the regular expression routines provided in GNU Emacs 
  11.     distribution.  The files regex.c and regex.h are included in this
  12.     distribution.  Regex.c is slightly modified to include <alloca.h>
  13.     to compile under SunOS 4.0.
  14.  
  15. 2. Installation
  16.  
  17.     Xdbx supports both Berkeley dbx and Sun dbx.  Sun dbx, available on
  18.     the Sun workstations, is an enhanced and extended version of Berkeley dbx.
  19.     If you run Sun dbx with no arguments, you get a dbx prompt:
  20.       (dbx)
  21.     If you run Berkeley dbx with no arguments, you would get something like:
  22.       dbx version 2.0 of 11/17/87 21:23
  23.       Type 'help' for help.
  24.       enter object file name (default is `a.out'):
  25.  
  26.     If you are using Berkeley dbx, you probably have to edit the Imakefile to
  27.     include the -DBSD flag.  
  28.     Generate your own Makefile from Imakefile using imake and makedepend.
  29.  
  30.     Xdbx has been tested on Sun 3 running Sun 4.2BSD Unix Release 3.4, 
  31.     and VAXstation II/GPX running Ultrix 2.2, both under uwm.
  32.  
  33. 3. Bugs
  34.  
  35.    * Xdbx does not work properly under SunOS 4.0 because of a problem in 
  36.      disabling the packet mode (TIOCPKT) of the pseudo-terminal.  If the
  37.      packet mode is not disabled, each read from the master will return 
  38.      data written previously to the slave (dbx commands entered would 
  39.      reappear), and each newline character is incorrectly mapped to a 
  40.      carriage return and a newline during text display.
  41.    * The above problem sometimes appear on Sun 3 under release 3.4.  If you 
  42.      see ^M at the end of each line in the dialog window, quit xdbx, try 
  43.      again by either logging out and in (hopefully this will reset the pty),
  44.      or by doing an rlogin to try another pty.
  45.    * Typing control-C in the dialog window fails to interrupt dbx.
  46.    * The file command button does not unhighlight itself.
  47.    * Stuffing text to a window outside the xdbx window will sometimes give:
  48.     X Toolkit Error: AtomPtr was not initialized
  49.  
  50.    Please send any comments, bug reports, bug fixes, enhancements to:
  51.  
  52.     Po Cheung
  53.     Department of Electrical and Computer Engineering
  54.     University of Texas
  55.     Austin, TX 78712
  56.     po@volta.ece.utexas.edu
  57.  
  58.  
  59. 4. Acknowledgements
  60.  
  61.     I would like to express my sincere thanks to Dr. Joe Rahmeh for his help
  62.     and guidance, without him this would not have been possible.  His idea
  63.     to use GNU regular expression package made it much easier for xdbx to
  64.     support both versions of dbx.  I must also thank my brother, Yin Cheung,
  65.     for his support and encouragement throughout the past four months.  Many 
  66.     thanks go to Adrian Lao, Mike Schoenfelder, Yah Bin Sim and Nasr Ullah 
  67.     for making this release date possible.
  68.