

            hist (1) --- manipulate the subsystem history mechanism  09/05/84


          | _U_s_a_g_e

          |      hist [ on | off | save [ <file> ] | restore [ <file> ]]


          | _D_e_s_c_r_i_p_t_i_o_n

          |      The  Shell  contains a mechanism (similar to Berkeley Unix's
          |      C-Shell) called  a  history  mechanism.   This  is  sort  of
          |      dynamic  macro  facility  that allows the user to specifiy a
          |      unique substring of a previous command and have the  command
          |      recalled  and  re-executed  or  have portions of the command
          |      edited and inserted into the current command.

          |      Up to 128 commands are saved in a  circular  command  queue.
          |      Commands are seached for and retrieved from this queue.

          |      The possible options to 'hist' do the following

          |           on   Turn the history mechanism on and reset the queue.
          |                If history is already enabled then this will clear
          |                whatever command history exists in the queue.

          |           off  Turn  the  history  mechanism  off.   Any  command
          |                history in the queue is lost.

          |           save Save the current command history in the  specified
          |                file.   If  no  file  is  specified,  the  command
          |                history is saved in the file "=histfile=".

          |           restore Restore the command  history  from  a  previous
          |                session  from  the  specified file.  If no file is
          |                specified, the command history  is  restored  from
          |                the file "=histfile=".

          |      'Hist'  with  no options produces a list of the current com-
          |      mand history on STDOUT.

          |      See the  _U_s_e_r_'_s  _G_u_i_d_e  _f_o_r  _t_h_e  _S_o_f_t_w_a_r_e  _T_o_o_l_s  _S_u_b_s_y_s_t_e_m
          |      _C_o_m_m_a_n_d  _I_n_t_e_r_p_r_e_t_e_r  for a more detailed explanation of the
          |      history mechanism, and examples of its use.


          | _E_x_a_m_p_l_e_s

          |      hist
          |      hist on
          |      hist off
          |      hist save
          |      hist restore //jeff/bin/scum


          | _S_e_e _A_l_s_o

          |      _U_s_e_r_'_s  _G_u_i_d_e  _f_o_r  _t_h_e  _S_o_f_t_w_a_r_e  _T_o_o_l_s  _S_u_b_s_y_s_t_e_m  _C_o_m_m_a_n_d
          |      _I_n_t_e_r_p_r_e_t_e_r


            hist (1)                      - 1 -                      hist (1)


