shar (3) --- put text files into a 'shell archive'       06/21/84


          | _U_s_a_g_e

          |      shar <file_spec> { <file_spec> ... }


          | _D_e_s_c_r_i_p_t_i_o_n

          |      'Shar'  (SSShhhell AAArrrchiver) is an alternative method of arrang-
          |      ing for long term storage of files  that  need  to  be  kept
          |      together  for  some  purpose,  or  files  that  will  not be
          |      frequently accessed.

          |      'Shar' reads the files named on the command line, and writes
          |      the "shell archive" on its first standard  output  port.   A
          |      shell  archive is a file containing shell commands and text,
          |      that when executed as a command by the Software  Tools  Sub-
          |      system  shell,  will  reproduce the files used to create the
          |      archive.

          |      See the help on 'cat' for a full description of <file_spec>.

          |      'Shar' can even be used to archive other shell archives,  as
          |      long  the  component  archives  do not contain a file by the
          |      same name as the archive.

          |      To extract the files, simply execute the archive file  as  a
          |      command.  As each file is extracted, its name is written out
          |      to the terminal.


          | _E_x_a_m_p_l_e_s

          |      shar [files .r$] [files .d$] >prog.shar   # to create an archive
          |      prog.shar       # to extract the files in the archive


          | _M_e_s_s_a_g_e_s

          |      "<file>: can't open"    when it can't open a file.

          |      "usage: shar ..."  if called improperly.


          | _B_u_g_s

          |      May do bizarre things with non-text files.

          |      Can't recursively archive sub-directories.


          | _S_e_e _A_l_s_o

          |      ar (1), cto (1), cat (1)





            shar (3)                      - 1 -                      shar (3)