TFRT(1)

πŸ’– TFRT(1) β€” the cutest little function-refinement-tree editor in the whole General Commands Manual, no cap ✨

okay bestie, sit DOWN because we're about to talk about tfrt, and she is genuinely iconic. this page lives in the General Commands Manual section, which is giving very much "we're a real tool, not a toy" energy. πŸ’…


🌸 NAME 🌸

tfrt β€” Tool for Function Refinement Trees πŸŽ€

she's exactly what she says on the tin, and honestly? that's the vibe.


πŸ¦‹ SYNOPSIS πŸ¦‹

tfrt [options] [tree]

literally just that. options, and maybe a tree if you're feeling generous. 🫢


✨ DESCRIPTION ✨

so tfrt is an X11/Motif based graphical editor for drawing function decomposition trees. it's got a whole GUI and everything, very main character.

trees can be loaded from and stored to a file. πŸ“‚ she can also print trees to a PostScript printer, or save them as PostScript to a file β€” whichever fits the moment.

and bestie, she's not out here alone: tfrt is part of The Toolkit for Conceptual Modeling (TCM). we love a collaborative queen. πŸ‘‘


πŸ’… ARGUMENTS πŸ’…

you can call tfrt with a single tree name as argument. one. that's the limit. she's not greedy. 😌

here's the tea on what happens:

  • if that argument is an existing file, then tfrt tries to load a tree from it. easy.
  • if it does not exist, a new tree is created with the argument as tree name. cute, she just made it up on the spot.
  • tfrt files should have suffix *.frt. that's the moment. that's the extension. iykyk. πŸ’–

and if you pass no tree argument at all? no worries, she creates a new empty function decomposition tree with the name untitled.frt. everyone starts somewhere bestie. 🌱


⭐ OPTIONS ⭐

okay so in addition to the standard X11 toolkit options (go read X11(7) if you want those, not my problem today), tfrt accepts the options listed below. and yes, we're doing all of them. every single one. periodt.

  • -drawing widthxheight β€” create a drawing area of width pixels wide and height pixels high. size matters, and she's letting you pick. πŸ“
  • -help β€” write all available options to standard output and quit. the "just tell me what you can do" button. so valid. πŸ₯Ί
  • -maxdrawing widthxheight β€” the drawing area can not be larger than width pixels wide and height pixels high. she has boundaries. we respect them. 🚧
  • -priv_cmap β€” start the editor with a private colormap. fancy. exclusive. a little selfish in the best way. πŸ’…
  • -projdir directory β€” set the project directory (current working directory) to directory. like, we're relocating, and we're thriving. πŸ“
  • -toEPS [file.eps] β€” generate EPS (to file.eps, or to stdout when no file name was given) and quit. oh and she quits after. dramatic exit, love that for her. ✨
  • -toFig [file.fig] [-latex] β€” generate Fig format (to file.fig, or to 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. and get this β€” the Fig format can be read by xfig(1) and fig2dev(1). networking! 🀝
  • -toPNG file.png β€” generate PNG format to file.png and quit. png for the girlies who need a screenshot. πŸ–ΌοΈ
  • -toPS [file.ps] β€” generate PostScript (to file.ps, or to stdout when no file name was given) and quit. old school, still slays. πŸ–¨οΈ
  • -version β€” write the TCM version to standard output and quit. know your roots. 🌈

πŸ’œ ENVIRONMENT πŸ’œ

environment variables, bestie. she reads them. she needs them. let's go:

  • TCM_HOME β€” should be the directory where the TCM files are installed. her home base. 🏠
  • PATH β€” should include $TCM_HOME/bin
  • MANPATH β€” should include $TCM_HOME/man
  • PRINTER β€” name of the default printer that is used by tfrt. πŸ“ 
  • LD_LIBRARY_PATH β€” should include $TCM_HOME/lib when the distribution contains shared object libraries in $TCM_HOME/lib. shared libs need love too. 🧚

πŸŽ€ FILES πŸŽ€

the following relative files are relative to $TCM_HOME. noted. important. don't forget.

  • bin/tfrt β€” the function decomposition tree editor. that's her. the icon herself. πŸ‘‘
  • bin/psf β€” a program to filter PostScript output. the little helper. 🫢
  • lib/banner.ps β€” PostScript banner page that can be used when the printer does not print a banner page. because sometimes the printer is lazy and we pick up the slack. 🏳️
  • lib/help/* β€” the help directory contains a collection of text files for the on-line help. self-explanatory, but we love her for it. πŸ“š
  • 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. make it yours. 🎨
  • /tmp/tcmXXXXXX β€” pseudo random temporary file, for PostScript output. temporary, but make an impact. πŸ’«
  • 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. the group chat settings, basically. πŸ’¬
  • $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 touches. your era. 🌸

🫢 SEE ALSO 🫢

go read this, it's giving required reading:

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.

and the friend group:

tcm(1), X11(7), xfig(1), fig2dev(1)


🌈 AUTHOR 🌈

Frank Dehne (frank@cs.vu.nl). thank you for your service, king. 🫑


πŸ’€ BUGS πŸ’€

bestie, if something's broken, please send bug reports to tcm@cs.utwente.nl. don't suffer in silence, that's not the vibe. πŸ™ˆ


that's the whole page, and honestly? she ate. no notes. πŸ’–

cute little sign-off moment: this whole thing is from 9 January 2000, and it belongs to TFRT(1) in the General Commands Manual. old but gold, fr fr. πŸŽ€βœ¨