slice2java(1)

💖 slice2java — the Slice → Java compiler, bestie edition 💖

okay so you know how sometimes you just need your Slice files to become Java? yeah. that's this. it's a General Commands Manual page, she's slice2java(1), and she ate fr fr. let's get into it 🫶

---

✨ NAME ✨

slice2java — the Slice to Java compiler. that's it, that's the whole vibe. 👑

---

✨ SYNOPSIS ✨

slice2java [options] [files]

literally just throw your options and your files at her and she'll do the thing 💅

---

✨ DESCRIPTION ✨

so slice2java compiles Slice files to Java. no cap. and while she's doing that compilation, the macro __SLICE2JAVA__ gets defined. that's important, write it down. 📝

the full tea — like, the complete documentation for slice2java — lives online at:

https://doc.zeroc.com/ice/3.7/language-mappings/java-mapping/client-side-slice-to-java-mapping/slice2java-command-line-options

(yeah it's a long one, she's giving very detailed URL energy, we love that for her 🌸)

---

✨ OPTIONS ✨

every single one, in order, no skips, we don't do that here 💖

• -h, --help — shows you a help message. when in doubt, ask for help, it's not embarrassing it's iconic.
• -v, --version — tells you which compiler version you're on. know your queen's era. 👑
• -DNAME — defines the preprocessor symbol NAME. just NAME. no value. bare.
• -DNAME=DEF — defines the preprocessor symbol NAME and gives it the value DEF. now she has range. ✨
• -UNAME — undefines the preprocessor symbol NAME. un-defining. closure. we support it. 🦋
• -IDIR — adds the directory DIR to the search path for #include directives. so when your includes go looking, they know where to look. bestie behavior fr.
• -E — prints the preprocessor output on stdout. raw, unfiltered, no code generation, just the preprocessed truth.
• --output-dir DIR — drops all the generated files into directory DIR. tidy. organized. main character energy. 🎀
• -d, --debug — prints debug information showing what the Slice parser is doing, operation by operation. not me watching the parser think 😭
• --depend — prints dependency information to standard output by default, or to the file given by --depend-file if you specified that. and listen: no code is generated when this option is on. zero. none. she's just here for the deps. 💀
• --depend-xml — same deal but the dependency info comes out in XML format, to standard output by default, or to the file from --depend-file. and again, no code is generated when this option is specified. periodt.
• --depend-file FILE — sends your dependency information to the file FILE. what format you get depends on whether --depend or --depend-xml is also in the mix. they work together, it's a collab. 🤝
• --validate — checks that the command-line options you provided are correct, and generates absolutely no code. just a vibe check on your flags. ✅
• --compat — generates code for the Java Compat mapping. when you use this one, the macro __SLICE2JAVA_COMPAT__ gets defined during compilation. if you don't use it, the default behavior is to generate code for the Java mapping. choose your fighter. ⚔️
• --tie — generates tie classes. heads up: (Java Compat only) 🎀
• --impl — generates sample implementation files. important: this option will not overwrite an existing file. she's respectful like that. 🙈
• --impl-tie — generates sample implementation files using tie classes, and same deal, it will not overwrite an existing file. also (Java Compat only) 🦋
• --checksum CLASS — generates checksums for Slice definitions and puts them into the class CLASS. the class name you give can optionally include a package specifier, so go off. the generated class holds checksums for all of the Slice files being translated by this invocation of the compiler. all of them. every single one. ✨
• --meta META — defines the file metadata directive META. using this option is equivalent to defining the file metadata META in each named Slice file, and in any file included by a named Slice file. and here's the kicker: file metadata specified with --meta overrides any corresponding file metadata directive in the files being compiled. she said mine now. 💅
• --list-generated — emits a list of generated files, in XML format. cute little receipt of everything she made. 🧾

🌈 side note bestie: --depend and --depend-xml both mean no code gets generated, and --validate also generates nothing. don't be surprised when the output dir is empty, it's not a bug it's the design. 💜

---

✨ SEE ALSO ✨

her whole friend group, go say hi 👯‍♀️

• slice2cpp(1)
• slice2cs(1)
• slice2js(1)
• slice2matlab(1)
• slice2objc(1)
• slice2php(1)
• slice2py(1)
• slice2rb(1)
• slice2swift(1)

---

that's the whole page, you understood it, I'm so proud of you 🥹💖 this was slice2java(1), straight out of the General Commands Manual, and that's the sign-off — slice2java(1), periodt. go compile something gorgeous. 🌸🦋✨