CLOJURE(1)

📦 version 1.12.5, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ CLOJURE(1) ✨

okay bestie, this is the manual page for clojure from the General Commands Manual, section 1. it's giving "your gateway to the JVM" energy and i'm obsessed 💅

🌸 NAME 🌸

clojure — a JVM-based dynamic programming language 💖

🦋 SYNOPSIS 🦋

clojure [-cp/-classpath classpath] [-i/--init path] [-e/--eval expr] {-h
| -r | path | -} [args ...]

like. look at her. the options. the braces. the way she says "pick one of -h, -r, a path, or -". iconic. no notes. ✨

💜 DESCRIPTION 💜

so this manual page documents the clojure command, briefly. quick lil vibe check, nothing too deep 🫶

clojure is the main entry point for Clojure, which is a dynamic programming language that targets the Java Virtual Machine. literally the front door. the main character. 👑

and here's the cute part: with no options and no arguments, she just runs an interactive Read-Eval-Print loop — a REPL — and you get to sit there and vibe with your own code in real time. it's giving instant gratification fr fr 💖

✨ OPTIONS ✨

a summary of options is included below. bestie, we're going through ALL of them, no skipping, i don't play like that 💅

  • -cp, -classpath classpath — specifies additional classpath elements. overrides the $CLASSPATH environment variable. and ⚠️ it must appear first if given — like, before anything else, she needs to be the first one through the door.
  • -i, --init path — load a file or resource at initialisation time. you can say this multiple times if you want, she doesn't mind 🎀
  • -e, --eval string — evaluate expressions in string; print non-nil values. also may be specified multiple times. stack 'em up 🍓
  • -m, --main ns-name — call the -main function from a namespace, with args. your classic "just run the thing" move ✨
  • -r, --repl — run a repl 🔁
  • path — run a script from a file or resource 📄
  • - — run a script from standard input. yes, a single lonely dash. she contains multitudes 💀
  • -h, -?, --help — print a help message and exit. our queen of "idk what's happening" 🫶

🌈 PATH ARGUMENTS 🌈

so a Clojure file can just be handed over as a path argument. easy.

but — plot twist — files to be loaded from the classpath must be prefixed with a @ character, and they must be an absolute path to the classpath resource. not vibes-based. absolute. periodt.

⚠️ also note: the path will be treated as absolute within the classpath, whether it is prefixed with a slash or not. so like, don't come for me about the slash, she's already decided. 💅

and here's the part that makes scripts actually work: clojure binds *command-line-args* to a seq containing the (optional) arguments provided after the path argument. that's the whole trick — it's how you hand command-line arguments to your own scripts. iykyk 😌

🧚 ENVIRONMENT 🧚

a listing of recognised environment variables is included below. there's literally one. she's lowkey mysterious. ✨

  • CLASSPATH — specifies additional classpath elements. (yes, this is the one -cp/-classpath overrides. the drama. the tension. 🍿)

👑 SEE ALSO 👑

clojurec(1).

go read that one too, bestie, we support the whole family 🫶

💖 AUTHOR 💖

clojure is a wrapper script around a Java implementation by Rich Hickey <richhickey@gmail.com>. 🌟

the wrapper script was written by Peter Collingbourne <peter@pcc.me.uk>. 💅

this manual page was written by Peter Collingbourne <peter@pcc.me.uk>, for the Debian project (but may be used by others). so generous. so giving. we love that for them 💜

and that's the whole page, bestie!! 🎀 this was CLOJURE(1) from the General Commands Manual — you found her, you read her, you slayed. now go run a REPL and have the time of your life. byeee 💖✨🦋🌸

📦 where this page comes from