vmin (';' LIST )*
Macro
Summary
The vmin macro compares version strings using OSGi semantic versioning rules and returns the minimum (lowest) version.
Syntax
${vmin;<list>[;<list>...]}
Parameters
list- One or more semicolon-separated lists of version strings
Behavior
- Parses all values as OSGi versions
- Compares using semantic versioning rules
- Returns the lowest version string
- Handles major.minor.micro.qualifier format
Examples
Find minimum version:
${vmin;1.2.3,2.0.0,1.0.5}
# Returns: "1.0.5"
Multiple lists:
${vmin;1.5.0,2.0.0;1.2.3,3.0.0}
# Returns: "1.2.3"
Check compatibility:
min.required=${vmin;${bundle.versions}}
Use Cases
- Finding oldest compatible version
- Version range calculations
- Dependency analysis
- Compatibility checking
- Version comparison
Notes
- Uses OSGi semantic versioning
- Qualifiers compared lexicographically
- Invalid versions may cause errors
- See also:
${vmax}for maximum version - See also:
${vcompare}for comparison
See test cases in MacroTestsForDocsExamples.java
