diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-06-17 10:52:03 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-06-17 10:52:03 +0000 |
commit | 932e4432596447eb9331cc2a2bb74a26a35b4efc (patch) | |
tree | 95161711ea07fd64f0c82d6e7943024c033dd5a8 /upstream/archlinux/man1/pacsift.1 | |
parent | Adding debian version 4.22.0-1. (diff) | |
download | manpages-l10n-932e4432596447eb9331cc2a2bb74a26a35b4efc.tar.xz manpages-l10n-932e4432596447eb9331cc2a2bb74a26a35b4efc.zip |
Merging upstream version 4.23.0.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/archlinux/man1/pacsift.1')
-rw-r--r-- | upstream/archlinux/man1/pacsift.1 | 178 |
1 files changed, 50 insertions, 128 deletions
diff --git a/upstream/archlinux/man1/pacsift.1 b/upstream/archlinux/man1/pacsift.1 index c22fd085..12d43d2c 100644 --- a/upstream/archlinux/man1/pacsift.1 +++ b/upstream/archlinux/man1/pacsift.1 @@ -1,4 +1,5 @@ -.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== @@ -15,29 +16,12 @@ .ft R .fi .. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' . ds C` . ds C' 'br\} @@ -68,85 +52,23 @@ . \} .\} .rr rF -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "PACSIFT 1" -.TH PACSIFT 1 "2021-08-14" "pacutils" "pacsift" +.TH PACSIFT 1 2024-04-16 pacutils pacsift .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh -.SH "NAME" +.SH NAME pacsift \- query and filter packages -.SH "SYNOPSIS" +.SH SYNOPSIS .IX Header "SYNOPSIS" .Vb 2 \& pacsift [options] (<field> <term>)... \& pacsift (\-\-help|\-\-version) .Ve -.SH "DESCRIPTION" +.SH DESCRIPTION .IX Header "DESCRIPTION" By default the intersection of matched packages are returned. If a field is provided multiple times the union of matches will be used for that field. @@ -160,66 +82,66 @@ Combine with \fBpacinfo\fR to display brief package information similar to .Vb 1 \& pacsift \-\-name pacman | pacinfo \-\-short .Ve -.SH "OPTIONS" +.SH OPTIONS .IX Header "OPTIONS" -.IP "\fB\-\-config\fR=\fIpath\fR" 4 +.IP \fB\-\-config\fR=\fIpath\fR 4 .IX Item "--config=path" Set an alternate configuration file path. -.IP "\fB\-\-dbext\fR=\fIextension\fR" 4 +.IP \fB\-\-dbext\fR=\fIextension\fR 4 .IX Item "--dbext=extension" Set an alternate sync database extension. -.IP "\fB\-\-dbpath\fR=\fIpath\fR" 4 +.IP \fB\-\-dbpath\fR=\fIpath\fR 4 .IX Item "--dbpath=path" Set an alternate database path. -.IP "\fB\-\-root\fR=\fIpath\fR" 4 +.IP \fB\-\-root\fR=\fIpath\fR 4 .IX Item "--root=path" Set an alternate installation root. -.IP "\fB\-\-sysroot\fR=\fIpath\fR" 4 +.IP \fB\-\-sysroot\fR=\fIpath\fR 4 .IX Item "--sysroot=path" Set an alternate system root. See \fBpacutils\-sysroot\fR\|(7). -.IP "\fB\-\-null\fR[=\fIsep\fR]" 4 +.IP \fB\-\-null\fR[=\fIsep\fR] 4 .IX Item "--null[=sep]" Set an alternate separator for values parsed from \fIstdin\fR. By default a newline \f(CW\*(C`\en\*(C'\fR is used as the separator. If \fB\-\-null\fR is used without specifying \fIsep\fR \f(CW\*(C`NUL\*(C'\fR will be used. -.IP "\fB\-\-exists\fR" 4 +.IP \fB\-\-exists\fR 4 .IX Item "--exists" Exit with a non-zero value if no matches are found. -.IP "\fB\-\-not\-exists\fR" 4 +.IP \fB\-\-not\-exists\fR 4 .IX Item "--not-exists" Exit with a non-zero value if matches are found. -.IP "\fB\-\-invert\fR" 4 +.IP \fB\-\-invert\fR 4 .IX Item "--invert" -Return packages that \fB\s-1DO NOT\s0\fR match the provided search terms. -.IP "\fB\-\-any\fR" 4 +Return packages that \fBDO NOT\fR match the provided search terms. +.IP \fB\-\-any\fR 4 .IX Item "--any" Return the union of matched packages rather than the intersection. -.IP "\fB\-\-exact\fR" 4 +.IP \fB\-\-exact\fR 4 .IX Item "--exact" Match values exactly. -.IP "\fB\-\-regex\fR" 4 +.IP \fB\-\-regex\fR 4 .IX Item "--regex" Treat string values as extended case-insensitive regular expressions. -.IP "\fB\-\-help\fR" 4 +.IP \fB\-\-help\fR 4 .IX Item "--help" Display usage information and exit. -.IP "\fB\-\-version\fR" 4 +.IP \fB\-\-version\fR 4 .IX Item "--version" Display version information and exit. -.SS "Filters" +.SS Filters .IX Subsection "Filters" Filters limit the initial set of packages to be searched. They may not be used if packages are provided on \fIstdin\fR and they are not affected by \fB\-\-invert\fR or \fB\-\-any\fR. -.IP "\fB\-\-local\fR" 4 +.IP \fB\-\-local\fR 4 .IX Item "--local" Search locally installed packages. Similar to: pacsift \-\-repo=local | pacsift ... -.IP "\fB\-\-sync\fR" 4 +.IP \fB\-\-sync\fR 4 .IX Item "--sync" Search packages in sync databases. Similar to: pacsift \-\-invert \-\-repo=local | pacsift ... -.IP "\fB\-\-cache\fR (\fB\s-1EXPERIMENTAL\s0\fR)" 4 +.IP "\fB\-\-cache\fR (\fBEXPERIMENTAL\fR)" 4 .IX Item "--cache (EXPERIMENTAL)" Search packages in cache directories. .SS "String Fields" @@ -227,20 +149,20 @@ Search packages in cache directories. By default string fields will use a case-insensitive substring search. If \&\fB\-\-exact\fR is used string fields must match \fIval\fR exactly. If \f(CW\*(C`\-\-regex\*(C'\fR is used \fIval\fR will be used as an extended case-insensitive regular expression. -.IP "\fB\-\-repo\fR=\fIval\fR" 4 +.IP \fB\-\-repo\fR=\fIval\fR 4 .IX Item "--repo=val" .PD 0 -.IP "\fB\-\-name\fR=\fIval\fR" 4 +.IP \fB\-\-name\fR=\fIval\fR 4 .IX Item "--name=val" -.IP "\fB\-\-base\fR=\fIval\fR" 4 +.IP \fB\-\-base\fR=\fIval\fR 4 .IX Item "--base=val" -.IP "\fB\-\-description\fR=\fIval\fR" 4 +.IP \fB\-\-description\fR=\fIval\fR 4 .IX Item "--description=val" -.IP "\fB\-\-packager\fR=\fIval\fR" 4 +.IP \fB\-\-packager\fR=\fIval\fR 4 .IX Item "--packager=val" -.IP "\fB\-\-group\fR=\fIval\fR" 4 +.IP \fB\-\-group\fR=\fIval\fR 4 .IX Item "--group=val" -.IP "\fB\-\-owns\-file\fR=\fIpath\fR" 4 +.IP \fB\-\-owns\-file\fR=\fIpath\fR 4 .IX Item "--owns-file=path" .PD File paths must match the package database; no attempt is made to resolve the @@ -252,10 +174,10 @@ the owner of installed files: .Vb 1 \& pacsift \-\-local \-\-exact \-\-owns\-file="$(which pacsift)" .Ve -.IP "\fB\-\-license\fR=\fIval\fR" 4 +.IP \fB\-\-license\fR=\fIval\fR 4 .IX Item "--license=val" .PD 0 -.IP "\fB\-\-url\fR=\fIval\fR" 4 +.IP \fB\-\-url\fR=\fIval\fR 4 .IX Item "--url=val" .PD .SS "Dependency Fields" @@ -268,16 +190,16 @@ compared unless \fB\-\-exact\fR is used. If \f(CW\*(C`\-\-exact\*(C'\fR is used not provided only dependencies with no version specified will be matched. .PP Dependency fields are not affected by \fB\-\-regex\fR. -.IP "\fB\-\-provides\fR" 4 +.IP \fB\-\-provides\fR 4 .IX Item "--provides" .PD 0 -.IP "\fB\-\-conflicts\fR" 4 +.IP \fB\-\-conflicts\fR 4 .IX Item "--conflicts" -.IP "\fB\-\-replaces\fR" 4 +.IP \fB\-\-replaces\fR 4 .IX Item "--replaces" -.IP "\fB\-\-depends\fR" 4 +.IP \fB\-\-depends\fR 4 .IX Item "--depends" -.IP "\fB\-\-optdepends\fR" 4 +.IP \fB\-\-optdepends\fR 4 .IX Item "--optdepends" .PD .SS "Size Fields" @@ -286,12 +208,12 @@ Size fields may be prefixed with any of the following comparisons: \f(CW\*(C`=\* \&\f(CW\*(C`<\*(C'\fR, \f(CW\*(C`<=\*(C'\fR, \f(CW\*(C`>\*(C'\fR, \f(CW\*(C`>=\*(C'\fR. If no comparison is provided \f(CW\*(C`=\*(C'\fR will be used. The size may be followed by abbreviated unit. Units are case-sensitive. -.IP "\fB\-\-size\fR" 4 +.IP \fB\-\-size\fR 4 .IX Item "--size" .PD 0 -.IP "\fB\-\-installed\-size\fR" 4 +.IP \fB\-\-installed\-size\fR 4 .IX Item "--installed-size" -.IP "\fB\-\-download\-size\fR" 4 +.IP \fB\-\-download\-size\fR 4 .IX Item "--download-size" .PD .SS "Date Fields" @@ -301,18 +223,18 @@ Date fields may be prefixed with any of the following comparisons: \f(CW\*(C`=\* will be used. Dates may be provided as seconds since the epoch or any of the following \f(CW\*(C`strptime\*(C'\fR formats: \f(CW\*(C`%Y\-%m\-%d\*(C'\fR, \f(CW\*(C`%Y\-%m\-%d %H:%M\*(C'\fR, \&\f(CW\*(C`%Y\-%m\-%d %H:%M:%S\*(C'\fR. -.IP "\fB\-\-install\-date\fR" 4 +.IP \fB\-\-install\-date\fR 4 .IX Item "--install-date" .PD 0 -.IP "\fB\-\-build\-date\fR" 4 +.IP \fB\-\-build\-date\fR 4 .IX Item "--build-date" .PD -.SS "Other" +.SS Other .IX Subsection "Other" -.IP "\fB\-\-satisfies\fR=\fIdependency\fR" 4 +.IP \fB\-\-satisfies\fR=\fIdependency\fR 4 .IX Item "--satisfies=dependency" Search for packages that satisfy \fIdependency\fR. -.SH "EXAMPLES" +.SH EXAMPLES .IX Header "EXAMPLES" .IP "Find broken packages:" 4 .IX Item "Find broken packages:" @@ -341,7 +263,7 @@ Search for packages that satisfy \fIdependency\fR. .Vb 1 \& pacsift \-\-local \-\-exists \-\-satisfies pacman && echo "pacman is installed" .Ve -.SH "CAVEATS" +.SH CAVEATS .IX Header "CAVEATS" \&\fBpacsift\fR determines whether or not to read packages from \fIstdin\fR based on a naive check using \fBisatty\fR\|(3). If \fBpacsift\fR is called in an environment, |