SNOBOL4CTRL(1)

💖 NAME 💖

snobol4ctrl — bestie it's literally just SNOBOL4 control lines, and we're gonna go through every single one of them together, no skips, no cap 🫶✨

---

🎀 DESCRIPTION 🎀

Okay so these are the control lines, they're the little instructions you drop in to tell the compiler how to behave, and there's a LOT of them so grab a snack 🍓. Going in order, all of them, periodt.

• -BLOCKS — Turns the BLOCKS operators ON, see snobol4blocks(1) for the tea. It's a CSNOBOL4 extension, added in CSNOBOL4 version 2.0 ✨
• -CASE — Wanna disable case folding in the compiler? Use -CASE 0. Wanna re-enable it? Use -CASE n, where n is a non-zero integer. It's a SPITBOL? extension, added in CSNOBOL4 version 0.91 💅
• -COPY — A synonym for -INCLUDE, that's it, that's the whole vibe. SPITBOL/370 extension, added in CSNOBOL4 version 0.91.
• -EJECT — Outputs a page break in the listing. Standard. Very demure, very old-school 📄
• -ERRORS — Enables program execution even if the compiler detected errors. Lowkey spicy, because any attempt to execute a statement that has a compiler error will cause a fatal execution error 😭. By default, programs with compiler errors will not be started at all. SPITBOL? extension, added before CSNOBOL4 version 0.90.
• -EXECUTE — Cancels any previous -NOEXECUTE, like a little undo button. SPITBOL extension, added in CSNOBOL4 version 0.98.1 🔥
• -HIDE — Disable listing; statement numbers will not be assigned until the next -LIST directive. It's used for sdb(1) debugger source code, iykyk. CSNOBOL4 Extension, added in version 1.5 🙈
• -INCLUDE — Interpolates the contents of the named file, enclosed in single or double quotes. Trailing spaces are removed from the filename before use. Any filename will be included only once — and yes you can override that by appending a trailing space to the filename, sneaky but valid ✨. If the file is not found in the current working directory, an attempt will be made to find it in the directories specified in the search path. SPITBOL Extension, added in CSNOBOL4 version 0.91 🌸
• -LINE — Takes a line number, and optionally a filename in quotes. It's output by preprocessors to indicate the original source file and line number to be returned by &FILE, &LINE, &LASTFILE and &LASTLINE. SPITBOL Extension, added in CSNOBOL4 version 0.98.2 🦋
• -LIST — Re-enables listing from a previous -UNLIST or -HIDE, welcome back queen 👑. With optional LEFT or RIGHT it controls which side of the page the statement numbers go on. Standard (defaults to LEFT since CSNOBOL4 0.90).
• -NOBLOCKS — Disable the BLOCKS extension. See snobol4blocks(1). CSNOBOL4 extension, added in CSNOBOL4 version 2.0 🚫
• -NOERRORS — Disables the effect of the -ERROR directive. SPITBOL? extension, added before CSNOBOL4 version 0.90.
• -NOEXECUTE — Disables execution of the program. SPITBOL extension, added in CSNOBOL4 version 0.98.1 🛑
• -PLUSOPS — With no argument, or with zero, it disables the SPITBOL extensions listed in snobol4ext(1). With a non-zero integer argument, it re-enables them. SNOBOL4+ extension, added in CSNOBOL4 version 0.98 💜
• -UNLIST — Disable listing. Standard. Bye bye listing 💀

---

🌈 SEE ALSO 🌈

• snobol4(1), snobol4key(1), sdb(1).

---

and that's the whole page bestie, we ate and left no crumbs 💅 This was CSNOBOL4B 2.3.1, dated March 31, 2022 — shoutout to the CSNOBOL4 Manual for having us, mwah 🎀✨