commit: ec9c281b4fd5d4b36927c2b004bbcd0fe11f2d76 Author: Fabian Groffen <grobian <AT> gentoo <DOT> org> AuthorDate: Mon Apr 2 17:52:20 2018 +0000 Commit: Fabian Groffen <grobian <AT> gentoo <DOT> org> CommitDate: Mon Apr 2 17:52:20 2018 +0000 URL: https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=ec9c281b
qfile: update manpage Bug: https://bugs.gentoo.org/645554 man/include/qfile.desc | 4 ++++ man/include/qfile.optdesc.yaml | 7 +++++++ man/qfile.1 | 40 ++++++++++++++++++++++++---------------- 3 files changed, 35 insertions(+), 16 deletions(-) diff --git a/man/include/qfile.desc b/man/include/qfile.desc new file mode 100644 index 0000000..08d4bb3 --- /dev/null +++ b/man/include/qfile.desc @@ -0,0 +1,4 @@ +\fIqfile\fR searches packages for files they provide. The searched +packages must be installed, thus the search is for any file on the +filesystem, to what package that file belongs. It allows to identify +which package installed a certain file. diff --git a/man/include/qfile.optdesc.yaml b/man/include/qfile.optdesc.yaml new file mode 100644 index 0000000..cb1cd7a --- /dev/null +++ b/man/include/qfile.optdesc.yaml @@ -0,0 +1,7 @@ +verbose: | + Print package versions to matches, warn about problems with + resolving symlinks or positioning packages under an alternative + root. +quiet: | + Don't print matching file for matches, just the package. Don't + report about orphan files. diff --git a/man/qfile.1 b/man/qfile.1 index 5bd58c7..ff92897 100644 --- a/man/qfile.1 +++ b/man/qfile.1 @@ -1,48 +1,55 @@ -.TH qfile "1" "Jun 2016" "Gentoo Foundation" "qfile" +.\" generated by mkman.py, please do NOT edit! +.TH qfile "1" "Apr 2018" "Gentoo Foundation" "qfile" .SH NAME qfile \- list all pkgs owning files .SH SYNOPSIS .B qfile \fI[opts] <filename>\fR .SH DESCRIPTION - +\fIqfile\fR searches packages for files they provide. The searched +packages must be installed, thus the search is for any file on the +filesystem, to what package that file belongs. It allows to identify +which package installed a certain file. .SH OPTIONS .TP \fB\-S\fR, \fB\-\-slots\fR -Display installed packages with slots +Display installed packages with slots. .TP \fB\-R\fR, \fB\-\-root\-prefix\fR -Assume arguments are already prefixed by $ROOT +Assume arguments are already prefixed by $ROOT. .TP \fB\-b\fR, \fB\-\-basename\fR -Match any component of the path +Match any component of the path. .TP \fB\-o\fR, \fB\-\-orphans\fR -List orphan files +List orphan files. .TP \fB\-x\fR \fI<arg>\fR, \fB\-\-exclude\fR \fI<arg>\fR -Don't look in package <arg> (used with --orphans) +Don't look in package <arg> (used with --orphans). .TP \fB\-e\fR, \fB\-\-exact\fR -Exact match (used with --exclude) +Exact match (used with --exclude). .TP \fB\-\-root\fR \fI<arg>\fR -Set the ROOT env var +Set the ROOT env var. .TP \fB\-v\fR, \fB\-\-verbose\fR -Make a lot of noise +Print package versions to matches, warn about problems with +resolving symlinks or positioning packages under an alternative +root. .TP \fB\-q\fR, \fB\-\-quiet\fR -Tighter output; suppress warnings +Don't print matching file for matches, just the package. Don't +report about orphan files. .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 "FINDING FILES OWNERS" .PP This is the default behavior of \fBqfile\fP. It will list the packages which @@ -159,7 +166,7 @@ takes one argument, which can be a package name (\fBbash\fP or packages (ie., comparing the contents of one package with the contents of all the others). .PP -For example, the following script will search collisions beetween all your +For example, the following script will search collisions between all your installed packages. Be careful, this will takes time: .nf\fI #!/bin/bash @@ -202,7 +209,8 @@ TGL degrenier[at]easyconnect.fr .SH "REPORTING BUGS" Please report bugs via http://bugs.gentoo.org/ .br -Product: Portage Development; Component: Tools +Product: Portage Development; Component: Tools, Assignee: +portage-ut...@gentoo.org .SH AUTHORS .nf Ned Ludd <so...@gentoo.org>