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, 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 make(1). The
suffix after the last ‘‘.’’ in the file name is then used. The
following 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
‘‘ATFSDIR’’ 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 inconvenient, to define the proper value of CFFLGS from
the command-line, this feature is more intended to be used
from within Makefiles.
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
message.
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.)