home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / RecordEval.3 < prev    next >
Encoding:
Text File  |  1995-07-26  |  3.0 KB  |  67 lines

  1.  
  2.  
  3.  
  4.      TTTTccccllll____RRRReeeeccccoooorrrrddddAAAAnnnnddddEEEEvvvvaaaallll((((3333))))         TTTTccccllll (((( ))))         TTTTccccllll____RRRReeeeccccoooorrrrddddAAAAnnnnddddEEEEvvvvaaaallll((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tcl_RecordAndEval - save  command  on  history  list  before
  12.           evaluating
  13.  
  14.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttccccllll....hhhh>>>>
  16.  
  17.           int
  18.           TTTTccccllll____RRRReeeeccccoooorrrrddddAAAAnnnnddddEEEEvvvvaaaallll(_i_n_t_e_r_p, _c_m_d, _e_v_a_l)
  19.  
  20.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  21.           Tcl_Interp   *_i_n_t_e_r_p    (in)      Tcl interpreter  in  which
  22.                                             to evaluate command.
  23.  
  24.           char         *_c_m_d       (in)      Command  (or  sequence  of
  25.                                             commands) to execute.
  26.  
  27.           int          _e_v_a_l       (in)      0  means   evaluate   _c_m_d,
  28.                                             TCL_NO_EVAL  means  record
  29.                                             it but don't evaluate it.
  30.      _________________________________________________________________
  31.  
  32.  
  33.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.           TTTTccccllll____RRRReeeeccccoooorrrrddddAAAAnnnnddddEEEEvvvvaaaallll is invoked to record a command as an event
  35.           on  the  history  list  and  then  execute it.  It returns a
  36.           completion code such as TCL_OK just  like  TTTTccccllll____EEEEvvvvaaaallll  and  it
  37.           leaves information in _i_n_t_e_r_p->_r_e_s_u_l_t.  If you don't want the
  38.           command recorded on the history list then you should  invoke
  39.           TTTTccccllll____EEEEvvvvaaaallll    instead    of    TTTTccccllll____RRRReeeeccccoooorrrrddddAAAAnnnnddddEEEEvvvvaaaallll.     Normally
  40.           TTTTccccllll____RRRReeeeccccoooorrrrddddAAAAnnnnddddEEEEvvvvaaaallll is only  called  with  top-level  commands
  41.           typed  by the user, since the purpose of history is to allow
  42.           the user to re-issue recently-invoked commands.  If the _e_v_a_l
  43.           argument is TCL_NO_EVAL then the command is recorded without
  44.           being evaluated.
  45.  
  46.  
  47.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  48.           command, event, execute, history, interpreter, record
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/10/95)
  64.  
  65.  
  66.  
  67.