home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / C / Applications / Python 1.4 / twit / readme.txt < prev    next >
Encoding:
Text File  |  1996-09-26  |  2.2 KB  |  55 lines  |  [TEXT/R*ch]
  1. Quick introduction to using TWIT 0.2.
  2. -------------------------------------
  3.  
  4. Major changes since 0.1 (dated 25-09-96):
  5. - You can now debug FrameWork applications
  6. - Various buttons have been replaced by menu items
  7.  
  8. Note that this is a "public alpha" release: quite a few things need cleaning
  9. up, especially in the user interface. Some features do not work or
  10. even crash twit (notably the "About twit" dialog) since they need features that
  11. are not in the 1.4b3 distribution. Also note that newer versions of bdb.py and
  12. FrameWork.py are included in this distribution.
  13.  
  14. Starting:
  15. - To start debugging a program run twit (either the applet or the script twit.py).
  16. - Use "Run command" or "Run File" to run a statement or file.
  17. - Double-clicking a Python file while the debugger is running should automatically
  18.   debug the file.
  19.  
  20. Postmortem debugging:
  21. - import twit
  22. - twit.pm()
  23.  
  24. PM debugging has a few problems, foremost that you do not currently see the
  25. exception.
  26.  
  27. Display: 
  28.  
  29. The main window has a stacktrace at top-left, local variable display top-right
  30. (use the toggles at the bottom to select which local variables to display) and a
  31. source browser at the bottom. Select a stack frame to see its variables.
  32. Double-click a variable to open a variable browser.
  33.  
  34. The "browser" button will open the module browser window on the current module
  35. (if there is one).
  36.  
  37. The source browser section shows the current file (if there is any). Selecting a
  38. line and pressing "edit" will fire up the MetroWerks editor on that line.
  39. Clicking in the bar left of the source line will set/clear breakpoints. The
  40. "current line" indicator is also shown here, with different icons for program
  41. state (stopped, calling, returning, exception).
  42.  
  43. The module browser window is vaguely similar to the main window, but without the
  44. control buttons and with module-global variables top-right. Select a module
  45. to display its variables, double-click a variable to start a variable browser.
  46.  
  47. The variable browser is quite different (having been written by Just, not me),
  48. but use is intuitive. The one non-intuitive thing is that you have to
  49. update it manually (unlike the other two windows).
  50.  
  51.  
  52.             Jack Jansen, <jack@cwi.nl>, 26-09-96.
  53.             Twit can be found at <ftp://ftp.cwi.nl/pub/jack/python/mac>.
  54.  
  55.