ftjam(1)

💖 ftjam — Make(1) Redux 💖

okay bestie, welcome to the ftjam manual page, living in section 1 of the General Commands Manual 🎀 yes this is THE Jam/MR situation and it is lowkey iconic. sit down, hydrate, let's go 🦋

---

✨ NAME ✨

Jam/MR — it's literally Make(1) Redux 💅 like make but with a whole glow-up.

---

✨ SYNOPSIS ✨

ftjam [-a] [-g] [-n] [-q] [-v] [-d debug] [-f jambase] [-j jobs]
      [-o actionsfile] [-s var=value] [-t target] [target ...]

that's the whole vibe check right there ⭐

---

✨ DESCRIPTION ✨

so Jam is a program construction tool, like make(1) but with ✨main character energy✨.

Jam recursively builds target files from source files, using dependency information and updating actions expressed in the Jambase file — and the Jambase is written in jam's own interpreted language 🌈 no cap, it has its own language, she's talented like that.

The default Jambase is compiled into jam and gives you a boilerplate for common use, relying on a user-provide file "Jamfile" to enumerate the actual targets and sources. (yes the original says "user-provide", we're keeping it, it's part of the lore 🙈)

---

✨ OPTIONS ✨

• -a — build all targets anyway, even if they're already up-to-date. she does not care about your timestamps, she's building regardless 💅
• -d n — enable cummulative debugging levels from 1 to n. the interesting values are:
  • 1 — show actions (this is the default)
  • 2 — show "quiet" actions and display all action text
  • 3 — show dependency analysis, and target/source timestamps/paths
  • 4 — show shell arguments
  • 5 — show rule invocations and variable expansions
  • 6 — show directory/header file/archive scans
  • 7 — show variable settings
  • 8 — show variable fetches
  • 9 — show variable manipulation, scanner tokens
• -d +n — enable debugging level n.
• -d 0 — turn off all debugging levels. only errors are not suppressed 🫶
• -f jambase — read jambase instead of using the built-in Jambase. only one -f flag is permitted, but the jambase may explicitly include other files.
• -g — build targets with the newest sources first, rather than in the order of appearance in the Jambase/Jamfiles. glow-up ordering ✨
• -j n — run up to n shell commands concurrently (UNIX and NT only). the default is 1.
• -n — don't actually execute the updating actions, but do everything else. this changes the debug level default to -d2. it's giving dress rehearsal 🎀
• -o file — write the updating actions to the specified file instead of running them (or outputting them, as on the Mac).
• -q — quit quickly (as if an interrupt was received) as soon as any target build fails. she's out, bye 💀
• -s var=value — set the variable var to value, overriding both internal variables and variables imported from the environment. overriding both, periodt 👑
• -t target — rebuild target and everything that depends on it, even if it is up-to-date.
• -v — print the version of ftjam and exit.

---

✨ SEE ALSO ✨

ftjam is documented fully in HTML pages available on Debian systems from /usr/share/doc/ftjam/Jam.html 🌸 go read, bestie, the full lore is in there.

---

✨ AUTHOR ✨

This manual page was created by Yann Dirson dirson@debian.org from the Jam.html documentation, for the Debian GNU/Linux system (but may be used by others). 🫶 shoutout to Yann, absolutely ate.

---

okay and that's the whole page!! tysm for reading my little ftjam(1) explainer, from the General Commands Manual, version/date tag ftjam(1) and all 💖 go build something gorgeous, ily, bye 🦋✨🎀