From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 15A981382C5 for ; Sat, 20 Feb 2021 12:23:53 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 48E1EE083D; Sat, 20 Feb 2021 12:23:52 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 1F3E0E083D for ; Sat, 20 Feb 2021 12:23:52 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 972EB340DE6 for ; Sat, 20 Feb 2021 12:23:50 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 1B691487 for ; Sat, 20 Feb 2021 12:23:48 +0000 (UTC) From: "Fabian Groffen" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Fabian Groffen" Message-ID: <1613823806.08cdb5f41aa73580067e8668bc02c8e4be431a65.grobian@gentoo> Subject: [gentoo-commits] proj/portage-utils:master commit in: man/include/, /, man/ X-VCS-Repository: proj/portage-utils X-VCS-Files: applets.h man/include/qwhich.desc man/q.1 man/qatom.1 man/qcheck.1 man/qdepends.1 man/qfile.1 man/qgrep.1 man/qkeyword.1 man/qlist.1 man/qlop.1 man/qmanifest.1 man/qmerge.1 man/qpkg.1 man/qsearch.1 man/qsize.1 man/qtbz2.1 man/qtegrity.1 man/quse.1 man/qwhich.1 man/qxpak.1 X-VCS-Directories: / man/include/ man/ X-VCS-Committer: grobian X-VCS-Committer-Name: Fabian Groffen X-VCS-Revision: 08cdb5f41aa73580067e8668bc02c8e4be431a65 X-VCS-Branch: master Date: Sat, 20 Feb 2021 12:23:48 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 8acd8296-18ab-406a-b678-868701264339 X-Archives-Hash: f9e6ee7a71787354cc02b783e2e5330a commit: 08cdb5f41aa73580067e8668bc02c8e4be431a65 Author: Fabian Groffen gentoo org> AuthorDate: Sat Feb 20 12:23:26 2021 +0000 Commit: Fabian Groffen gentoo 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 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, "", "verify files with IMA"}, #endif {"quse", quse_main, "", "find pkgs using useflags"}, - {"qwhich", qwhich_main, "", "find path to pkg"}, + {"qwhich", qwhich_main, "", "find path to pkg"}, {"qxpak", qxpak_main, "", "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 : manipulate tbz2 packages qtegrity : verify files with IMA quse : find pkgs using useflags + qwhich : find path to pkg qxpak : manipulate xpak archives .fi .SH "REPORTING BUGS" @@ -104,4 +105,5 @@ Fabian Groffen .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 .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 .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 .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 .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 .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 .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 .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 .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 .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 .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 .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 .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 .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 .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 .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] \fR +\fI[opts] \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\fR, \fB\-\-format\fR \fI\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 .BR qsize (1), .BR qtbz2 (1), .BR qtegrity (1), -.BR quse (1) +.BR quse (1), +.BR qwhich (1)