

            phist (1) --- print Subsystem history                    12/26/80


            _U_s_a_g_e

                 phist { -b <author> | -f <date> | -s <subject> | -q }
                       [-i <input file>]
                 <date> ::= <day> | <month>/<day> | <month>/<day>/<year>


            _D_e_s_c_r_i_p_t_i_o_n

                 The  purpose  of  'phist' is to print selected portions of a
          |      history  file.   The  history  file   chosen   by   default,
          |      "=doc=/hist/history", chronicles the ongoing development and
                 maintenance   of   the   Software  Tools  Subsystem  by  its
                 implementors at Ga.  Tech.  It consists of a series of dated
                 entries, each of which contains the name of  the  author,  a
                 list of commands or files affected, and a description of the
                 modification.

                 When  invoked  without  arguments, 'phist' simply prints out
                 the entire  history  file;  but  several  optional  argument
                 sequences  can  be  employed  to  sift  out  the interesting
                 entries.   The  "-b  <author>"  argument  sequence  may   be
                 specified  to  restrict the entries printed to those written
                 by a given author.  The syntax of <author> is  the  same  as
                 that  defined  for  patterns in the Software Tools Subsystem
                 text editors (see the _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 for details).

                 The "-s <subject>" argument sequence tells 'phist' that only
                 those  entries  concerning  the  specified subject should be
                 printed.  <Subject> may also be an arbitrary pattern.

                 The "-f <date>" sequence allows the  user  to  tell  'phist'
                 that  he  only  wants  to  see entries written on or after a
                 specific date.  The format of <date> has three options:   if
                 a  single  integer  is specified, it designates a day of the
                 current month; if two integers  separated  by  a  slash  are
                 specified,  they  designate  a  month and day of the current
                 year; finally, if three integers separated  by  slashes  are
                 specified, they designate a specific month, day and year.

                 If the "-q" option is specified, 'phist' will only print the
                 heading  of  each selected entry (i.e., the date, author and
                 subject of the entry) and omit the explanatory text.  Other-
                 wise, the entire entry is printed.

                 If the "-i <input file>" is  specified,  'phist'  takes  its
                 input     from    <input    file>,    rather    than    from
                 "=doc=/hist/history".


            _E_x_a_m_p_l_e_s

                 phist
                 phist -s %se
                 phist -f 12/19


            phist (1)                     - 1 -                     phist (1)




            phist (1) --- print Subsystem history                    12/26/80


                 phist -f 1/31/79 -s stacc -b allen


            _F_i_l_e_s

                 =doc=/hist/history for the history  of  the  Software  Tools
                      Subsystem.


            _M_e_s_s_a_g_e_s

                 "history  file not available" if =doc=/hist/history does not
                      exist or is not readable.
                 "history  file  contains  apocryphal  information"  if   the
                      history file is incorrectly formatted.
                 "<author>:  bad author pattern" if the string following "-b"
                      is not a legal pattern.
                 "<subject>:   bad  subject  pattern" if the string following
                      "-s" is not a legal pattern.
                 "<date>:  bad date" if the  string  following  "-f"  is  not
                      recognizable as a date.
                 "Usage:  phist ..."  for incorrect argument syntax.


            _S_e_e _A_l_s_o

                 history (1), _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m _U_s_e_r_'_s _G_u_i_d_e































            phist (1)                     - 2 -                     phist (1)


