.TH "alpm-package-version" 7

.SH "NAME"
.PP
package version \- package versions for ALPM based packages\.

.SH "DESCRIPTION"
.PP
The \fBpackage version\fP format represents version information for ALPM based packages\.
This format is used in build scripts or file formats for package metadata (e\.g\. in \fBPKGBUILD\fP, \fBPKGINFO\fP, \fBSRCINFO\fP, \fBalpm\-repo\-desc\fP, or \fBalpm\-lib\-desc\fP) to describe package versions, or component versions as part of a \fBpackage relation\fP\.
.PP
The value is represented by a composite version string, which may consist of several components (\fBalpm\-epoch\fP, \fBalpm\-pkgver\fP, \fBalpm\-pkgrel\fP)\.
Various forms of composite version strings exist, but they are only used in specific contexts\.

.SS "Full"
.PP
The value for this form consists of an \fBalpm\-pkgver\fP, directly followed by a '\-' sign, directly followed by an \fBalpm\-pkgrel\fP (e\.g\. `\f[CR]1\.0\.0\-1\fP`)\.
This \fBalpm\-package\-version\fP form is used in various scenarios, such as:
.RS
.Bl
.IP \(bu 4
package filenames
.El
.Bl
.IP \(bu 4
\fBpackage\-relation\fP expressions
.RS
.Bl
.IP \(bu 4
\fBreplaces\fP, \fBconflict\fP, \fBprovides\fP, \fBdepend\fP, \fBmakedepend\fP and \fBcheckdepend\fP in \fBPKGINFO\fP files
.El
.RE
.El
.Bl
.IP \(bu 4
\fBpkgver\fP in \fBBUILDINFO\fP files
.El
.Bl
.IP \(bu 4
\fBpkgver\fP in \fBPKGINFO\fP files
.El
.Bl
.IP \(bu 4
as part of \fBbuildtoolver\fP in \fBBUILDINFOv2\fP files
.El
.Bl
.IP \(bu 4
as part of \fBinstalled\fP in \fBBUILDINFO\fP files
.El
.RE

.SS "Full with epoch"
.PP
The value for this form consists of an \fBalpm\-epoch\fP, directly followed by a ':' sign, directly followed by an \fBalpm\-pkgver\fP, directly followed by a '\-' sign, directly followed by an \fBalpm\-pkgrel\fP (e\.g\. `\f[CR]1:1\.0\.0\-1\fP`)\.
This \fBalpm\-package\-version\fP form is used in various scenarios, such as:
.RS
.Bl
.IP \(bu 4
package filenames
.El
.Bl
.IP \(bu 4
\fBpackage\-relation\fP expressions
.RS
.Bl
.IP \(bu 4
\fBreplaces\fP, \fBconflict\fP, \fBprovides\fP, \fBdepend\fP, \fBmakedepend\fP and \fBcheckdepend\fP in \fBPKGINFO\fP files
.El
.RE
.El
.Bl
.IP \(bu 4
\fBpkgver\fP in \fBBUILDINFO\fP files
.El
.Bl
.IP \(bu 4
\fBpkgver\fP in \fBPKGINFO\fP files
.El
.Bl
.IP \(bu 4
as part of \fBbuildtoolver\fP in \fBBUILDINFOv2\fP files
.El
.Bl
.IP \(bu 4
as part of \fBinstalled\fP in \fBBUILDINFO\fP files
.El
.RE

.SS "Minimal"
.PP
The value for this form consists of an \fBalpm\-pkgver\fP (e\.g\. `\f[CR]1\.0\.0\fP`)\.
This \fBalpm\-package\-version\fP form is used in various scenarios, such as:
.RS
.Bl
.IP \(bu 4
\fBpackage\-relation\fP expressions
.RS
.Bl
.IP \(bu 4
\fBreplaces\fP, \fBconflicts\fP, \fBprovides\fP, \fBdepends\fP, \fBmakedepends\fP and \fBcheckdepends\fP in \fBPKGBUILD\fP files
.El
.Bl
.IP \(bu 4
\fBreplaces\fP, \fBconflict\fP, \fBprovides\fP, \fBdepend\fP, \fBmakedepend\fP and \fBcheckdepend\fP in \fBPKGINFO\fP files
.El
.RE
.El
.Bl
.IP \(bu 4
\fBpkgver\fP in \fBPKGBUILD\fP files
.El
.Bl
.IP \(bu 4
\fBpkgver\fP in \fBSRCINFO\fP files
.El
.Bl
.IP \(bu 4
as part of \fBbuildtoolver\fP in \fBBUILDINFOv2\fP files
.El
.RE

.SS "Minimal with epoch"
.PP
The value for this form consists of an \fBalpm\-epoch\fP, directly followed by a ':' sign, directly followed by an \fBalpm\-pkgver\fP (e\.g\. `\f[CR]1:1\.0\.0\fP`)\.
This \fBalpm\-package\-version\fP form is used in various scenarios, such as:
.RS
.Bl
.IP \(bu 4
as part of \fBpackage\-relation\fP expressions
.RS
.Bl
.IP \(bu 4
\fBreplaces\fP, \fBconflicts\fP, \fBprovides\fP, \fBdepends\fP, \fBmakedepends\fP and \fBcheckdepends\fP in \fBPKGBUILD\fP files
.El
.Bl
.IP \(bu 4
\fBreplaces\fP, \fBconflict\fP, \fBprovides\fP, \fBdepend\fP, \fBmakedepend\fP and \fBcheckdepend\fP in \fBPKGINFO\fP files
.El
.RE
.El
.Bl
.IP \(bu 4
\fBpkgver\fP in \fBPKGBUILD\fP files
.El
.Bl
.IP \(bu 4
\fBpkgver\fP in \fBSRCINFO\fP files
.El
.Bl
.IP \(bu 4
as part of \fBbuildtoolver\fP in \fBBUILDINFOv2\fP files
.El
.RE

.SH "EXAMPLES"
.RS
.PP
.nf
"1\.0\.0\-1"
.fi
.RE
.PP
A full package version\.
.RS
.PP
.nf
"1:1\.0\.0\-1"
.fi
.RE
.PP
A full package version with epoch\.
.RS
.PP
.nf
"1\.0\.0"
.fi
.RE
.PP
A minimal package version\.
.RS
.PP
.nf
"1:1\.0\.0"
.fi
.RE
.PP
A minimal package version with epoch\.

.SH "SEE ALSO"
.PP
\fBBUILDINFO\fP(5), \fBPKGBUILD\fP(5), \fBPKGINFO\fP(5), \fBSRCINFO\fP(5), \fBalpm\-epoch\fP(7), \fBalpm\-package\-relation\fP(7), \fBalpm\-pkgrel\fP(7), \fBalpm\-pkgver\fP(7), \fBvercmp\fP(8)