openpkg/search.pod

changeset 746
75275e2bcfd7
equal deleted inserted replaced
-1:000000000000 0:52cef53601bc
1 ##
2 ## search.pod -- OpenPKG Package Searching
3 ## Copyright (c) 2000-2012 OpenPKG GmbH <http://openpkg.com/>
4 ##
5 ## This software is property of the OpenPKG GmbH, DE MUC HRB 160208.
6 ## All rights reserved. Licenses which grant limited permission to use,
7 ## copy, modify and distribute this software are available from the
8 ## OpenPKG GmbH.
9 ##
10 ## THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
11 ## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
12 ## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
13 ## IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
14 ## CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
15 ## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
16 ## LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
17 ## USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
18 ## ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
19 ## OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
20 ## OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
21 ## SUCH DAMAGE.
22 ##
23
24 =pod
25
26 =head1 NAME
27
28 B<openpkg search> - B<OpenPKG> Package Searching
29
30 =head1 SYNOPSIS
31
32 B<openpkg>
33 B<search>
34 [B<-r> I<resource>]
35 [B<-v>]
36 I<regex> ...
37
38 =head1 DESCRIPTION
39
40 The B<openpkg search> tool is a frontend for searching indexed RPM
41 packages. It downloads XML/RDF based resource index files from an RPM
42 package repository and does a regular expression based search on each
43 package's name, summary and description texts.
44
45 =head1 OPTIONS
46
47 The following command line options exist:
48
49 =over 4
50
51 =item B<-r> I<repository>
52
53 Specify the path to an OpenPKG RPM package repository.
54 This can be a URL (including "file://") to download packages from or
55 an absolute directory path (identified by leading "/") or
56 a relative directory path (identified by leading "./") to access packages directly.
57 The name of the package file is appended to this path.
58 The default is to use a URL pointing to the B<OpenPKG> download service
59 as determined by the "B<openpkg release>" command.
60
61 =item B<-v>
62
63 Produces itemized verbose output instead of the default brief tabular
64 output.
65
66 =back
67
68 =head1 SEE ALSO
69
70 index(8), build(8).
71
72 =head1 HISTORY
73
74 The B<openpkg search> command was invented in May 2012 by I<Ralf S.
75 Engelschall> E<lt>rse@engelschall.comE<gt> for use inside the B<OpenPKG>
76 project E<lt>http://www.openpkg.org/E<gt>.
77
78 =head1 AUTHORS
79
80 Ralf S. Engelschall
81 rse@engelschall.com
82
83 =cut
84

mercurial