MAVEN(1)

📦
version 1.12 · 3 versions
, in ubuntu resolute, ubuntu stonking

💖 MAVEN — like, the manual page, bestie 💖

okay so real talk: this is the man page for Maven (the mh_patchpoms tool from Maven Repo Helper), a lil script that patches POM files using the Maven dependency rules. It lives in the User Commands section of the manual, and honestly? She's niche but she's everything if you're doing Debian Java packaging. 🎀

✨ NAME ✨

Maven — patches the POM files using the Maven dependency rules. that's it, that's the whole job description, and she does it flawlessly 💅

🌸 SYNOPSIS 🌸

mh_patchpoms [option]...

yeah, that's the whole vibe. options go in, magic comes out ✨

🦋 DESCRIPTION 🦋

okay so here's the tea 🍵 — this thing reads the file debian/$package.poms, and then it takes every single POM file that's listed inside that .poms file and transforms it into a POM file that uses the Debian versions of the libraries. glow-up, but for XML. 💖

and because she's a considerate queen, she also keeps a backup of every POM file she touches, so you can always undo it with mh_unpatchpoms. no cap, always have a safety net bestie 🫶

👑 OPTIONS 👑

  • -h, --help — show this text. the classic "help me pls" move 🙈
  • -V, --version — show the version. slay, now you know what you're running ⭐
  • -p<package>, --package=<package> — the package to act on. tell her who she's working with 💅
  • -k, --keep-pom-version — keeps the original version of the POMs, BUT converts all the other versions in dependencies and plugins. and if there's a parent POM? she keeps its version too — except when that parent is already registered in the Maven repository. iykyk, it's giving nuance 🌈
  • -e<version>, --set-version=<version> — set the version for the POM, and do not use the version declared in the POM file. you're overriding, periodt 👑
  • -r<rules>, --rules=<rules> — path to the file containing the rules to apply when cleaning the POM. this one's optional, and the default location is debian/maven.rules 📁
  • -R<rule>, --extra-rule=<rule> — an extra rule to apply when cleaning the POM. can occur multiple times, and it works instead of, or in addition to, -r 🔥
  • -u<rules>, --published-rules=<rules> — path to the file with the extra rules to publish in the property debian.mavenRules in the cleaned POM. optional, default location is debian/maven.publishedRules 📢
  • -U<rule>, --extra-published-rule=<rule> — an extra rule to publish. can occur multiple times, instead of or in addition to -u ✨
  • -i<rules>, --ignore-rules=<rules> — path to the file with the rules used to remove certain dependencies from the cleaned POM. optional, default location is debian/maven.ignoreRules 🚫
  • -I<rule>, --extra-ignore-rule=<rule> — an extra rule used to remove dependencies from the transformed POM. can occur multiple times, instead of or in addition to -i 💀
  • -c<rules>, --clean-ignore-rules=<rules> — path to the file with the rules used to remove certain dependencies from the cleaned POM, in addition to the ignore rules specified previously. super useful when, say, the Maven clean target needs more dependencies or plugins ignored than the build target does. all rules defined in clean-ignore-rules get added to the existing rules in ignore-rules. optional, default location is debian/maven.cleanIgnoreRules 🧚
  • -s, --no-rules — don't apply any rules for converting versions. like, none. she won't even convert versions to the default 'debian' version. full chaos mode, no notes 😭
  • --no-publish-used-rule — don't publish the rule used to transform a POM's own attributes in debian.mavenRules. keep it private bestie 🙈
  • -d, --debian-build — transform during a Debian build, which means that some POM elements will be removed ✂️
  • -b, --build-no-docs — if the build doesn't need to build documentation, use this option to remove some POM elements (in particular plugins) which are useless here and may require extra dependencies and make the packaging harder. basically: cut the dead weight 💅
  • -m<repo root>, --maven-repo=<repo root> — location of the Maven repository. used to force the versions of the Maven plugins used in the current POM file with the versions found in the repository 🗂️
  • -v, --verbose — show more information while running. she's yapping, but productively 🗣️
  • -n, --no-act — don't actually do anything, just print the results. the "let me rehearse first" option, iconic for testing 🎀
see also: mh_installpoms(1), mh_patchpom(1) — go read your sisters' pages too, they're all in the same friend group 🫶

and that's the whole page, bestie!! 🌟 this manual is from Maven Repo Helper version 1.7.1, dated September 2025 — so like, fresh, current, and serving main character energy in the MAVEN(1) section. now go patch some POMs, you absolute legend 💜✨🦋

📦 where this page comes from