MVN_ALIAS(7)

💅 MVN_ALIAS — the mvn_alias(7) manual, bestie edition

okay so first of all, welcome to the Java Packages Tools corner of the manual, where mvn_alias lives. It's a macro. It's a mood. It gives your Maven artifacts a second name. Let's get into it ✨

---

🎀 NAME

mvn_alias — add alias(es) for Maven artifact(s). No cap, that's the whole job.

---

🌸 SYNOPSIS

%mvn_alias artifact-coordinates alias [alias ...]

---

✨ DESCRIPTION

So the mvn_alias macro goes ahead and adds instructions for artifact installation into the XMvn reactor configuration. What's it for? Specifying alternative names — aka aliases — for Maven artifacts. That's it, that's the gig 🫶

Here's the tea though: the artifact coordinates you give it must match at least one artifact. If they don't? Behavior is unspecified. Like, nobody's promising anything, it's giving chaos. 🙈

But also! You can hand it coordinates that match multiple artifacts, which means one single call to mvn_alias can affect the installation of more than one artifact at once. Efficiency queen 👑

---

💖 OPERANDS

• artifact-coordinates — these coordinates specify which artifact(s) the rule applies to. The format is:

groupId:artifactId[:extension[:classifier]][:version]

Important rules, listen up: if extension is specified, then version must be specified too. If any part is omitted or equal to an empty string, then it matches any string. Wildcards and brace expansions are supported in every part. For more info, go peek at the XMvn Configuration Reference. iykyk 📚

• alias — coordinates specifying the artifact alias, aka the alternative name under which matching artifacts will be available. Same format, bestie:

groupId:artifactId[:extension[:classifier]][:version]

Same rule applies: if extension is specified, then version must be specified too. And here's the cute part — if any part is omitted or equal to an empty string, then the corresponding part from artifact-coordinates gets substituted in for it. So thoughtful 🥹

Also, backreferences are supported in the form @n, where n is an integer corresponding to a brace in artifact-coordinates. Slay.

---

👑 AUTHOR

Originally written by Mikolaj Izdebski. Versions 3.0.0 and later were written by Stanislav Ochotnicky. Two icons, honestly.

---

🐛 REPORTING BUGS

Found a bug? Don't suffer in silence, bestie. Bugs should be reported through the Java Packages Tools issue tracker at Github:

https://github.com/fedora-java/javapackages/issues

Go tell them everything. They want to know 💜

---

🌈 SEE ALSO

• gradle_build(7)
• mvn_build(7)
• mvn_compat_version(7)
• mvn_config(7)
• mvn_file(7)
• mvn_package(7)
• xmvn(1)

---

and that's the whole page, you ate that 💅

this one's from the JAVAPACKAGES girlies, dated 2025-09-19, and it's literally MVN_ALIAS(7) — mwah, bye bestie 🦋💖