recover               package:methods               R Documentation

_B_r_o_w_s_i_n_g _o_n _a_n _E_r_r_o_r

_D_e_s_c_r_i_p_t_i_o_n:

     This function allows the user to browse directly on any of the
     currently active function calls, and is suitable as an error
     option. The expression `options(error=recover)' will make this the
     error option.

_U_s_a_g_e:

     recover()

_D_e_t_a_i_l_s:

     When called, `recover' prints the list of current calls, and
     prompts the user to select one of them.  The standard R `browser'
     is then invoked from the corresponding environment; the user can
     type ordinary S language expressions to be evaluated in that
     environment.

     When finished browsing in this call, type `c' to return to
     `recover' from the browser.  Type another frame number to browse
     some more, or type `0' to exit `recover'.

     WARNING: Do not use the special `Q' command to go directly from
     the browser to the prompt level of the evaluator.  This currently
     interacts with `recover' to effectively turn off the error option
     for the next error (on subsequent errors, `recover' will be called
     normally)

_V_a_l_u_e:

     Nothing useful is returned.  However, you can invoke `recover'
     directly from a function, rather than through the error option
     shown the usage section.  In this case, execution continues after
     you type `0' to exit `recover'.

_C_o_m_p_a_t_i_b_i_l_i_t_y _N_o_t_e:

     The R `recover' function can be used in the same way as the S-Plus
     function of the same name; therefore, the error option shown is a
     compatible way to specify the error action.  However, the actual
     functions are essentially unrelated and interact quite differently
     with the user.

_R_e_f_e_r_e_n_c_e_s:

     Programming with Data, (John M. Chambers, Springer, 1998).  See
     the compatibility note above, however.

_S_e_e _A_l_s_o:

     See `dump.frames' and `debugger' for the more traditional approach
     to error recovery.

