Commit a5454226 authored by Mario Blättermann's avatar Mario Blättermann

Update distribution manpages

parent 5280df36
Pipeline #34262 passed with stage
in 2 minutes
......@@ -253,7 +253,7 @@ configures automatic power down of the FDC. The old configuration is echoed
enables/disables ISO formats. Odd values of
\&\fIiso\fR
enable these formats, whereas even values disable them. ISO formats
don't have index headers, and thus allow to fit slightly more data on
don't have index headers, and thus allow one to fit slightly more data on
a disk.
.TP
\&\fR\&\f(CWsave\fR\
......
......@@ -219,8 +219,6 @@ Valid debug options include
.RS
.IP exec
Show diagnostic information relating to \-exec, \-execdir, \-ok and \-okdir
.IP help
Explain the debugging options.
.IP opt
Prints diagnostic information relating to the optimisation of the
expression tree; see the \-O option.
......@@ -239,6 +237,11 @@ system calls. The
program tries to minimise such calls.
.IP tree
Show the expression tree in its original and optimised form.
.IP all
Enable all of the other debug options (but
.BR help ).
.IP help
Explain the debugging options.
.RE
.IP \-Olevel
Enables query optimisation.
......@@ -2356,7 +2359,7 @@ instead of file names expanded by the parent shell:
.fi
.SH COPYRIGHT
Copyright \(co 1990-2018 Free Software Foundation, Inc.
Copyright \(co 1990-2019 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
......
......@@ -405,7 +405,7 @@ programs are properly installed at your site, the command
should give you access to the complete manual.
.SH COPYRIGHT
Copyright \(co 1990-2018 Free Software Foundation, Inc.
Copyright \(co 1990-2019 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
......
......@@ -5,7 +5,7 @@
.\" This file has been put into the public domain.
.\" You can do whatever you want with this file.
.\"
.TH XZ 1 "2015-05-11" "Tukaani" "XZ Utils"
.TH XZ 1 "2017-04-19" "Tukaani" "XZ Utils"
.
.SH NAME
xz, unxz, xzcat, lzma, unlzma, lzcat \- Compress or decompress .xz and .lzma files
......@@ -2779,8 +2779,8 @@ have the same number of bytes per pixel.
.BR bzip2 (1),
.BR 7z (1)
.PP
XZ Utils: <http://tukaani.org/xz/>
XZ Utils: <https://tukaani.org/xz/>
.br
XZ Embedded: <http://tukaani.org/xz/embedded.html>
XZ Embedded: <https://tukaani.org/xz/embedded.html>
.br
LZMA SDK: <http://7-zip.org/sdk.html>
......@@ -235,7 +235,7 @@ floppycontrol.
.\"}}}
.\"{{{ Notes
.SH NOTES
The various formats allow to read and write many types of disks.
The various formats allow one to read and write many types of disks.
However, if a floppy is formatted with a too small inter sector gap,
performance may drop, up to needing a few seconds to access an entire
track. To prevent this, use interleaved formats. It is not possible to
......
......@@ -1390,7 +1390,6 @@ man8/ld.so.8.gz man8/ld-linux.so.8.gz
man8/mkisofs.8.gz man8/mkhybrid.8.gz
man8/mountd.8.gz man8/rpc.mountd.8.gz
man8/nfsd.8.gz man8/rpc.nfsd.8.gz
man8/repo-add.8.gz man8/repo-remove.8.gz
man8/setarch.8.gz man8/i386.8.gz
man8/setarch.8.gz man8/linux32.8.gz
man8/setarch.8.gz man8/linux64.8.gz
......
'\" t
.\" Title: makepkg-template
.\" Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 2018-12-25
.\" Manual: Pacman Manual
.\" Source: Pacman 5.1.2
.\" Language: English
.\"
.TH "MAKEPKG\-TEMPLATE" "1" "2018\-12\-25" "Pacman 5\&.1\&.2" "Pacman Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
makepkg-template \- package build templating utility
.SH "SYNOPSIS"
.sp
\fImakepkg\-template\fR [options]
.SH "DESCRIPTION"
.sp
\fImakepkg\-template\fR is a script to ease the work of maintaining multiple similar PKGBUILDs\&. It allows you to move most of the code from the PKGBUILD into a template file and uses markers to allow in\-place updating of existing PKGBUILDs if the template has been changed\&.
.sp
Template files can contain any code allowed in a PKGBUILD\&. You can think of them like external files included with "\&." or "source", but they will be inlined into the PKGBUILD by \fImakepkg\-template\fR so you do not depend on the template file when building the package\&.
.sp
Markers are bash comments in the form of:
.sp
.if n \{\
.RS 4
.\}
.nf
# template start; key=value; key2=value2; \&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
and
.sp
.if n \{\
.RS 4
.\}
.nf
# template end;
.fi
.if n \{\
.RE
.\}
.sp
Currently used keys are: name (mandatory) and version\&. Template names are limited to alphanumerics, "@", "+", "\&.", "\-", and "_"\&. Versions are limited to numbers and "\&."\&.
.sp
For initial creation there is a one line short cut which does not need an end marker:
.sp
.if n \{\
.RS 4
.\}
.nf
# template input; key=value;
.fi
.if n \{\
.RE
.\}
.sp
Using this short\-cut will result in \fImakepkg\-template\fR replacing it with start and end markers and the template code on the first run\&.
.sp
Template files should be stored in one directory and filenames should be "$template_name\-$version\&.template" with a symlink "$template_name\&.template" pointing to the most recent template\&. If the version is not set in the marker, \fImakepkg\-template\fR will automatically use the target of "$template_name\&.template", otherwise the specified version will be used\&. This allows for easier verification of untrusted PKGBUILDs if the template is trusted\&. You verify the non\-template code and then use a command similar to this:
.sp
.if n \{\
.RS 4
.\}
.nf
diff \-u <(makepkg\-template \-o \-) PKGBUILD
.fi
.if n \{\
.RE
.\}
.sp
Template files may also contain markers leading to nested templates in the resulting PKGBUILD\&. If you use markers in a template, please set the version you used/tested with in the start/input marker so other people can properly recreate from templates\&.
.SH "OPTIONS"
.PP
\fB\-p, \-\-input\fR <build script>
.RS 4
Read the package script
build script
instead of the default\&.
.RE
.PP
\fB\-o, \-\-output\fR <build script>
.RS 4
Write the updated file to
build script
instead of overwriting the input file\&.
.RE
.PP
\fB\-n, \-\-newest\fR
.RS 4
Always use the newest available template file\&.
.RE
.PP
\fB\-\-template\-dir\fR <dir>
.RS 4
Change the dir where we are looking for template files\&. This option may be given multiple times in which case files found in directory given last will take precedence\&.
.RE
.SH "EXAMPLE PKGBUILD"
.sp
.if n \{\
.RS 4
.\}
.nf
pkgname=perl\-config\-simple
pkgver=4\&.58
pkgrel=1
pkgdesc="simple configuration file class"
arch=(\*(Aqany\*(Aq)
license=(\*(AqPerlArtistic\*(Aq \*(AqGPL\*(Aq)
depends=(\*(Aqperl\*(Aq)
source=("http://search\&.cpan\&.org/CPAN/authors/id/S/SH/SHERZODR/Config\-Simple\-${pkgver}\&.tar\&.gz")
md5sums=(\*(Aqf014aec54f0a1e2e880d317180fce502\*(Aq)
_distname="Config\-Simple"
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
# template start; name=perl\-module; version=1\&.0;
_distdir="${_distname}\-${pkgver}"
url="https://metacpan\&.org/release/${_distname}"
options+=(\*(Aq!emptydirs\*(Aq)
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
build() {
cd "$srcdir/$_distdir"
perl Makefile\&.PL INSTALLDIRS=vendor
make
}
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
check() {
cd "$srcdir/$_distdir"
make test
}
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
package() {
cd "$srcdir/$_distdir"
make DESTDIR="$pkgdir" install
}
# template end;
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.sp
\fBmakepkg\fR(8), \fBPKGBUILD\fR(5)
.sp
See the pacman website at https://www\&.archlinux\&.org/pacman/ for current information on pacman and its related tools\&.
.SH "BUGS"
.sp
Bugs? You must be kidding; there are no bugs in this software\&. But if we happen to be wrong, send us an email with as much detail as possible to pacman\-dev@archlinux\&.org\&.
.SH "AUTHORS"
.sp
Current maintainers:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Allan McRae <allan@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Dan McGee <dan@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Dave Reisner <dreisner@archlinux\&.org>
.RE
.sp
Past major contributors:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Judd Vinet <jvinet@zeroflux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Aurelien Foret <aurelien@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Aaron Griffin <aaron@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Xavier Chantry <shiningxc@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu>
.RE
.sp
For additional contributors, use git shortlog \-s on the pacman\&.git repository\&.
'\" t
.\" Title: libalpm
.\" Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 2018-12-25
.\" Manual: Pacman Manual
.\" Source: Pacman 5.1.2
.\" Language: English
.\"
.TH "LIBALPM" "3" "2018\-12\-25" "Pacman 5\&.1\&.2" "Pacman Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
libalpm \- Arch Linux Package Management (ALPM) library
.SH "SYNOPSIS"
.sp
For ease of access, the libalpm manual has been split up into several sections\&.
.sp
\fBTODO:\fR Yes, this man page needs a lot of work\&. Once we get around to doing good Doxygen documentation, it will improve\&. We promise\&.
.PP
\fBalpm_databases\fR
.RS 4
Database Functions
.RE
.PP
\fBalpm_interface\fR
.RS 4
Interface Functions
.RE
.PP
\fBalpm_list\fR
.RS 4
List Functions
.RE
.PP
\fBalpm_log\fR
.RS 4
Logging Functions
.RE
.PP
\fBalpm_misc\fR
.RS 4
Miscellaneous Functions
.RE
.PP
\fBalpm_packages\fR
.RS 4
Package Functions
.RE
.PP
\fBalpm_sync\fR
.RS 4
Sync Functions
.RE
.PP
\fBalpm_trans\fR
.RS 4
Transaction Functions
.RE
.SH "CONFIGURATION"
.sp
See \fBpacman.conf\fR(5) for more details on configuring libalpm using the \fIpacman\&.conf\fR file\&.
.SH "SEE ALSO"
.sp
\fBalpm-hooks\fR(5), \fBmakepkg\fR(8), \fBpacman\fR(8), \fBpacman.conf\fR(5)
.sp
See the pacman website at https://www\&.archlinux\&.org/pacman/ for current information on pacman and its related tools\&.
.SH "BUGS"
.sp
Bugs? You must be kidding; there are no bugs in this software\&. But if we happen to be wrong, send us an email with as much detail as possible to pacman\-dev@archlinux\&.org\&.
.SH "AUTHORS"
.sp
Current maintainers:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Allan McRae <allan@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Dan McGee <dan@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Dave Reisner <dreisner@archlinux\&.org>
.RE
.sp
Past major contributors:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Judd Vinet <jvinet@zeroflux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Aurelien Foret <aurelien@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Aaron Griffin <aaron@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Xavier Chantry <shiningxc@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu>
.RE
.sp
For additional contributors, use git shortlog \-s on the pacman\&.git repository\&.
'\" t
.\" Title: buildinfo
.\" Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 2018-12-25
.\" Manual: Pacman Manual
.\" Source: Pacman 5.1.2
.\" Language: English
.\"
.TH "BUILDINFO" "5" "2018\-12\-25" "Pacman 5\&.1\&.2" "Pacman Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
BUILDINFO \- Makepkg package build information file
.SH "SYNOPSIS"
.sp
This manual page describes the format of a BUILDINFO file found in the root of a package created by makepkg\&. The file contains a description of the package\(cqs build environment\&. The information is formatted in key\-value pairs separated by a \fI=\fR, one value per line\&. Arrays are represented multiple keys with the same value\&.
.SH "DESCRIPTION"
.sp
This is a description of the contents of version \fI1\fR of the BUILDINFO file format\&.
.PP
\fBformat\fR
.RS 4
Denotes the file format version, represented by a plain positive integer\&.
.RE
.PP
\fBpkgname\fR
.RS 4
The name of the package\&.
.RE
.PP
\fBpkgbase\fR
.RS 4
The base name of a package, usually the same as the pkgname except for split packages\&.
.RE
.PP
\fBpkgver\fR
.RS 4
The version of the package including pkgrel and epoch\&.
.RE
.PP
\fBpkgarch\fR
.RS 4
The architecture of the package\&.
.RE
.PP
\fBpkgbuild_sha256sum\fR
.RS 4
The sha256sum in hex format of the PKGBUILD used to build the package\&.
.RE
.PP
\fBpackager\fR
.RS 4
The details of the packager that built the package\&.
.RE
.PP
\fBbuilddate\fR
.RS 4
The build date of the package in epoch\&.
.RE
.PP
\fBbuilddir\fR
.RS 4
The directory where the package was built\&.
.RE
.PP
\fBbuildenv (array)\fR
.RS 4
The build environment specified in makepkg\&.conf\&.
.RE
.PP
\fBoptions (array)\fR
.RS 4
The options set specified when building the package\&.
.RE
.PP
\fBinstalled (array)\fR
.RS 4
The installed packages at build time including the version information of the package\&. Formatted as "$pkgname\-$pkgver\-$pkgrel\-$pkgarch"\&.
.RE
.SH "SEE ALSO"
.sp
\fBmakepkg\fR(8), \fBpacman\fR(8), \fBmakepkg.conf\fR(5)
.sp
See the pacman website at https://www\&.archlinux\&.org/pacman/ for current information on pacman and its related tools\&.
.SH "BUGS"
.sp
Bugs? You must be kidding; there are no bugs in this software\&. But if we happen to be wrong, send us an email with as much detail as possible to pacman\-dev@archlinux\&.org\&.
.SH "AUTHORS"
.sp
Current maintainers:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Allan McRae <allan@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Dan McGee <dan@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Dave Reisner <dreisner@archlinux\&.org>
.RE
.sp
Past major contributors:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Judd Vinet <jvinet@zeroflux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}