aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorFabian Groffen <grobian@gentoo.org>2021-02-20 13:23:26 +0100
committerFabian Groffen <grobian@gentoo.org>2021-02-20 13:23:26 +0100
commit08cdb5f41aa73580067e8668bc02c8e4be431a65 (patch)
tree319fff10099b7bb52448f3e5ccaf547018709982 /man
parentqwhich: add options to skip virtual and acct-* categories (diff)
downloadportage-utils-08cdb5f41aa73580067e8668bc02c8e4be431a65.tar.gz
portage-utils-08cdb5f41aa73580067e8668bc02c8e4be431a65.tar.bz2
portage-utils-08cdb5f41aa73580067e8668bc02c8e4be431a65.zip
man: regen with new qwhich manpagev0.91
Signed-off-by: Fabian Groffen <grobian@gentoo.org>
Diffstat (limited to 'man')
-rw-r--r--man/include/qwhich.desc15
-rw-r--r--man/q.14
-rw-r--r--man/qatom.13
-rw-r--r--man/qcheck.13
-rw-r--r--man/qdepends.13
-rw-r--r--man/qfile.13
-rw-r--r--man/qgrep.13
-rw-r--r--man/qkeyword.13
-rw-r--r--man/qlist.13
-rw-r--r--man/qlop.13
-rw-r--r--man/qmanifest.13
-rw-r--r--man/qmerge.13
-rw-r--r--man/qpkg.13
-rw-r--r--man/qsearch.13
-rw-r--r--man/qsize.13
-rw-r--r--man/qtbz2.13
-rw-r--r--man/qtegrity.13
-rw-r--r--man/quse.13
-rw-r--r--man/qwhich.132
-rw-r--r--man/qxpak.15
20 files changed, 82 insertions, 22 deletions
diff --git a/man/include/qwhich.desc b/man/include/qwhich.desc
new file mode 100644
index 00000000..abef4e2a
--- /dev/null
+++ b/man/include/qwhich.desc
@@ -0,0 +1,15 @@
+.I qwhich
+returns the paths to the ebuilds matching the given atoms. Searching is
+done by default over the main ebuild repository and all configured
+overlays. When requested, a search can be made over the repository of
+installed packages (VDB) or binpkg repos.
+.P
+The default action is to print the full path to the latest ebuild for
+each package. This can be changed using \fB-d\fR to print the directory
+the ebuild is in instead. E.g\. one could \fBcd\fR(1) to this
+directory. Alternatively, one can request to stop searching after the
+first match using \fB-f\fR, which means at most one match per repo is
+returned.
+.P
+\fIqwhich\fR accepts atoms to search for, which can be any valid atom,
+including e.g\. version specifications to narrow the search.
diff --git a/man/q.1 b/man/q.1
index d98c3c36..2979cabd 100644
--- a/man/q.1
+++ b/man/q.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH q "1" "Nov 2020" "Gentoo Foundation" "q"
+.TH q "1" "Feb 2021" "Gentoo Foundation" "q"
.SH NAME
q \- invoke a portage utility applet
.SH SYNOPSIS
@@ -75,6 +75,7 @@ Print version and exit.
qtbz2 <misc args> : manipulate tbz2 packages
qtegrity <misc args> : verify files with IMA
quse <useflag> : find pkgs using useflags
+ qwhich <pkg ...> : find path to pkg
qxpak <misc args> : manipulate xpak archives
.fi
.SH "REPORTING BUGS"
@@ -104,4 +105,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qatom.1 b/man/qatom.1
index d8c7cd65..99bf67aa 100644
--- a/man/qatom.1
+++ b/man/qatom.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qatom "1" "Nov 2020" "Gentoo Foundation" "qatom"
+.TH qatom "1" "Feb 2021" "Gentoo Foundation" "qatom"
.SH NAME
qatom \- split atom strings
.SH SYNOPSIS
@@ -157,4 +157,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qcheck.1 b/man/qcheck.1
index 24735136..2d98408b 100644
--- a/man/qcheck.1
+++ b/man/qcheck.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qcheck "1" "Nov 2020" "Gentoo Foundation" "qcheck"
+.TH qcheck "1" "Feb 2021" "Gentoo Foundation" "qcheck"
.SH NAME
qcheck \- verify integrity of installed packages
.SH SYNOPSIS
@@ -81,4 +81,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qdepends.1 b/man/qdepends.1
index 0eb7ba3b..0690f166 100644
--- a/man/qdepends.1
+++ b/man/qdepends.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qdepends "1" "Nov 2020" "Gentoo Foundation" "qdepends"
+.TH qdepends "1" "Feb 2021" "Gentoo Foundation" "qdepends"
.SH NAME
qdepends \- show dependency info
.SH SYNOPSIS
@@ -165,4 +165,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qfile.1 b/man/qfile.1
index ffe09687..1f261d47 100644
--- a/man/qfile.1
+++ b/man/qfile.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qfile "1" "Nov 2020" "Gentoo Foundation" "qfile"
+.TH qfile "1" "Feb 2021" "Gentoo Foundation" "qfile"
.SH NAME
qfile \- list all pkgs owning files
.SH SYNOPSIS
@@ -256,4 +256,5 @@ TGL <degrenier[at]easyconnect.fr>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qgrep.1 b/man/qgrep.1
index 70d7ebab..196a741c 100644
--- a/man/qgrep.1
+++ b/man/qgrep.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qgrep "1" "Nov 2020" "Gentoo Foundation" "qgrep"
+.TH qgrep "1" "Feb 2021" "Gentoo Foundation" "qgrep"
.SH NAME
qgrep \- grep in ebuilds
.SH SYNOPSIS
@@ -105,4 +105,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qkeyword.1 b/man/qkeyword.1
index d18bea65..2c7eaf58 100644
--- a/man/qkeyword.1
+++ b/man/qkeyword.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qkeyword "1" "Nov 2020" "Gentoo Foundation" "qkeyword"
+.TH qkeyword "1" "Feb 2021" "Gentoo Foundation" "qkeyword"
.SH NAME
qkeyword \- list packages based on keywords
.SH SYNOPSIS
@@ -131,4 +131,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qlist.1 b/man/qlist.1
index ed1d7840..cfd25be5 100644
--- a/man/qlist.1
+++ b/man/qlist.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qlist "1" "Nov 2020" "Gentoo Foundation" "qlist"
+.TH qlist "1" "Feb 2021" "Gentoo Foundation" "qlist"
.SH NAME
qlist \- list files owned by pkgname
.SH SYNOPSIS
@@ -112,4 +112,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qlop.1 b/man/qlop.1
index a1753324..7a3f2fe7 100644
--- a/man/qlop.1
+++ b/man/qlop.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qlop "1" "Jan 2021" "Gentoo Foundation" "qlop"
+.TH qlop "1" "Feb 2021" "Gentoo Foundation" "qlop"
.SH NAME
qlop \- emerge log analyzer
.SH SYNOPSIS
@@ -174,4 +174,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qmanifest.1 b/man/qmanifest.1
index 21f90c51..2ba3d64c 100644
--- a/man/qmanifest.1
+++ b/man/qmanifest.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qmanifest "1" "Nov 2020" "Gentoo Foundation" "qmanifest"
+.TH qmanifest "1" "Feb 2021" "Gentoo Foundation" "qmanifest"
.SH NAME
qmanifest \- verify or generate thick Manifest files
.SH SYNOPSIS
@@ -117,4 +117,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qmerge.1 b/man/qmerge.1
index 0fb67e0e..870238b7 100644
--- a/man/qmerge.1
+++ b/man/qmerge.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qmerge "1" "Nov 2020" "Gentoo Foundation" "qmerge"
+.TH qmerge "1" "Feb 2021" "Gentoo Foundation" "qmerge"
.SH NAME
qmerge \- fetch and merge binary package
.SH SYNOPSIS
@@ -89,4 +89,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qpkg.1 b/man/qpkg.1
index 29e989d3..c5c045c6 100644
--- a/man/qpkg.1
+++ b/man/qpkg.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qpkg "1" "Nov 2020" "Gentoo Foundation" "qpkg"
+.TH qpkg "1" "Feb 2021" "Gentoo Foundation" "qpkg"
.SH NAME
qpkg \- create or manipulate Gentoo binpkgs
.SH SYNOPSIS
@@ -69,4 +69,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qsearch.1 b/man/qsearch.1
index c24c17c9..f38572cc 100644
--- a/man/qsearch.1
+++ b/man/qsearch.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qsearch "1" "Nov 2020" "Gentoo Foundation" "qsearch"
+.TH qsearch "1" "Feb 2021" "Gentoo Foundation" "qsearch"
.SH NAME
qsearch \- search pkgname/desc
.SH SYNOPSIS
@@ -77,4 +77,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qsize.1 b/man/qsize.1
index bcdfcbe1..538cade3 100644
--- a/man/qsize.1
+++ b/man/qsize.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qsize "1" "Nov 2020" "Gentoo Foundation" "qsize"
+.TH qsize "1" "Feb 2021" "Gentoo Foundation" "qsize"
.SH NAME
qsize \- calculate size usage
.SH SYNOPSIS
@@ -81,4 +81,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qtbz2.1 b/man/qtbz2.1
index 1d8d6f7e..17c30e9a 100644
--- a/man/qtbz2.1
+++ b/man/qtbz2.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qtbz2 "1" "Nov 2020" "Gentoo Foundation" "qtbz2"
+.TH qtbz2 "1" "Feb 2021" "Gentoo Foundation" "qtbz2"
.SH NAME
qtbz2 \- manipulate tbz2 packages
.SH SYNOPSIS
@@ -73,4 +73,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qsize (1),
.BR qtegrity (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qtegrity.1 b/man/qtegrity.1
index afba1358..2b375797 100644
--- a/man/qtegrity.1
+++ b/man/qtegrity.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qtegrity "1" "Nov 2020" "Gentoo Foundation" "qtegrity"
+.TH qtegrity "1" "Feb 2021" "Gentoo Foundation" "qtegrity"
.SH NAME
qtegrity \- verify files with IMA
.SH SYNOPSIS
@@ -79,4 +79,5 @@ Sam Besselink
.BR qsize (1),
.BR qtbz2 (1),
.BR quse (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/quse.1 b/man/quse.1
index 8b1d21b6..fe46d83b 100644
--- a/man/quse.1
+++ b/man/quse.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH quse "1" "Nov 2020" "Gentoo Foundation" "quse"
+.TH quse "1" "Feb 2021" "Gentoo Foundation" "quse"
.SH NAME
quse \- find pkgs using useflags
.SH SYNOPSIS
@@ -84,4 +84,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qsize (1),
.BR qtbz2 (1),
.BR qtegrity (1),
+.BR qwhich (1),
.BR qxpak (1)
diff --git a/man/qwhich.1 b/man/qwhich.1
index dce52c2e..66c30a42 100644
--- a/man/qwhich.1
+++ b/man/qwhich.1
@@ -4,9 +4,23 @@
qwhich \- find path to pkg
.SH SYNOPSIS
.B qwhich
-\fI[opts] <useflag>\fR
+\fI[opts] <pkg ...>\fR
.SH DESCRIPTION
-
+.I qwhich
+returns the paths to the ebuilds matching the given atoms. Searching is
+done by default over the main ebuild repository and all configured
+overlays. When requested, a search can be made over the repository of
+installed packages (VDB) or binpkg repos.
+.P
+The default action is to print the full path to the latest ebuild for
+each package. This can be changed using \fB-d\fR to print the directory
+the ebuild is in instead. E.g\. one could \fBcd\fR(1) to this
+directory. Alternatively, one can request to stop searching after the
+first match using \fB-f\fR, which means at most one match per repo is
+returned.
+.P
+\fIqwhich\fR accepts atoms to search for, which can be any valid atom,
+including e.g\. version specifications to narrow the search.
.SH OPTIONS
.TP
\fB\-I\fR, \fB\-\-vdb\fR
@@ -24,8 +38,20 @@ Print (pretty) atom instead of path for use with -F.
\fB\-d\fR, \fB\-\-dir\fR
Print directory instead of path.
.TP
+\fB\-R\fR, \fB\-\-repo\fR
+Print repository name instead of path for tree/overlay matches.
+.TP
\fB\-f\fR, \fB\-\-first\fR
-Stop searching after first match.
+Stop searching after first match (implies -l).
+.TP
+\fB\-l\fR, \fB\-\-latest\fR
+Only return latest version for each match.
+.TP
+\fB\-T\fR, \fB\-\-novirtual\fR
+Skip virtual category.
+.TP
+\fB\-A\fR, \fB\-\-noacct\fR
+Skip acct-user and acct-group categories.
.TP
\fB\-F\fR \fI<arg>\fR, \fB\-\-format\fR \fI<arg>\fR
Print matched using given format string.
diff --git a/man/qxpak.1 b/man/qxpak.1
index 5947e704..01902aa0 100644
--- a/man/qxpak.1
+++ b/man/qxpak.1
@@ -1,5 +1,5 @@
.\" generated by mkman.py, please do NOT edit!
-.TH qxpak "1" "Nov 2020" "Gentoo Foundation" "qxpak"
+.TH qxpak "1" "Feb 2021" "Gentoo Foundation" "qxpak"
.SH NAME
qxpak \- manipulate xpak archives
.SH SYNOPSIS
@@ -69,4 +69,5 @@ Fabian Groffen <grobian@gentoo.org>
.BR qsize (1),
.BR qtbz2 (1),
.BR qtegrity (1),
-.BR quse (1)
+.BR quse (1),
+.BR qwhich (1)