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