aboutsummaryrefslogtreecommitdiff
blob: bdba20a48dc029f503e71524c657fab32f5c7f81 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
<ol class="breadcrumb">
  <li><a href="/"><%= t :home %></a></li>
  <li><a href="/about"><%= t :about %></a></li>
  <li class="active"><%= t :queries %></li>
</ol>

<h1><%= t :queries %></h1>

This website provides a search functionality to find Gentoo packages. You can use field/value pairs combined with operators to run advanced search queries.
The possible fields and operators are summarized in the following tables:
<ul style="margin-top:5px;">
  <li><a href="#fields">Possible Fields</a></li>
  <li><a href="#operators">Possible Operators</a></li>
  <li><a href="#examples">Examples</a></li>
</ul>

<hr>

<h2 id="fields">Possible Fields</h2>

<table class="table">
  <thead>
  <tr>
    <th scope="col">Field</th>
    <th scope="col">Description</th>
  </tr>
  </thead>
  <tbody>
  <tr>
    <th scope="row">atom</th>
    <td>The unique identifier of a package <br> <i style="padding-left:2em">e.g. sys-kernel/gentoo-sources</i></td>
  </tr>
  <tr>
    <th scope="row">category</th>
    <td>The category of a package <br> <i style="padding-left:2em">e.g. sys-kernel</i></td>
  </tr>
  <tr>
    <th scope="row">name</th>
    <td>The name of a package <br> <i style="padding-left:2em">e.g. gentoo-sources</i></td>
  </tr>
  <tr>
    <th scope="row">description</th>
    <td>The description of a package <br> <i style="padding-left:2em">e.g. A tiling window manager</i> </td>
  </tr>
  <tr>
    <th scope="row">longdescription</th>
    <td>The full descripiton of a package <br> <i style="padding-left:2em">e.g. xmonad is a tiling window manager for [...]</i></td>
  </tr>
  <tr>
    <th scope="row">homepage</th>
    <td>The homepage of a package <br> <i style="padding-left:2em">e.g. http://xmonad.org</i></td>
  </tr>
  <tr>
    <th scope="row">license</th>
    <td>The license of a package <br> <i style="padding-left:2em">e.g. BSD</i></td>
  </tr>
  <tr>
    <th scope="row">Maintainers</th>
    <td></td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">maintainers.name</th>
    <td>The name of the maintainer <br> <i style="padding-left:2em">e.g. Gentoo Haskell</i></td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">maintainers.description</th>
    <td>The description of the maintainers</td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">maintainers.type</th>
    <td>The type of maintainter <br> <i style="padding-left:2em">e.g. project</i></td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">maintainers.restrict</th>
    <td></td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">maintainers.email</th>
    <td>The email of the maintainer <br> <i style="padding-left:2em">e.g. haskell@gentoo.org</i></td>
  </tr>
  <tr>
    <th scope="row">Useflag</th>
    <td></td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:1em">global</th>
    <td></td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">useflags.global.name</th>
    <td>The name of the global useflag <br> <i style="padding-left:2em">e.g. hscolour</i></td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">useflags.global.description</th>
    <td>The description of the global useflag <br> <i style="padding-left:2em">e.g. Include coloured haskell sources to [...]</i></td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:1em">local</th>
    <td></td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">useflags.local.name</th>
    <td>The name of the local useflag</td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">useflags.local.description</th>
    <td>The description of the local useflag</td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:1em">use_expand</th>
    <td></td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">useflags.use_expand.name</th>
    <td>The name of the local use_expand</td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">useflags.use_expand.description</th>
    <td>The description of the use_expand</td>
  </tr>
  <tr>
    <th scope="row" style="padding-left:2em">useflags.use_expand.use_expand_prefix</th>
    <td>The use_expand prefix <br> <i style="padding-left:2em">e.g. python_targets</i></td>
  </tr>
  <tr>
    <th scope="row">metadata_hash</th>
    <td>The hash of the metadata <br> <i style="padding-left:2em">e.g. 5cd76e098f966b4edcd1848866dd9099</i></td>
  </tr>
  </tbody>
</table>
<h2 id="operators">Possible Operators</h2>
The following operators can be used to combine multiple field/value pairs:
<table class="table">
  <thead>
  <tr>
    <th scope="col">Operator</th>
    <th scope="col">Description</th>
  </tr>
  </thead>
  <tbody>
  <tr>
    <th scope="row"></th>
    <td>The term <b>should</b> appear (default)</td>
  </tr>
  <tr>
    <th scope="row">+</th>
    <td>The term <b>must</b> appear</td>
  </tr>
  <tr>
    <th scope="row">-</th>
    <td>The term <b>must not</b> appear</td>
  </tr>
  <tr>
    <th scope="row">"..."</th>
    <td>Can be used to <b>group</b> phrases <br> <i style="padding-left:2em">e.g. +description:"window manager"</i></td>
  </tr>
  </tbody>
</table>

<h2 id="examples">Examples</h2>

<ul>
  <li>Find all packages named git: <br><code style="margin-left:2em">+name:git</code></li>
  <li>Find all packages in the category sys-kernel: <br><code style="margin-left:2em">+category:sys-kernel</code></li>
  <li>Find all packages with a BSD license: <br><code style="margin-left:2em">+license:BSD</code></li>
  <li>Find all packages that neither have a BSD license nor a MIT license: <br><code style="margin-left:2em">-license:BSD -license:MIT</code></li>
  <li>Find all packages maintained by the Haskell Team: <br><code style="margin-left:2em">+maintainer.email:haskell@gentoo.org</code></li>
  <li>Find all packages maintained by the Haskell Team but that aren't in the 'dev-haskell' category: <br><code style="margin-left:2em">+maintainer.email:haskell@gentoo.org -category:dev-haskell</code></li>
  <li>Find all packages those description contains 'window manager': <br><code style="margin-left:2em">+description:"window manager"</code></li>
  <li>Find all packages that contain the use_expand 'python_targets': <br><code style="margin-left:2em">+useflags.use_expand.use_expand_prefix:python_targets</code></li>
</ul>