JARDIFF(1)

📦 version 0.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 JARDIFF(1) — User Commands 💖

okay bestie, sit down, hydrate, because we're about to talk about jardiff, a little icon from the User Commands section of the manual. it's giving "quiet overachiever" and honestly? obsessed. 🫶

✨ NAME ✨

jardiff — a tool to visualise API differences between two JAR files 🍓

like... it literally looks at two JARs and tells you what changed API-wise. no cap. that's the whole job and she does it. 💅

🌸 DESCRIPTION 🌸

here's the vibe, the whole entire mood, the usage line in all its glory:

usage: jardiff -f <from jar> -t <to jar> [-F <from name>] [-T <to name>]
[[-o <xml|html|xhtml|text>]|[-x <xsl file>]] [-O <file>] [-s <href>]
[-fa <href>] [-ta <href>]

so you need a from jar and a to jar, everything else is optional and just makes her prettier. 🦋

now the options, and yes, we're doing all of them, because skipping options is not the move:

  • -f, --from <arg> — the from jar file. the "before" pic. the origin story. ✨
  • -F, --from-name <arg> — the from name. what you wanna call that from side.
  • -fa, --from-api <arg> — relative location of the from api.
  • -h, --help — prints help on the command line arguments. she will explain herself if you just ask. 😭
  • -o, --output-format <arg> — the output format, xml or html.
  • -O, --out <arg> — the output file. where the magic goes. 💾
  • -s, --stylesheet <arg> — stylesheet to link to when generating html. slay, give her a lewk. 💅
  • -T, --to-name <arg> — the to name. label for the "after" side.
  • -t, --to <arg> — the to jar file. the "after" pic. the glow-up. 👑
  • -ta, --to-api <arg> — relative location of the to api.
  • -x, --xsl <arg> — custom xsl sheet to format output with. for the girlies who want full creative control. 🎀
heads up bestie: in that usage line, -o and -x are written as alternatives to each other — [[-o <xml|html|xhtml|text>]|[-x <xsl file>]] — so don't come for me if you try to run both at once, okay? 😭 that's literally what the usage says.

and that's the whole page, no crumbs left behind. this gorgeous little manual came from Debian and it's dated August 2008 — yes, she's been iconic since before some of us could read. periodt. 🫶✨🎀

📦 where this page comes from