xbps-bin(8): added a new target "find-files".

This new target 'find-files' can be used to find which installed
package(s) own a file. Exact matches like "/bin/mount" or patterns
like "/usr/lib/libb[ao]b\*" can be specified.

bin/xbps-bin/xbps-bin.8

@@ -2,12 +2,12 @@
 .\"     Title: xbps-bin
 .\"    Author: [see the "AUTHORS" section]
 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: 05/03/2010
+.\"      Date: 26/10/2010
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "XBPS\-BIN" "8" "05/03/2010" "\ \&" "\ \&"
+.TH "XBPS\-BIN" "8" "26/10/2010" "\ \&" "\ \&"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
@@ -122,6 +122,11 @@ packages currently installed will be checked, otherwise only
 \fBpkgname\fR\&.
 .RE
 .PP
+\fBfind-files\fR \fR\fB\fIpattern\fR\fR
+.RS 4
+Prints the name of the installed "\fBpackage(s)\fR" matching the \fBpattern\fR on its file list.
+.RE
+.PP
 \fBinstall \fR\fB\fIpkgname(s)\fR\fR\fB | \fR\fB\fIpkgpattern(s)\fR\fR
 .RS 4
 Install binary package(s) from repository pool by specifying "\fBpkgname(s)\fR" or "\fBpackage pattern(s)\fR"\&. The first repository matching the arguments will be used\&. The package(s) will be
@@ -324,6 +329,16 @@ $ xbps\-bin install "\fBfoo>=3\&.0\fR"
 .RS 4
 $ xbps\-bin install foo "\fBblah⇐4\&.0\fR" baz\-2\&.0 "\fBblob>4\&.[0\-9]\fR"
 .RE
+.PP
+\fBFind the package that owns the file \fB/bin/mount\fR:\fR
+.RS 4
+$ xbps\-bin find\-files /bin/mount
+.RE
+.PP
+\fBFind the packages that match the pattern "\fB/usr/lib/libav\&*\fR":
+.RS 4
+$ xbps\-bin find\-files "/usr/lib/libav\&*"
+.RE
 .SH "BUGS"
 .sp
 Probably, but I try to make this not happen\&. Use it under your own responsability and enjoy your life\&.