TTUT(1)

💖 TTUT — bestie edition 💖

okay so this is the manual page for ttut, aka the Tool for Transaction-Use Tables — and no, I did not make that acronym up, it's literally what it stands for. it lives in the General Commands Manual section, and we're gonna go through the whole thing together. grab a snack. 🍓

---

✨ NAME ✨

ttut — Tool for Transaction-Use Tables. that's the whole vibe. iconic. 👑

---

🌸 SYNOPSIS 🌸

ttut [options] [document]

yes bestie, it's that simple. options, maybe a document, done. 💅

---

🦋 DESCRIPTION 🦋

ttut is an X11/Motif based graphical editor for drawing transaction-use tables. like, an actual GUI, with windows and everything. it's giving 90s but make it work.

Documents can be loaded from and stored to a file. it can also print documents to a PostScript printer, or save as PostScript to a file — so you're never trapped. 🖨️

and here's the lore: ttut is part of The Toolkit for Conceptual Modeling (TCM). it's a whole family, and this is one of the siblings. 👯

---

🎀 ARGUMENTS 🎀

You can call ttut with a single document name as argument. here's how that goes:

• if that argument is an existing file, then ttut tries to load a document from it.
• if it does not exist, a new document is created, with the argument as the document name.

and important: ttut files should have suffix *.tut. that's the signature. no cap.

Without a document name as argument, ttut creates a new transaction-use table with the name untitled.tut. she's fresh out the box, nameless but full of potential. 😭✨

On top of the standard X11 toolkit options (peep X11(7) for those), ttut also accepts the options listed below:

---

💅 OPTIONS 💅

• -cell widthx*height* — Sets the minimal cell size of the editor to width pixels wide and height pixels high. The cells in the initial table have the minimal size. so like, how smol can a cell get? this much. 📐
• -drawing widthx*height* — Create a drawing area of width pixels wide and height pixels high.
• -help — Write all available options to standard output and quit. your little helper bestie. 🫶
• -maxdrawing widthx*height* — The drawing area can not be larger than width pixels wide and height pixels high. it's a hard ceiling, fr fr.
• -priv_cmap — Start the editor with a private colormap. fancy colors, just for you. 🌈
• -projdir directory — Set the project directory (current working directory) to directory.
• -table rowsx*columns* — The table editor will be initialized with a table having rows rows and columns columns. By default the initial table has 7 rows and 7 columns. lucky number seven, twice. 🍀
• -toEPS [file.eps] — Generate EPS (to file.eps or stdout when no file name was given) and quit.
• -toFig [file.fig] [-latex] — Generate Fig format (to file.fig or stdout when no file name was given and quit. When the -latex option is given, LaTeX fonts are generated, otherwise normal PostScript fonts are generated. The Fig format can be read by xfig(1) and fig2dev(1). cross-compatible, we love to see it. 🤝
• -toPNG file.png — Generate PNG format to file.png and quit.
• -toPS [file.ps] — Generate PostScript (to file.ps or stdout when no file name was given) and quit.
• -version — Write the TCM version to standard output and quit.

---

🌿 ENVIRONMENT 🌿

• TCM_HOME — should be the directory where the TCM files are installed. your home base. 🏠
• PATH — Should include $TCM_HOME/bin
• MANPATH — Should include $TCM_HOME/man
• PRINTER — Name of the default printer that is used by ttut. the one who actually prints. 🖨️
• LD_LIBRARY_PATH — Should include $TCM_HOME/lib when the distribution contains shared object libraries in $TCM_HOME/lib.

---

🌸 FILES 🌸

The following relative files are relative to $TCM_HOME. (say that five times fast, jk, don't.)

• bin/ttut — the transaction-use table editor. that's her. that's the girl. 👑
• bin/psf — a program to filter PostScript output.
• lib/banner.ps — PostScript banner page that can be used when the printer does not print a banner page. so you get a banner anyway. slay.
• lib/help/* — The help directory contains a collection of text files for the on-line help.
• lib/TCM — X Resources (the same as the ones that are built-in). You can customize the fonts and colors by setting resources in your X defaults database. Each string of the form `TCM.resource:definition` sets a resource.
• /tmp/tcmXXXXXX — Pseudo random temporary file, for PostScript output.
• lib/tcm.conf — TCM editor configuration file. This file contains values for some of the editor defaults like the page size, the default fonts etc. This file is read by each editor upon startup. it's read on every single startup, so whatever you put in there, she'll see it. 👀
• $HOME/.tcmrc — Each user of TCM can override some of the options of tcm.conf by its own configuration file, installed in $HOME/.tcmrc. your personal era. ✨

---

🔥 SEE ALSO 🔥

Frank Dehne, Roel Wieringa and Henk van de Zandschulp — TCM (Toolkit for Conceptual Modeling), User's Guide and Reference. This document is available as PostScript and HTML in $TCM_HOME/doc or as HTML via the URL:

http://www.cs.utwente.nl/~tcm/tcm-usersguide.html

also go check out: tcm(1), X11(7), xfig(1), fig2dev(1). the whole friend group. 🫂

---

🧚 AUTHOR 🧚

Frank Dehne (frank@cs.vu.nl). thank you for your service. 🫡

---

💀 BUGS 💀

Please send bug reports to tcm@cs.utwente.nl. don't be shy, they want to know. 🙈

---

ok that's the whole page, you made it, I'm so proud of you. now go draw some transaction-use tables. 💜

and finally, the cute little sign-off at the bottom of the original page: this one's from 9 January 2000, and it belongs to the TTUT(1) page itself — vintage, but still hitting. 🎀🦋