commit: 08cdb5f41aa73580067e8668bc02c8e4be431a65
Author: Fabian Groffen <grobian <AT> gentoo <DOT> org>
AuthorDate: Sat Feb 20 12:23:26 2021 +0000
Commit: Fabian Groffen <grobian <AT> gentoo <DOT> org>
CommitDate: Sat Feb 20 12:23:26 2021 +0000
URL: https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=08cdb5f4
man: regen with new qwhich manpage
Signed-off-by: Fabian Groffen <grobian <AT> gentoo.org>
applets.h | 2 +-
man/include/qwhich.desc | 15 +++++++++++++++
man/q.1 | 4 +++-
man/qatom.1 | 3 ++-
man/qcheck.1 | 3 ++-
man/qdepends.1 | 3 ++-
man/qfile.1 | 3 ++-
man/qgrep.1 | 3 ++-
man/qkeyword.1 | 3 ++-
man/qlist.1 | 3 ++-
man/qlop.1 | 3 ++-
man/qmanifest.1 | 3 ++-
man/qmerge.1 | 3 ++-
man/qpkg.1 | 3 ++-
man/qsearch.1 | 3 ++-
man/qsize.1 | 3 ++-
man/qtbz2.1 | 3 ++-
man/qtegrity.1 | 3 ++-
man/quse.1 | 3 ++-
man/qwhich.1 | 32 +++++++++++++++++++++++++++++---
man/qxpak.1 | 5 +++--
21 files changed, 83 insertions(+), 23 deletions(-)
diff --git a/applets.h b/applets.h
index f37cb63..956ab67 100644
--- a/applets.h
+++ b/applets.h
@@ -91,7 +91,7 @@ static const struct applet_t {
{"qtegrity", qtegrity_main, "<misc args>", "verify files with
IMA"},
#endif
{"quse", quse_main, "<useflag>", "find pkgs using
useflags"},
- {"qwhich", qwhich_main, "<useflag>", "find path to pkg"},
+ {"qwhich", qwhich_main, "<pkg ...>", "find path to pkg"},
{"qxpak", qxpak_main, "<misc args>", "manipulate xpak
archives"},
/* aliases for equery compatibility */
diff --git a/man/include/qwhich.desc b/man/include/qwhich.desc
new file mode 100644
index 0000000..abef4e2
--- /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 d98c3c3..2979cab 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 <grob...@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 d8c7cd6..99bf67a 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 <grob...@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 2473513..2d98408 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 <grob...@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 0eb7ba3..0690f16 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 <grob...@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 ffe0968..1f261d4 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 70d7eba..196a741 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 <grob...@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 d18bea6..2c7eaf5 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 <grob...@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 ed1d784..cfd25be 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 <grob...@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 a175332..7a3f2fe 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 <grob...@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 21f90c5..2ba3d64 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 <grob...@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 0fb67e0..870238b 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 <grob...@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 29e989d..c5c045c 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 <grob...@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 c24c17c..f38572c 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 <grob...@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 bcdfcbe..538cade 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 <grob...@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 1d8d6f7..17c30e9 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 <grob...@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 afba135..2b37579 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 8b1d21b..fe46d83 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 <grob...@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 dce52c2..66c30a4 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 5947e70..01902aa 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 <grob...@gentoo.org>
.BR qsize (1),
.BR qtbz2 (1),
.BR qtegrity (1),
-.BR quse (1)
+.BR quse (1),
+.BR qwhich (1)
