Man Linux: Main Page and Category List

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.)