diff -r 71503088f51b -r f880f219c566 openpkg/search.pod
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/openpkg/search.pod	Tue Jul 31 12:23:42 2012 +0200
@@ -0,0 +1,84 @@
+##
+##  search.pod -- OpenPKG Package Searching
+##  Copyright (c) 2000-2012 OpenPKG GmbH <http://openpkg.com/>
+##
+##  This software is property of the OpenPKG GmbH, DE MUC HRB 160208.
+##  All rights reserved. Licenses which grant limited permission to use,
+##  copy, modify and distribute this software are available from the
+##  OpenPKG GmbH.
+##
+##  THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
+##  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+##  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+##  IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+##  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+##  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+##  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+##  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+##  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+##  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+##  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+##  SUCH DAMAGE.
+##
+
+=pod
+
+=head1 NAME
+
+B<openpkg search> - B<OpenPKG> Package Searching
+
+=head1 SYNOPSIS
+
+B<openpkg>
+B<search>
+[B<-r> I<resource>]
+[B<-v>]
+I<regex> ...
+
+=head1 DESCRIPTION
+
+The B<openpkg search> tool is a frontend for searching indexed RPM
+packages. It downloads XML/RDF based resource index files from an RPM
+package repository and does a regular expression based search on each
+package's name, summary and description texts.
+
+=head1 OPTIONS
+
+The following command line options exist:
+
+=over 4
+
+=item B<-r> I<repository>
+
+Specify the path to an OpenPKG RPM package repository.
+This can be a URL (including "file://") to download packages from or
+an absolute directory path (identified by leading "/") or
+a relative directory path (identified by leading "./") to access packages directly.
+The name of the package file is appended to this path.
+The default is to use a URL pointing to the B<OpenPKG> download service
+as determined by the "B<openpkg release>" command.
+
+=item B<-v>
+
+Produces itemized verbose output instead of the default brief tabular
+output.
+
+=back
+
+=head1 SEE ALSO
+
+index(8), build(8).
+
+=head1 HISTORY
+
+The B<openpkg search> command was invented in May 2012 by I<Ralf S.
+Engelschall> E<lt>rse@engelschall.comE<gt> for use inside the B<OpenPKG>
+project E<lt>http://www.openpkg.org/E<gt>.
+
+=head1 AUTHORS
+
+ Ralf S. Engelschall
+ rse@engelschall.com
+
+=cut
+