|
|
atfsit(1) ShapeTools atfsit(1) NAME
atfsit - A program to prepare files for version control SYNOPSIS
atfsit [ -cFhfsmM ] [ -qad ] [ -Iflags ] [ -Rflags ] [ -tdirectory ] file1 ... DESCRIPTION
Atfsit is a semi-intelligent program to prepare files for ShapeTools version control. This involves putting the correct type of headings at the top of the file so that retrv will update a header and log changes in the file. By default, atfsit 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 -tdirectory option is specified, then atfsit will use ``.template.suffix'' files (where ``suffix'' is a suffix that atfsit ``knows'' about) found in directory. If a directory name is not specified on the command line, then the environment variable TEMPLATES is used. If $TEMPLATES is not set, then the environment variable, HOME is tried. The following template files are recognized: Template NameFile Type --------------------------------------- .template.c Standard C .template.h C Include .template.f Fortran .template.shShell Script .template.makeMakefile .template.manManual Atfsit is ``semi-intelligent'' in that it can guess the type of headers to put in the file by the type of file (C program, C include, make- file, 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 make(1). The suffix after the last ``.'' in the file name is then used. The fol- lowing table shows the suffixes that atfsit knows about: Suffix File Type --------------------------------------------- c C Program F C Program (with compile flags) h C Include f Fortran mk Make(1) file sh Shell Script csh Shell Script [1-9] Manual (digits 1 - 9) If the environment variable ``ATFSDIR'' is present, then atfsit will attempt to make a link from it to ``AtFS'' in the current directory if the -I option is used and there is no directory called ``AtFS'' already, in the current directory. If the -I option is used and ``ATFS- DIR'' is not specified in the environment, then a normal directory called ``AtFS'' will be created. This feature can be overrided with the -d option. OPTIONS
c Force file type to be ``Standard C''. F Force file type to be ``Standard C''. Add a special header-line for recording of compile-time options in addition to the default header. The inserted line has the form static char *ConfFlg = CFFLGS. CFFLGS must be a string value. As it is very inconve- nient, to define the proper value of CFFLGS from the command-line, this feature is more intended to be used from within Make- files. 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 ``Iflags'' option, atfsit will run vadm(1) to tell ShapeTools 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 mes- sage. 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 ``AtFS''. See above for more info. a Turn off auto guessing of file type. Iflags Check In file. Run save(1) on the file with ``flags'' being passed onto save(1) as the command line arguments. Rflags Run vadm(1) with ``flags'' as the command line arguments. FILES
/tmp/atfsit* - temporary buffer ~/.template.* - template files to use as the header. AUTHOR
Michael Cooper (mcooper@usc-oberon.ARPA) Modified for use with ShapeTools by Axel.Mahler@cs.tu-berlin.de SEE ALSO
save(1), vadm(1), retrv(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.) atfsit-1.15 Tue Jun 29 16:29:16 1993 atfsit(1)