o Change my personal copyright to the DragonFly copyright
[dragonfly.git] / usr.bin / pkg_search / pkg_search.1
1 .\"-
2 .\" Copyright (c) 2007 The DragonFly Project.  All rights reserved.
3 .\" 
4 .\" This code is derived from software contributed to The DragonFly Project
5 .\" by Matthias Schmidt <schmidtm@mathematik.uni-marburg.de>, University of
6 .\" Marburg.
7 .\" 
8 .\" All rights reserved.
9 .\"
10 .\" Redistribution and use in source and binary forms, with or without
11 .\" modification, are permitted provided that the following conditions are met:
12 .\"
13 .\" - Redistributions of source code must retain the above copyright notice,
14 .\"   this list of conditions and the following disclaimer.
15 .\" - Redistributions in binary form must reproduce the above copyright notice,
16 .\"   this list of conditions and the following disclaimer in the documentation
17 .\"   and/or other materials provided with the distribution.
18 .\" - Neither the name of The DragonFly Project nor the names of its
19 .\"   contributors may be used to endorse or promote products derived
20 .\"   from this software without specific, prior written permission.
21 .\"
22 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
25 .\" A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
26 .\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
27 .\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
28 .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
29 .\" PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
30 .\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
31 .\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
32 .\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 .\"
34 .\" $DragonFly: src/usr.bin/pkg_search/pkg_search.1,v 1.4 2007/12/27 11:52:10 matthias Exp $
35 .\"
36 .Dd December 13, 2007
37 .Dt PKG_SEARCH 1
38 .Os
39 .Sh NAME
40 .Nm pkg_search
41 .Nd print information about a package
42 .Sh SYNOPSIS
43 .Nm
44 .Op Fl k | v
45 .Ar package
46 .Sh DESCRIPTION
47 .Nm
48 queries the
49 .Xr pkgsrc 7
50 index for a given
51 .Ar package .
52 .Pp
53 The options are as follows:
54 .Bl -tag -width indent
55 .It Fl k
56 Also query the Info and WWW field.
57 .It Fl v
58 Print verbose information (Ports directory, URL, depencies)
59 .El
60 .Sh EXAMPLES
61 The following is an example of a typical usage
62 of the
63 .Nm
64 command:
65 .Pp
66 .Dl "pkg_search -v fvwm2"
67 .Sh SEE ALSO
68 .Xr pkg_add 1 ,
69 .Xr pkg_create 1 ,
70 .Xr pkg_delete 1 ,
71 .Xr pkg_info 1 ,
72 .Xr pkgsrc 7
73 .Sh AUTHORS
74 .Nm
75 was written by
76 .An Matthias Schmidt Aq schmidtm@mathematik.uni-marburg.de .
77 .Sh HISTORY
78 The
79 .Nm
80 utility first appeared in
81 .Dx 1.12 .
82