.TH "alpm-package-base" 7

.SH "NAME"
.PP
package base \- an identifier that tracks from which sources an ALPM based package originates\.

.SH "DESCRIPTION"
.PP
The \fBpackage base\fP format represents an identifier, that describes the source origin of each \fBalpm\-package\fP file\.
It is particularly useful in \fBalpm\-split\-package\fP files to track the sources from which each package file is built\.
.PP
More specifically, the \fBalpm\-package\-base\fP format is used throughout the package management life cycle:
.RS
.Bl
.IP \(bu 4
in build scripts and source metadata files (i\.e\. \fBPKGBUILD\fP and \fBSRCINFO\fP)
.El
.Bl
.IP \(bu 4
in file formats for package metadata (i\.e\. \fBBUILDINFO\fP and \fBPKGINFO\fP)
.El
.Bl
.IP \(bu 4
in file formats for repository metadata (i\.e\. \fBalpm\-repo\-desc\fP)
.El
.Bl
.IP \(bu 4
and in system state metadata (i\.e\. \fBalpm\-db\-desc\fP)\.
.El
.RE

.SS "General Format"
.PP
The identifier name for \fBalpm\-package\-base\fP may differ depending on context\.
However, the value restrictions for it are the same as those for \fBalpm\-package\-name\fP\.

.SH "EXAMPLES"
.PP
The \fBPKGBUILD\fP of a package named `\f[CR]example\fP`, that implicitly specifies its \fBalpm\-package\-base\fP as `\f[CR]example\fP`\.
.RS
.PP
.nf
pkgname=example
pkgver=1\.0\.0
pkgrel=1
pkgdesc="An example package"
arch=(any)
url="https://example\.org"
license=('CC0\-1\.0')

package() {
  install \-vdm 755 "$pkgdir/usr/share/doc/$pkgname/"
  printf "example\n" > "$pkgdir/usr/share/doc/$pkgname/example\.txt"
}
.fi
.RE
.PP
The \fBPKGBUILD\fP of a package named `\f[CR]example\fP`, that explicitly specifies its \fBalpm\-package\-base\fP as `\f[CR]something\-else\fP`\.
.RS
.PP
.nf
pkgname=example
pkgbase=something\-else
pkgver=1\.0\.0
pkgrel=1
pkgdesc="An example package"
arch=(any)
url="https://example\.org"
license=('CC0\-1\.0')

package() {
  install \-vdm 755 "$pkgdir/usr/share/doc/$pkgname/"
  printf "example\n" > "$pkgdir/usr/share/doc/$pkgname/example\.txt"
}
.fi
.RE
.PP
The \fBPKGBUILD\fP of a split package setup with the packages `\f[CR]example\fP` and `\f[CR]other\-example\fP` that both share the implicit \fBalpm\-package\-base\fP `\f[CR]example\fP`\.
.RS
.PP
.nf
pkgname=(
  example
  other\-example
)
pkgver=1\.0\.0
pkgrel=1
pkgdesc="An example package"
arch=(any)
url="https://example\.org"
license=('CC0\-1\.0')

package_example() {
  install \-vdm 755 "$pkgdir/usr/share/doc/$pkgname/"
  printf "example\n" > "$pkgdir/usr/share/doc/$pkgname/example\.txt"
}

package_other\-example() {
  install \-vdm 755 "$pkgdir/usr/share/doc/$pkgname/"
  printf "other\-example\n" > "$pkgdir/usr/share/doc/$pkgname/example\.txt"
}
.fi
.RE
.PP
The \fBPKGBUILD\fP of a split package setup with the packages `\f[CR]example1\fP` and `\f[CR]example2\fP` that both share the explicit \fBalpm\-package\-base\fP `\f[CR]example\fP`\.
.RS
.PP
.nf
pkgname=(
  example1
  example2
)
pkgbase=example
pkgver=1\.0\.0
pkgrel=1
pkgdesc="An example package"
arch=(any)
url="https://example\.org"
license=('CC0\-1\.0')

package_example1() {
  install \-vdm 755 "$pkgdir/usr/share/doc/$pkgname/"
  printf "example1\n" > "$pkgdir/usr/share/doc/$pkgname/example\.txt"
}

package_example2() {
  install \-vdm 755 "$pkgdir/usr/share/doc/$pkgname/"
  printf "example2\n" > "$pkgdir/usr/share/doc/$pkgname/example\.txt"
}
.fi
.RE

.SH "SEE ALSO"
.PP
\fBBUILDINFO\fP(5), \fBPKGBUILD\fP(5), \fBPKGINFO\fP(5), \fBSRCINFO\fP(5), \fBalpm\-db\-desc\fP(7), \fBalpm\-package\fP(7), \fBalpm\-package\-name\fP(7), \fBalpm\-repo\-desc\fP(7), \fBalpm\-split\-package\fP(7)