summaryrefslogtreecommitdiffstats
path: root/upstream/archlinux/man1/offload-build.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/archlinux/man1/offload-build.1')
-rw-r--r--upstream/archlinux/man1/offload-build.1104
1 files changed, 54 insertions, 50 deletions
diff --git a/upstream/archlinux/man1/offload-build.1 b/upstream/archlinux/man1/offload-build.1
index fbae6db7..8543ff27 100644
--- a/upstream/archlinux/man1/offload-build.1
+++ b/upstream/archlinux/man1/offload-build.1
@@ -1,32 +1,32 @@
'\" t
.\" Title: offload-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 "OFFLOAD\-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 "OFFLOAD\-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"
offload-build \- Build a PKGBUILD on a remote server using makechrootpkg
.SH "SYNOPSIS"
@@ -34,57 +34,61 @@ offload-build \- Build a PKGBUILD on a remote server using makechrootpkg
offload\-build [OPTIONS] \(em [ARCHBUILD_OPTIONS]
.SH "DESCRIPTION"
.sp
-Build a PKGBUILD on a remote server using makechrootpkg\&. Requires a remote user that can run archbuild in a non\-interactive manner, e\&.g\&. must be able to elevate permissions using passwordless sudo\&.
+Build a PKGBUILD on a remote server using makechrootpkg. Requires a remote user
+that can run archbuild in a non\-interactive manner, e.g. must be able to
+elevate permissions using passwordless sudo.
.SH "OPTIONS"
-.PP
-\fB\-r, \-\-repo\fR <reponame>
+.sp
+\fB\-r, \-\-repo\fP <reponame>
.RS 4
-Build against a specific repository\&. The default is
-extra, to build packages using the stable repositories via extra\-x86_64\-build\&.
+Build against a specific repository. The default is \f(CRextra\fP, to build packages using
+the stable repositories via extra\-x86_64\-build.
.RE
-.PP
-\fB\-a, \-\-arch\fR <architecture>
+.sp
+\fB\-a, \-\-arch\fP <architecture>
.RS 4
-Build against a specific architecture\&. The default is
-x86_64, the only architecture officially supported by Arch Linux\&.
+Build against a specific architecture. The default is \f(CRx86_64\fP, the only
+architecture officially supported by Arch Linux.
.RE
-.PP
-\fB\-s, \-\-server\fR <hostname>
+.sp
+\fB\-s, \-\-server\fP <hostname>
.RS 4
-Offload to a specific build server\&. The default is build\&.archlinux\&.org which is used as part of the build toolchain for the official Arch Linux repos\&.
+Offload to a specific build server. The default is build.archlinux.org
+which is used as part of the build toolchain for the official Arch Linux
+repos.
.RE
-.PP
-\fB\-h, \-\-help\fR
+.sp
+\fB\-h, \-\-help\fP
.RS 4
-Show a help text\&.
+Show a help text.
.RE
.SH "PASSING OPTIONS TO ARCHBUILD"
.sp
-Options after a delimiting \(em are passed on to archbuild on the remote\&. archbuild in turn supports passing arguments on to makechrootpkg, which in turn supports passing options to makepkg\&. Since each uses \(em to delimit options that are forwarded, make sure to escape them properly:
+Options after a delimiting \(em are passed on to archbuild on the remote.
+archbuild in turn supports passing arguments on to makechrootpkg, which in turn
+supports passing options to makepkg. Since each uses \(em to delimit options that
+are forwarded, make sure to escape them properly:
.sp
-.if n \{\
-.RS 4
-.\}
+.if n .RS 4
.nf
+.fam C
`offload\-build offload\-args \-\- archbuild\-args \-\- makechrootpkg\-args \-\- makepkg\-args`
+.fam
.fi
-.if n \{\
-.RE
-.\}
+.if n .RE
.sp
-Example: To use a second testing\-x86_64\-build instance with another copydir:
+Example: To use a second \f(CRtesting\-x86_64\-build\fP instance with another copydir:
.sp
-.if n \{\
-.RS 4
-.\}
+.if n .RS 4
.nf
+.fam C
`offload\-build \-r testing \-\- \-\- \-l <chroot_copy>`
+.fam
.fi
-.if n \{\
-.RE
-.\}
+.if n .RE
.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