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 244AF1382C5 for ; Tue, 3 Apr 2018 15:21:06 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 47383E0A59; Tue, 3 Apr 2018 15:21:05 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (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 0A89EE0A59 for ; Tue, 3 Apr 2018 15:21:04 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (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 2EA84335C8A for ; Tue, 3 Apr 2018 15:21:03 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id E37C5264 for ; Tue, 3 Apr 2018 15:21:00 +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: <1522768783.454020200171d3d921b0f7e2229d4e527e1e6b2a.grobian@gentoo> Subject: [gentoo-commits] proj/portage-utils:master commit in: man/include/, /, man/ X-VCS-Repository: proj/portage-utils X-VCS-Files: man/include/quse.desc man/include/quse.optdesc.yaml man/quse.1 quse.c X-VCS-Directories: / man/include/ man/ X-VCS-Committer: grobian X-VCS-Committer-Name: Fabian Groffen X-VCS-Revision: 454020200171d3d921b0f7e2229d4e527e1e6b2a X-VCS-Branch: master Date: Tue, 3 Apr 2018 15:21:00 +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-Archives-Salt: 0a995758-e294-4181-a745-644f18f709a4 X-Archives-Hash: 23bbff3e392739c7328b22c1eaf7e71d commit: 454020200171d3d921b0f7e2229d4e527e1e6b2a Author: Fabian Groffen gentoo org> AuthorDate: Tue Apr 3 15:19:43 2018 +0000 Commit: Fabian Groffen gentoo org> CommitDate: Tue Apr 3 15:19:43 2018 +0000 URL: https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=45402020 quse: improve documentation Bug: https://bugs.gentoo.org/645554 man/include/quse.desc | 2 ++ man/include/quse.optdesc.yaml | 11 +++++++++++ man/quse.1 | 40 ++++++++++++++++++++++++---------------- quse.c | 4 ++-- 4 files changed, 39 insertions(+), 18 deletions(-) diff --git a/man/include/quse.desc b/man/include/quse.desc new file mode 100644 index 0000000..7492774 --- /dev/null +++ b/man/include/quse.desc @@ -0,0 +1,2 @@ +\fIquse\fR searches in ebuilds for a match in IUSE, KEYWORDS or LICENSE. +It can also search for USE-flags and show their descriptions. diff --git a/man/include/quse.optdesc.yaml b/man/include/quse.optdesc.yaml new file mode 100644 index 0000000..2a3675d --- /dev/null +++ b/man/include/quse.optdesc.yaml @@ -0,0 +1,11 @@ +exact: Search for exact string, e.g.\ do not use regular expression matching. +format: | + Advanced option to manually override the variable searched for in + ebuilds. By default, the search is \fIIUSE=\fR, the \fB\-K\fR and + \fB\-L\fR override that to \fIKEYWORDS=\fR and \fILICENSE=\fR + respectively. This option, sets the search to any variable. Note + that the equals sign is part of the search, and needs to be set. +verbose: | + Show problems encountered during parsing. These are mostly + diagnostic and indicate possible incorrectness in the results. +quiet: Ignored for compatibility with other qapplets. diff --git a/man/quse.1 b/man/quse.1 index e1e6db9..9b632b7 100644 --- a/man/quse.1 +++ b/man/quse.1 @@ -1,56 +1,64 @@ -.TH quse "1" "Mar 2016" "Gentoo Foundation" "quse" +.\" generated by mkman.py, please do NOT edit! +.TH quse "1" "Apr 2018" "Gentoo Foundation" "quse" .SH NAME quse \- find pkgs using useflags .SH SYNOPSIS .B quse \fI[opts] \fR .SH DESCRIPTION - +\fIquse\fR searches in ebuilds for a match in IUSE, KEYWORDS or LICENSE. +It can also search for USE-flags and show their descriptions. .SH OPTIONS .TP \fB\-e\fR, \fB\-\-exact\fR -Show exact non regexp matching using strcmp +Search for exact string, e.g.\ do not use regular expression matching. .TP \fB\-a\fR, \fB\-\-all\fR -Show annoying things in IUSE +List all ebuilds, don't match anything. .TP \fB\-K\fR, \fB\-\-keywords\fR -Use the KEYWORDS vs IUSE +Use the KEYWORDS vs IUSE. .TP \fB\-L\fR, \fB\-\-license\fR -Use the LICENSE vs IUSE +Use the LICENSE vs IUSE. .TP \fB\-D\fR, \fB\-\-describe\fR -Describe the USE flag +Describe the USE flag. .TP \fB\-F\fR \fI\fR, \fB\-\-format\fR \fI\fR -Use your own variable formats. -F NAME= +Advanced option to manually override the variable searched for in +ebuilds. By default, the search is \fIIUSE=\fR, the \fB\-K\fR and +\fB\-L\fR override that to \fIKEYWORDS=\fR and \fILICENSE=\fR +respectively. This option, sets the search to any variable. Note +that the equals sign is part of the search, and needs to be set. .TP \fB\-N\fR, \fB\-\-name\-only\fR -Only show package name +Only show package name. .TP \fB\-\-root\fR \fI\fR -Set the ROOT env var +Set the ROOT env var. .TP \fB\-v\fR, \fB\-\-verbose\fR -Make a lot of noise +Show problems encountered during parsing. These are mostly +diagnostic and indicate possible incorrectness in the results. .TP \fB\-q\fR, \fB\-\-quiet\fR -Tighter output; suppress warnings +Ignored for compatibility with other qapplets. .TP \fB\-C\fR, \fB\-\-nocolor\fR -Don't output color +Don't output color. .TP \fB\-h\fR, \fB\-\-help\fR -Print this help and exit +Print this help and exit. .TP \fB\-V\fR, \fB\-\-version\fR -Print version and exit +Print version and exit. .SH "REPORTING BUGS" Please report bugs via http://bugs.gentoo.org/ .br -Product: Portage Development; Component: Tools +Product: Portage Development; Component: Tools, Assignee: +portage-utils@gentoo.org .SH AUTHORS .nf Ned Ludd diff --git a/quse.c b/quse.c index ea8a326..05ba2f4 100644 --- a/quse.c +++ b/quse.c @@ -1,5 +1,5 @@ /* - * Copyright 2005-2014 Gentoo Foundation + * Copyright 2005-2018 Gentoo Foundation * Distributed under the terms of the GNU General Public License v2 * * Copyright 2005-2010 Ned Ludd - @@ -26,7 +26,7 @@ static struct option const quse_long_opts[] = { }; static const char * const quse_opts_help[] = { "Show exact non regexp matching using strcmp", - "Show annoying things in IUSE", + "List all ebuilds, don't match anything", "Use the KEYWORDS vs IUSE", "Use the LICENSE vs IUSE", "Describe the USE flag",