diff options
Diffstat (limited to 'upstream/archlinux/man1/pkgctl-build.1')
| -rw-r--r-- | upstream/archlinux/man1/pkgctl-build.1 | 188 |
1 files changed, 92 insertions, 96 deletions
diff --git a/upstream/archlinux/man1/pkgctl-build.1 b/upstream/archlinux/man1/pkgctl-build.1 index 924248e1..7bb2b2f4 100644 --- a/upstream/archlinux/man1/pkgctl-build.1 +++ b/upstream/archlinux/man1/pkgctl-build.1 @@ -1,119 +1,114 @@ '\" t .\" Title: pkgctl-build -.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] -.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/14/2024 +.\" Author: [see the "AUTHOR(S)" section] +.\" Generator: Asciidoctor 2.0.21 +.\" Date: 2024-05-01 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "PKGCTL\-BUILD" "1" "02/14/2024" "\ \&" "\ \&" -.\" ----------------------------------------------------------------- -.\" * Define some portability stuff -.\" ----------------------------------------------------------------- -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" http://bugs.debian.org/507673 -.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.TH "PKGCTL\-BUILD" "1" "2024-05-01" "\ \&" "\ \&" .ie \n(.g .ds Aq \(aq .el .ds Aq ' -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation +.ss \n[.ss] 0 .nh -.\" disable justification (adjust text to left margin only) .ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- +.de URL +\fI\\$2\fP <\\$1>\\$3 +.. +.als MTO URL +.if \n[.g] \{\ +. mso www.tmac +. am URL +. ad l +. . +. am MTO +. ad l +. . +. LINKSTYLE blue R < > +.\} .SH "NAME" pkgctl-build \- Build packages inside a clean chroot .SH "SYNOPSIS" .sp -pkgctl build [OPTIONS] [PATH\&...] +pkgctl build [OPTIONS] [PATH...] .SH "DESCRIPTION" .sp TODO .SH "BUILD OPTIONS" -.PP -\fB\-\-arch\fR \fIARCH\fR +.sp +\fB\-\-arch\fP \fIARCH\fP .RS 4 Specify architectures to build for (disables auto\-detection) .RE -.PP -\fB\-\-repo\fR \fIREPO\fR +.sp +\fB\-\-repo\fP \fIREPO\fP .RS 4 -Specify target repository for new packages not in any official repo\&. Fallback to -\*(Aqextra\*(Aq -when building packages that are not present in any official repository yet\&. Using this option is disallowed if the package is already released, as it would circumvent the auto\-detection safeguard\&. +Specify target repository for new packages not in any official repo. +Fallback to \f(CR\*(Aqextra\*(Aq\fP when building packages that are not present in any +official repository yet. Using this option is disallowed if the package is +already released, as it would circumvent the auto\-detection safeguard. .RE -.PP -\fB\-s, \-\-staging\fR +.sp +\fB\-s, \-\-staging\fP .RS 4 Build against the staging counterpart of the auto\-detected repo .RE -.PP -\fB\-t, \-\-testing\fR +.sp +\fB\-t, \-\-testing\fP .RS 4 Build against the testing counterpart of the auto\-detected repo .RE -.PP -\fB\-o, \-\-offload\fR +.sp +\fB\-o, \-\-offload\fP .RS 4 Build on a remote server and transfer artifacts afterwards .RE -.PP -\fB\-c, \-\-clean\fR +.sp +\fB\-c, \-\-clean\fP .RS 4 Recreate the chroot before building .RE -.PP -\fB\-\-inspect\fR \fIWHEN\fR +.sp +\fB\-\-inspect\fP \fIWHEN\fP .RS 4 -Spawn an interactive shell to inspect the chroot after building\&. Useful to ease the debugging of a package build\&. - -Possible values for -\fIWHEN\fR -are -\*(Aqnever\*(Aq, -\*(Aqalways\*(Aq -or -\*(Aqfailure\*(Aq +Spawn an interactive shell to inspect the chroot after building. Useful to ease the debugging of a package build. +.br +Possible values for \fIWHEN\fP are \f(CR\*(Aqnever\*(Aq\fP, \f(CR\*(Aqalways\*(Aq\fP or \f(CR\*(Aqfailure\*(Aq\fP .RE -.PP -\fB\-w, \-\-worker\fR \fISLOT\fR +.sp +\fB\-w, \-\-worker\fP \fISLOT\fP .RS 4 -Name of the worker slot, useful for concurrent builds\&. By default the slot is automatically assigned to the current tty pts number\&. In case the caller is not a tty, choose a random slot between 1 and number of available processing units\&. +Name of the worker slot, useful for concurrent builds. By default the slot +is automatically assigned to the current tty pts number. In case the caller +is not a tty, choose a random slot between 1 and number of available +processing units. .RE -.PP -\fB\-\-nocheck\fR +.sp +\fB\-\-nocheck\fP .RS 4 Do not run the check() function in the PKGBUILD .RE .SH "INSTALL OPTIONS" -.PP -\fB\-I, \-\-install\-to\-chroot\fR \fIFILE\fR +.sp +\fB\-I, \-\-install\-to\-chroot\fP \fIFILE\fP .RS 4 Install a package to the working copy of the chroot .RE -.PP -\fB\-i, \-\-install\-to\-host\fR \fIMODE\fR +.sp +\fB\-i, \-\-install\-to\-host\fP \fIMODE\fP .RS 4 -Install the built packages to the host system\&. Useful when one wants to verify that the package works as intended\&. +Install the built packages to the host system. Useful when one wants to verify that the package works as intended. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ -.sp -1 -.IP \(bu 2.3 +. sp -1 +. IP \(bu 2.3 .\} -When -\fIMODE\fR -is -\fIall\fR, this installs all built packages +When \fIMODE\fP is \fIall\fP, this installs all built packages .RE .sp .RS 4 @@ -121,74 +116,75 @@ is \h'-04'\(bu\h'+03'\c .\} .el \{\ -.sp -1 -.IP \(bu 2.3 +. sp -1 +. IP \(bu 2.3 .\} -When -\fIMODE\fR -is -\fIauto\fR, this installs all built packages which are currently installed +When \fIMODE\fP is \fIauto\fP, this installs all built packages which are currently installed .RE .RE .SH "PKGBUILD OPTIONS" -.PP -\fB\-\-pkgver\fR=\fIPKGVER\fR +.sp +\fB\-\-pkgver\fP=\fIPKGVER\fP .RS 4 Set pkgver, reset pkgrel and update checksums .RE -.PP -\fB\-\-pkgrel\fR=\fIPKGREL\fR +.sp +\fB\-\-pkgrel\fP=\fIPKGREL\fP .RS 4 Set pkgrel to a given value .RE -.PP -\fB\-\-rebuild\fR +.sp +\fB\-\-rebuild\fP .RS 4 Increment the current pkgrel variable .RE -.PP -\fB\-\-update\-checksums\fR +.sp +\fB\-\-update\-checksums\fP .RS 4 -Force computation and update of the checksums by disabling auto\-detection\&. - -Should only be used in special circumstances, like when adding new patch files to the source array\&. During regular packaging operations, checksums are either automatically updated when upgrading a package using -\-\-pkgver -or should remain immutable during rebuilds\&. +Force computation and update of the checksums by disabling auto\-detection. +.br +Should only be used in special circumstances, like when adding new patch +files to the source array. During regular packaging operations, checksums +are either automatically updated when upgrading a package using \f(CR\-\-pkgver\fP +or should remain immutable during rebuilds. .RE -.PP -\fB\-e, \-\-edit\fR +.sp +\fB\-e, \-\-edit\fP .RS 4 Edit the PKGBUILD before building .RE .SH "RELEASE OPTIONS" -.PP -\fB\-r, \-\-release\fR +.sp +\fB\-r, \-\-release\fP .RS 4 Automatically commit, tag and release after building - -Specifying this option is required when using any of the following options in this section +.br +Specifying this option is required when using any of the following options +in this section .RE -.PP -\fB\-m, \-\-message\fR \fIMSG\fR +.sp +\fB\-m, \-\-message\fP \fIMSG\fP .RS 4 Use the given <msg> as the commit message .RE -.PP -\fB\-u, \-\-db\-update\fR +.sp +\fB\-u, \-\-db\-update\fP .RS 4 Automatically update the pacman database as last action .RE .SH "OPTIONS" -.PP -\fB\-h, \-\-help\fR +.sp +\fB\-h, \-\-help\fP .RS 4 Show a help text .RE .SH "SEE ALSO" .sp -\fBpkgctl-release\fR(1) \fBpkgctl-db-update\fR(1) +pkgctl\-release(1) +pkgctl\-db\-update(1) .SH "HOMEPAGE" .sp -\fIhttps://gitlab\&.archlinux\&.org/archlinux/devtools\fR +\fI\c +.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fP" .sp -Please report bugs and feature requests in the issue tracker\&. Please do your best to provide a reproducible test case for bugs\&. +Please report bugs and feature requests in the issue tracker. Please do your best to provide a reproducible test case for bugs.
\ No newline at end of file |