CSI(1)

💖 csi(1) — bestie edition 💖

okay so you opened the manual page for csi, the CHICKEN Scheme interpreter, and honestly? you're about to have the best time. it's a General Commands Manual, and it's giving iconic, periodt. pull up a chair, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

csi — the CHICKEN Scheme interpreter. that's her. that's the whole name. short, sweet, main character energy. 👑

---

🌸 SYNOPSIS 🌸

csi [OPTION ...] [FILENAME ...]

that's the shape of it, bestie. options first, filenames after, or just yolo with no args at all.

---

💅 DESCRIPTION 💅

so csi is an interpreter for the programming language Scheme, and not to brag but she supports most of the features described in the Revised^5 Report on the Algorithmic Language Scheme. R5RS girlies, she sees you. 🫶

and here's the cute part: csi is implemented as a program compiled with the CHICKEN compiler. she's self-made, she's bootstrapped, she's literally that girl.

quick vocab moment so nobody gets lost:

• FILENAME is a Scheme source file name with optional extension.
• OPTION may be one of the following (and yes, we're doing ALL of them, no skipping, i don't gatekeep):

---

🎀 OPTIONS 🎀

• -h, -help — display usage and dip. short and sweet. ✨
• -version — display version and dip.
• -release — print the release number and dip. (yes it's different from -version, don't @ me)
• -i, -case-insensitive — enable case-insensitive reading. she's not picky about your caps, slay. 💅
• -e EXPRESSION, -eval EXPRESSION — evaluate the given expression. just run it, no thoughts.
• -p EXPRESSION, -print EXPRESSION — evaluate the given expression and print the result(s). showing her work, love that. 🌟
• -P EXPRESSION, -pretty-print EXPRESSION — evaluate and print result(s) prettily. it's the same but with a glow-up. ✨
• -D SYMBOL, -feature SYMBOL — register feature identifier. adding to the vibe list.
• -no-feature SYMBOL — disable built-in feature identifier. taking it off the vibe list. 💀
• -q, -quiet — do not print banner. no intro, we're getting straight to the point. 🙈
• -n, -no-init — do not load the initialization file, .csirc. skipping the pre-game.
• -b, -batch — terminate after command-line processing. one and done, bye bestie. 👋
• -w, -no-warnings — disable all warnings. living dangerously, i respect it. 😭
• -K STYLE, -keyword-style STYLE — enable alternative keyword-syntax. the options are prefix, suffix or none. pick your fighter. 🔥
• -no-parentheses-synonyms — disable list delimiter synonyms. parens stay parens, no substitutes.
• -no-symbol-escape — disables support for escaped symbols. the backslash era is over, sorry. 💀
• -r5rs-syntax — disable the CHICKEN extensions to R5RS syntax. going full purist, no cap.
• -s PATHNAME, -script PATHNAME — use interpreter for shell scripts. she contains multitudes. 🐚
• -ss PATHNAME — run a script with a main procedure. the formal version, she has structure.
• -sx PATHNAME — same as -s, but print each expression as it is evaluated. live commentary mode, obsessed. 👀
• -setup-mode — prefer the current directory when locating extensions. home turf advantage.
• -R NAME, -require-extension NAME — import extension before executing code. grabbing the aux cord before the song starts. 🎧
• -I PATHNAME, -include-path PATHNAME — add PATHNAME to the include path. one more place to look, she's thorough.
• -- — ignore all following options. everything after this is Not An Option, fr fr.

---

🌈 ENVIRONMENT 🌈

the following environment variables change the behaviour of csi:

• CSI_OPTIONS — when set to a string of command-line options, then the options are passed implicitly to every direct or indirect invocation of csi. it's like a lil outfit she wears to every event. 💖

⚠️ important heads up: runtime options of the form -:⟨OPTIONS⟩ cannot be passed using this method. sorry bestie, those ones don't fit in the bag.

• CHICKEN_INCLUDE_PATH — contains one or more pathnames where the interpreter should also look for include files, separated by ; characters. semicolon-separated, don't use commas, i beg. 🧚

---

🦋 FILES 🦋

• $XDG_CONFIG_HOME/chicken/csirc — Scheme file loaded on startup. ($XDG_CONFIG_HOME defaults to $HOME/.config.) the modern girlie config location. ✨
• $HOME/.csirc — Scheme file loaded on startup if the previous one doesn't exist. the fallback queen. 👑

---

⭐ EXIT STATUS ⭐

the csi utility exits 0 on success, and >0 if an error occurs. clean exit, clean conscience. 💅

---

💜 SEE ALSO 💜

• chicken(1)
• csc(1)

more information can be found in the CHICKEN User's Manual: http://wiki.call-cc.org/manual/index — go read it, iykyk. 📚

---

👑 AUTHORS 👑

The CHICKEN Team. legends, honestly. no notes. 🫶

---

💀 BUGS 💀

submit bug reports by e-mail to chicken-janitors@nongnu.org. don't be mean about it, they're doing their best. 🙈

---

and that's the whole page, bestie!! this manual came to you from Debian, dated Apr 26, 2017, so if you're reading this, just know she's been serving since 2017 and she's still that girl. mwah 💖✨ bye! 🎀