phist (1) --- print Subsystem history 12/26/80 _U_s_a_g_e phist { -b | -f | -s | -q } [-i ] ::= | / | // _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 " argument sequence may be specified to restrict the entries printed to those written by a given author. The syntax of 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 " argument sequence tells 'phist' that only those entries concerning the specified subject should be printed. may also be an arbitrary pattern. The "-f " sequence allows the user to tell 'phist' that he only wants to see entries written on or after a specific date. The format of 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 " is specified, 'phist' takes its input from , 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. ": bad author pattern" if the string following "-b" is not a legal pattern. ": bad subject pattern" if the string following "-s" is not a legal pattern. ": 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)