edit (2) --- invoke the line-oriented text editor        06/26/84


          | _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 subroutine edit (filename, fdin, fdout)
                 character filename (ARB)
                 file_des fdin, fdout

                 Library:  vedtlb (Subsystem text editor library)


            _F_u_n_c_t_i_o_n

                 'Edit'  accesses  the  Subsystem  line-oriented text editor.
                 When called, 'edit' begins an editing session, reading edit-
                 ing commands from the file specified by "fdin"  and  writing
                 editing  output  on  the  file  specified  by  "fdout".   If
                 "filename" is other than an empty string, 'edit'  reads  the
          |      file into the edit buffer before accepting editing commands.

          |      Since  the  editor  can now call the shell, the shared shell
          |      library, 'vshlib', must be  loaded  along  with  the  editor
          |      library 'vedtlb' for any program that calls 'edit'.

          |      'Edit'  arranges  to  catch the 'LOGOUT$' condition.  When a
          |      LOGOUT$ occurs, 'edit' saves the  current  contents  of  the
          |      edit  buffer  in the file =home=/<prog>.logout, where <prog>
          |      is the name of the program using 'edit'.  For example,  'ed'
          |      would  have  the  buffer  saved  in  =home=/ed.logout, while
          |      'moot' would have its buffer saved in =home=/moot.logout.

                 For  complete   information   on   editing   commands,   see
                 _I_n_t_r_o_d_u_c_t_i_o_n _t_o _t_h_e _S_o_f_t_w_a_r_e _T_o_o_l_s _T_e_x_t _E_d_i_t_o_r


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Edit'  is  the  top-level  routine  for  the Subsystem line
                 editor.





















            edit (2)                      - 1 -                      edit (2)