home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / MorphOS / Epic4_mos / share / epic / help / 5_programming / call < prev    next >
Encoding:
Text File  |  2002-10-28  |  1.2 KB  |  36 lines
  1. Synopsis:
  2.    call
  3.  
  4. Description:
  5.    CALL produces a gdb/dbx-like stack trace of the alias currently being
  6.    executed.  It returns a list of the commands currently being executed,
  7.    tracing back from the current command, to the command that called it,
  8.    and so forth until the CALL command itself it listed.  A deeply nested
  9.    alias might have the following alias stack:
  10.  
  11.       [ 0] call
  12.       [ 1] go
  13.       [ 2] get_set
  14.       [ 3] get_ready
  15.       [ 4] on_your_marks
  16.       [ 5] /superalias
  17.  
  18.    In this example, CALL was run from the "go" alias, which in turn was
  19.    called from "get_set", which was called from "get_ready", and so on, all
  20.    the way down to the original command executed.
  21.  
  22.    Command names appear precisely as they are typed in (which means, if
  23.    an alias is called with a / in front of it, the slash will appear in
  24.    the stack listing).  Additionally, in the (unlikely) event that EPIC
  25.    were to crash, CALL is executed before the client terminates, to aid
  26.    in debugging.
  27.  
  28. See Also:
  29.    set(4) debug
  30.  
  31. Restrictions:
  32.    This command requires that the client be compiled with the WIND_STACK
  33.    #define enabled; it is enabled by default.  If the client was compiled
  34.    with it, the $info(o) string will have an 'a' in it.
  35.  
  36.