RHINO-JSC(1)

✨ RHINO-JSC(1) ✨

okay so this is the manual for rhino-jsc, bestie — it lives in the General Commands Manual section and it's giving "let me translate your JavaScript into Java class files" energy 💅

---

🎀 NAME 🎀

rhino-jsc — she invokes the rhino JavaScript compiler. that's the whole job description, and she does it flawlessly 💖

---

🦋 SYNOPSIS 🦋

rhino-jsc [options] file1.js [file2.js...]

so like, options first, then as many .js files as your little heart desires 🫶

---

🌸 DESCRIPTION 🌸

okay so real talk — this manual page is a brief lil rundown of the rhino-jsc command. it was written for the Debian distribution because the original program straight up does not have a manual page (not a single one, we were left on read 😭). so this was written according to the html documentation. periodt.

rhino-jsc is a start script for the rhino JavaScript compiler. and what does that compiler do? it translates JavaScript source into Java class files. those resulting Java class files can then be loaded and executed at another time — which is a convenient method for transferring JavaScript, and also for avoiding translation cost. slay, efficiency, we love her 💅

⚠️ important bestie: the top-level functions available to the shell (such as print) are not available to compiled scripts when they are run outside the shell. no cap. so don't come crying to me when print ghosts you 🙈

---

💖 OPTIONS 💖

• -version versionNumber — specifies the language version to compile with. the string versionNumber has to be one of 100, 110, 120, 130, 140, 150, 160 or 170. see JavaScript Language Versions for more info on language versions. pick your fighter ⭐
• -opt, -O optLevel — optimizes at level optLevel, which must be an integer between 0 and 9. the higher the number the more she's doing, iykyk 🔥
• -debug, -g — specifies that debug information should be generated. may not be combined with optimization at an optLevel greater than zero. so it's giving "pick a lane, bestie" 💀
• -nosource — does not save the source in the class file. functions and scripts compiled this way cannot be decompiled. so you can use this to avoid distributing source, or simply to save space in the resulting class file. iconic privacy move tbh 🕵️♀️
• -o outputFile — writes the class file to the given file (which should end in .class). the string outputFile must be a writable filename. name her right and make sure she's writable 💜
• -package packageName — specifies the package to generate the class into. the string packageName must be composed of valid identifier characters optionally separated by periods. like com.example.whatever, you get it 🌈
• -d outputDirectory — uses outputDirectory as the destination directory for generated classes. if omitted, it defaults to the parent directory of the source file. lowkey a thoughtful default ngl 🎀
• -encoding charset — sets the character encoding of the source files. tell her how to read the vibes ✨
• -extends java_class_name — specifies that a java class extending the Java class java_class_name should be generated from the incoming JavaScript source file. each global function in the source file is made a method of the generated class, overriding any methods in the base class by the same name. inheritance but make it ✨drama✨
• -implements java_intf_name — specifies that a java class implementing the Java interface java_intf_name should be generated from the incoming JavaScript source file. each global function in the source file is made a method of the generated class, implementing any methods in the interface by the same name. she said "I will commit to this interface" 🫶
• -main-method-class className — specifies the class name used for main method implementation. the class must have a method matching public static void main(Script sc, String[] args). no shortcuts, that's the exact signature, don't freestyle it 💅
• -observe-instruction-count — generates code that contains callbacks to accumulate counts of executed instructions. code compiled with this flag can be monitored using Context.setInstructionObserverThreshold. she's watching, she's counting, she's tracking 👑👀

---

🧚 EXAMPLE 🧚

example compiling the NervousText.js applet written in JavaScript. the example is provided in the librhino-java-doc package. (yes it's spelled NervousText, she's anxious, leave her alone 😭)

$ rhino-jsc -extends java.applet.Applet -implements java.lang.Runnable NervousText.js

look at her go 🦋

---

💜 SEE ALSO 💜

the online documentation under https://developer.mozilla.org/en-US/docs/Mozilla/Projects/Rhino/JavaScript_Compiler — go read it, it's free, it's right there, drink water and read the docs 💖

---

🌟 AUTHOR 🌟

this manual page was written by Wolfgang Baer <WBaer@gmx.de>, for the Debian project (but may be used by others). king behavior, writing the docs the original never wrote 👑

---

and that's the whole thing bestie — RHINO-JSC(1), straight from the General Commands Manual, written for the Debian distribution, and now rewritten with love by your favorite unix girly 💅🎀🦋✨💖

go compile something iconic today, and remember: no cap, only class files 💖