MAVEN(1)

💅 MAVEN(1) — User Commands, but make it cute

okay so bestie, welcome to the MAVEN page 🎀 this is one of those User Commands situations, and honestly? it's giving "tiny script, huge responsibility." she makes a link in /usr/share/maven-repo for a jar that already exists. that's the whole vibe. let's get into it 🫶

---

✨ NAME ✨

Maven — Creates a link in /usr/share/maven-repo for an existing jar. periodt. that's her whole job and she does it flawlessly 💅

---

🦋 SYNOPSIS 🦋

mh_linkjar [option]... [pom] [dest_jar] [link]...

look at her. little command, big dreams ✨

---

🌸 DESCRIPTION 🌸

so what we're doing here is creating symlinks for a jar that got installed by other means. the symlinks she makes include links to the jar inside /usr/share/maven-repo, and she puts them at the correct location for Maven, no cap. she can also create extra links to the jar, which are usually chillin' over in /usr/share/java 💖

Where:

• [pom] — this is the location of the POM that's associated with the jar you're installing. and listen: the GroupId, artifactId and version get extracted from this file. she reads it. she knows. 👑
• [dest_jar] — the path of the installed jar, which is usually located in the usr/share/java folder. (yes bestie, that's exactly how it's written in the original, i'm not touching it 🙈)
• [link] — an extra link to the jar you're installing. usually there should be a link to usr/share/java/$jar.jar and usr/share/java/$jar-$version.jar so you comply with the Java packaging guidelines 📦✨ and heads up: there is no need to specify those particular links if you use the --java-lib option. she'll handle it. she's got you.

---

💖 OPTIONS 💖

• -h, --help — show this text 🥰 (yes, the text you are literally reading the vibe of right now)
• -V, --version — show the version, so you know which queen you're talking to 👑
• -p<package>, --package=<package> — name of the Debian package which will contain this jar file 📦
• -e<version>, --set-version=<version> — set the version for the jar. do not use the version declared in the POM file — like, she's overriding it, on purpose, respectfully 💀
• -r<rules>, --rules=<rules> — path to the file containing the rules to apply when cleaning the POM. it's optional, and the default location is debian/maven.rules. Maven rules are used here to extract the groupId, artifactId and version from the POM file 🔍✨
• -l, --java-lib — optional! if you give her this, she'll install the jar into /usr/share/java to comply with the Debian Java specification. the jar gets installed as /usr/share/java/$name-$version.jar, and a versionless link /usr/share/java/$name.jar will point to it, as well as the links installed in /usr/share/maven-repo 🎀
• -n<name>, --usj-name=<name> — optional, the name to use when installing the library in /usr/share/java when --java-lib is used. defaults to the artifact id found in the POM 🌸
• -j<version>, --usj-version=<version> — optional, the version to use when installing the library in /usr/share/java when --java-lib is used. defaults to the version found in the POM 🦋
• -s, --no-usj-versionless — optional, don't install the versionless link in /usr/share/java. this flag is used only when the -l or --java-lib option is given 🚫
• -c<classifier>, --classifier=<classifier> — optional, the classifier for the jar. empty by default 🫧
• -v, --verbose — show more information while running. she gets chatty. it's cute 🗣️💬
• -n, --no-act — don't actually do anything, just print the results 👀 (and yes bestie, the original page really does use -n twice — once for --usj-name and once for --no-act. i'm just the messenger 🙈 iykyk)
• --skip-clean-pom — don't clean the pom, assume that a previous action ran mh_cleanpom with the correct options. mh_cleanpom is run only to extract the groupId, artifactId and version of the jar 🧼❌

---

⚠️ reminder bestie: -e / --set-version means you are not using the version from the POM, and --skip-clean-pom means you're trusting that mh_cleanpom already ran correctly. know what you're asking for 💅

---

and that's the whole page, fr fr 🫶 this was Maven Repo Helper version 1.7.1, from September 2025 — iconic behavior, no notes, ate and left absolutely zero crumbs 👑✨ bye bestie, go make some symlinks 💖