atfsit(1)

✨ atfsit — A program to prepare files for version control ✨

okay bestie, gather round, because atfsit is one of those ShapeTools girlies that quietly does SO much and nobody ever talks about her?? we're fixing that today 💅

---

🎀 SYNOPSIS 🎀

atfsit [ -cFhfsmM ] [ -qad ] [ -Iflags ] [ -Rflags ] [ -tdirectory ]
file1 ...

like, yes, that's a lot of flags. no, you don't have to use all of them. breathe 🫶

---

🦋 DESCRIPTION 🦋

Atfsit is a semi-intelligent program that gets your files ready for ShapeTools version control. the whole vibe is: she puts the correct type of headings at the top of your file so that retrv can update a header and log changes in the file. iconic behaviour, honestly.

by default, atfsit uses default headers that are hard-wired'' into herself for each different file type she knows'' about. (the list of known file types is right down below, don't worry 💖)

if you specify the -tdirectory option, then atfsit will use .template.suffix'' files (where suffix'' is a suffix that atfsit ``knows'' about) found in directory. if you don't give a directory name on the command line, then the environment variable TEMPLATES gets used instead. and if $TEMPLATES isn't set, then she tries the environment variable HOME. she's resourceful like that 🌸

here are the template files she recognizes:

• .template.c — Standard C
• .template.h — C Include
• .template.f — Fortran
• .template.sh — Shell Script
• .template.make — Makefile
• .template.man — Manual

atfsit is semi-intelligent'' in that she can *guess* the type of headers to put in the file based on the type of file (C program, C include, makefile, shell script, or manual). she figures out 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)`. after that, the suffix after the last .'' in the file name gets used. here's the tea on the suffixes she knows about:

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

now, 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's no directory called AtFS'' already sitting in the current directory. and if the `-I` option is used but ATFSDIR'' is not specified in the environment? then a normal directory called ``AtFS'' will just be created. cute, right? you can override this whole feature with the -d option 💜

---

💅 OPTIONS 💅

• -c — Force file type to be ``Standard C''.
• -F — Force file type to be ``Standard C''. also adds a special header-line for recording compile-time options on top of the default header. the inserted line has the form static char *ConfFlg = CFFLGS. CFFLGS must be a string value. and because it's very inconvenient to define the proper value of CFFLGS from the command-line, this feature is more intended to be used from within Makefiles. iykyk 🔥
• -h — Force file type to be ``C Include''.
• -f — Force file type to be ``Fortran''.
• -M — Force file type to be Manual''. > heads up bestie: 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. same energy, different font 💀
• -t — Do not use any Template files for the headers.
• -q — Be quiet. don't print out what's going on. only error messages get printed. the strong silent type 😌
• -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.) she's not dramatic, she's just honest 😭

---

and that's the whole page, bestie!! this one is atfsit-1.15, dated Tue Jun 29 16:29:16 1993, and it came to you straight from ShapeTools. go forth and prepare those files for version control, you absolute main character 🦋✨