debugvim.txt

Short introduction into debugging in GAP by Thomas Breuer and Max Neunhöffer
(see library file lib/debug.g)

  Debug(<func> [,<name>]);  # opens an editor to insert debugging code
                            # the debugged function is stored under a number

A "debugged" function gets a number and can later be accessed either as
itself or via this number.

  Debug(<func_or_nr>);      # opens an editor to edit debugging code
  UnDebug(<func_or_nr>);    # restores the function to its old form
  ShowDebug();              # show currently debugged functions
  SetDebugCount(<func_or_nr>,<count>);   # Set counter of counting break point

Keys in editor:

  F12    : this help
  F2     : Set break point before current line
  F3     : Set watch point before current line
  F4     : Set counting break point before current line
  F5     : Set Print statement before current line

Put any other debugging code into the function.

Note that the function object itself will be changed "in place"!
This means that all places where this function is installed for example
as a method will be changed simultanously.

BEWARE of debugging functions that have been created within the scope
of another function possibly with access to the surrounding local 
variables (see "Orbish" and friends)! 
***Debugging of such functions does not work and might ruin them!***