RCSIT(1l) UNIX Programmer's Manual RCSIT(1l) NAME rcsit - A program to prepare files for RCS SYNOPSIS rcsit [ -chfsmMxp ] [ -qad ] [ -I_f_l_a_g_s ] [ -R_f_l_a_g_s ] [ -H_d_i_r_e_c_t_o_r_y ] [ -F_h_e_a_d_e_r-_f_i_l_e ] file [ file1 file2 ... ] DESCRIPTION _R_c_s_i_t is a semi-intelligent program to prepare files for _r_c_s(_1). This involves putting the correct type of headings at the top of the file so that _r_c_s(_1) will update a header and log changes in the file. By default, _r_c_s_i_t will use default headers ``hard-wired'' into itself for each different file type that it ``knows'' about. (See below for list of known file types). If the -H_d_i_r_e_c_t_o_r_y option is specified, then _r_c_s_i_t will use ``.header.suffix'' files (where ``suffix'' is a suffix that _r_c_s_i_t ``knows'' about) found in _d_i_r_e_c_t_o_r_y. If a directory name is not specified on the command line, then the environ- ment variable TEMPLATES is used. If TEMPLATES is not set, then the environment varialble, HOME is tried. The following template files are recognized: Template Name File Type ------------------------------------------- .header.c Standard C .header.h C Include .header.f Fortran .header.sh Shell Script .header.make Makefile .header.man Manual .header.p Pascal .header.tex TeX 9 _R_c_s_i_t is ``semi-intelligent'' in that it can guess the type of headers to put in the file by the type of file (C pro- gram, C include, makefile, shell script, or manual). It determines the file type by looking at the name of the file. If the name of the file is ``Makefile'' or ``makefile'', then the file type is taken to be for _m_a_k_e(_1). The suffix after the last ``.'' in the file name is then used. The following table shows the suffixes that _r_c_s_i_t knows about: Suffix File Type ---------------------------------------- c C Program h C Include Printed 1/10/87 1 9 RCSIT(1l) UNIX Programmer's Manual RCSIT(1l) f Fortran mk _M_a_k_e(_1) file sh Shell Script csh Shell Script [1-9] Manual (digits 1 - 9) p Pascal tex TeX 9 If the environment variable ``RCSDIR'' is present, then _r_c_s_i_t will attempt to make a symbolic link from it to ``RCS'' in the current directory if the -_I option is used and there is no directory called ``RCS'' already, in the current directory. If the -_I option is used and ``RCSDIR'' is not specified in the environment, then a normal directory called ``RCS'' will be created. This feature can be over- rided with the -_d option. OPTIONS c Force file type to be ``Standard C''. h Force file type to be ``C Include''. f Force file type to be ``Fortran''. M Force file type to be ``Manual''. Note: If you also specify the ``I_f_l_a_g_s'' option, _r_c_s_i_t will run _r_c_s(_1) to tell rcs what kind of comment string to use for the manual file. s Force file type to be ``Shell Script''. m Force file type to be ``Makefile''. Note that this does the same thing as the -s option does. It just prints a different message. p Force file type to be ``Pascal''. x Force file type to be ``TeX''. F_h_e_a_d_e_r-_f_i_l_e Use _h_e_a_d_e_r-_f_i_l_e as the header file. (i.e. This file is prepended to each of the files to be pro- cessed.) t Do not use any Template files for the headers. q Be quiet. Don't print out what is going on. Only error messages are printed. d Do not attempt to make the directory ``RCS''. See above for more info. 9 Printed 1/10/87 2 RCSIT(1l) UNIX Programmer's Manual RCSIT(1l) a Turn off auto guessing of file type. I_f_l_a_g_s Check In file. Run RCS's _c_i(_1) on the file with ``flags'' being passed onto _c_i(_1) as the command line arguments. R_f_l_a_g_s Run _r_c_s(_1) with ``flags'' as the command line arguments. FILES /tmp/rcsit* - temporary buffer ~/.header.* - template files to use as the header. AUTHOR Michael Cooper (mcooper@usc-oberon.ARPA) SEE ALSO ci(1), make(1), rcs(1) DIAGNOSTICS Complains about the usual stuff. (i.e. - the specified file doesn't exist, or it can't read it...just things like that.) BUGS Acts oddly in the presence of beautiful women. Printed 1/10/87 3