diff options
Diffstat (limited to 'upstream/fedora-rawhide/man5/PKGBUILD.5')
| -rw-r--r-- | upstream/fedora-rawhide/man5/PKGBUILD.5 | 75 |
1 files changed, 37 insertions, 38 deletions
diff --git a/upstream/fedora-rawhide/man5/PKGBUILD.5 b/upstream/fedora-rawhide/man5/PKGBUILD.5 index c320a1e5..a81c3aa9 100644 --- a/upstream/fedora-rawhide/man5/PKGBUILD.5 +++ b/upstream/fedora-rawhide/man5/PKGBUILD.5 @@ -2,12 +2,12 @@ .\" Title: pkgbuild .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "PKGBUILD" "5" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "PKGBUILD" "5" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -28,7 +28,7 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -PKGBUILD \- Arch Linux package build description file +PKGBUILD \- Package build description file .SH "SYNOPSIS" .sp PKGBUILD @@ -104,15 +104,7 @@ This field contains a URL that is associated with the software being packaged\&. .PP \fBlicense (array)\fR .RS 4 -This field specifies the license(s) that apply to the package\&. Commonly used licenses can be found in -\fI/usr/share/licenses/common\fR\&. If you see the package\(cqs license there, simply reference it in the license field (e\&.g\&., -license=(\*(AqGPL\*(Aq))\&. If the package provides a license not available in -\fI/usr/share/licenses/common\fR, then you should include it in the package itself and set -license=(\*(Aqcustom\*(Aq) -or -license=(\*(Aqcustom:LicenseName\*(Aq)\&. The license should be placed in -\fI$pkgdir/usr/share/licenses/$pkgname/\fR -when building the package\&. If multiple licenses are applicable, list all of them: +This field specifies the license(s) that apply to the package\&. If multiple licenses are applicable, list all of them: license=(\*(AqGPL\*(Aq \*(AqFDL\*(Aq)\&. .RE .PP @@ -223,8 +215,6 @@ is one of five comparisons: < (less than)\&. .sp -If the dependency name appears to be a library (ends with \&.so), makepkg will try to find a binary that depends on the library in the built package and append the version needed by the binary\&. Appending the version yourself disables automatic detection\&. -.sp Additional architecture\-specific depends can be added by appending an underscore and the architecture name e\&.g\&., \fIdepends_x86_64=()\fR\&. .RE @@ -292,8 +282,6 @@ and < operators are invalid as only specific versions of a package may be provided\&. .sp -If the provision name appears to be a library (ends with \&.so), makepkg will try to find the library in the built package and append the correct version\&. Appending the version yourself disables automatic detection\&. -.sp Additional architecture\-specific provides can be added by appending an underscore and the architecture name e\&.g\&., \fIprovides_x86_64=()\fR\&. .RE @@ -421,7 +409,16 @@ If you create any variables of your own in any of these functions, it is recomme .RS 4 The package() -function is used to install files into the directory that will become the root directory of the built package and is run after all the optional functions listed below\&. The packaging stage is run using fakeroot to ensure correct file permissions in the resulting package\&. All other functions will be run as the user calling makepkg\&. +function is used to install files into the directory that will become the root directory of the built package and is run after all the optional functions listed below\&. The packaging stage is run using fakeroot to ensure correct file permissions in the resulting package\&. All other functions will be run as the user calling makepkg\&. This function is run inside +$srcdir\&. +.RE +.PP +\fBverify() Function\fR +.RS 4 +An optional +verify() +function can be specified to implement arbitrary source authentication\&. The function should return a non\-zero exit code when verification fails\&. This function is run before sources are extracted\&. This function is run inside +$startdir\&. .RE .PP \fBprepare() Function\fR @@ -432,7 +429,8 @@ function can be specified in which operations to prepare the sources for buildin build() function\&. The prepare() -function is skipped when source extraction is skipped\&. +function is skipped when source extraction is skipped\&. This function is run inside +$srcdir\&. .RE .PP \fBbuild() Function\fR @@ -441,7 +439,8 @@ The optional build() function is used to compile and/or adjust the source files in preparation to be installed by the package() -function\&. +function\&. This function is run inside +$srcdir\&. .RE .PP \fBcheck() Function\fR @@ -454,7 +453,8 @@ and package() functions\&. Be sure any exotic commands used are covered by the checkdepends -array\&. +array\&. This function is run inside +$srcdir\&. .RE .sp All of the above variables such as $pkgname and $pkgver are available for use in the packaging functions\&. In addition, makepkg defines the following variables: @@ -462,9 +462,6 @@ All of the above variables such as $pkgname and $pkgver are available for use in \fBsrcdir\fR .RS 4 This contains the directory where makepkg extracts, or copies, all source files\&. -.sp -All of the packaging functions defined above are run starting inside -$srcdir .RE .PP \fBpkgdir\fR @@ -563,6 +560,8 @@ source=(\*(Aqdirectory::url#fragment?query\*(Aq) .sp Currently makepkg supports the Bazaar, Git, Subversion, Fossil and Mercurial version control systems\&. For other version control systems, manual cloning of upstream repositories must be done in the prepare() function\&. .sp +Some VCS Sources like Git support pinning the checkout by a checksum of its content using deterministic export functionality like \(lqgit archive\(rq\&. +.sp The source URL is divided into four components: .PP \fBdirectory\fR @@ -620,7 +619,7 @@ source=(url?signed#fragment)\&. Currently only supported by Git\&. .RE .SH "EXAMPLE" .sp -The following is an example PKGBUILD for the \fIpatch\fR package\&. For more examples, look through the build files of your distribution\(cqs packages\&. For those using Arch Linux, consult the Arch Build System (ABS) tree\&. +The following is an example PKGBUILD for the \fIpatch\fR package\&. For more examples, look through the build files of your distribution\(cqs packages\&. .sp .if n \{\ .RS 4 @@ -640,8 +639,8 @@ depends=(\*(Aqglibc\*(Aq) makedepends=(\*(Aqed\*(Aq) optdepends=(\*(Aqed: for "patch \-e" functionality\*(Aq) source=("ftp://ftp\&.gnu\&.org/gnu/$pkgname/$pkgname\-$pkgver\&.tar\&.xz"{,\&.sig}) -md5sums=(\*(Aqe9ae5393426d3ad783a300a338c09b72\*(Aq - \*(AqSKIP\*(Aq) +sha256sums=(\*(Aq9124ba46db0abd873d0995c2ca880e81252676bb6c03e0a37dfc5f608a9b0ceb\*(Aq + \*(AqSKIP\*(Aq) build() { cd "$srcdir/$pkgname\-$pkgver" @@ -699,17 +698,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -792,4 +780,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. |