aboutsummaryrefslogtreecommitdiff
path: root/doc/configuration/suggestions.html.part.in
blob: cf174b755b09e2a7898b0845f4ba03fc6b383695 (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
<!-- vim: set tw=120 ft=html sw=4 sts=4 et : -->

<h1>suggestions.conf</h1>

###PALUDISENVIRONMENTONLY###

<p>The <code>suggestions.conf</code> file allows suggested dependencies to be automatically taken or ignored. It is a
standard configuration file which may be a bash file (<code>suggestions.bash</code>) and which may use the
<code>suggestions.conf.d/</code> directory. Note that suggestions are not generally used on Gentoo.</p>

<p>Each line in the file consists of a specification followed by one or more tokens. A specification may be any of:</p>

<ul>
    <li>The special specification <code>*/*</code>, which matches all packages.</li>
    <li>A simple <code>category/package</code> name.</li>
    <li>A simple <code>set</code> name.</li>
    <li>A complex dependency specification.</li>
</ul>

<p>Lines are considered only if the package containing the suggested dependency matches the specification.</p>

<p>A token may be one of the following:</p>

<ul>
    <li><code>*/*</code>, which says to take all suggestions from the package.</li>
    <li>A simple <code>cat/pkg</code>, which says to take any suggestions related to the named package. Note that
    complex dependency specifications may <em>not</em> be used here.</li>
    <li>A minus sign, followed by either of the above, to discard rather than take the suggestion in question.</li>
</ul>

<h2>Example</h2>

<pre>
# We are always interested in some suggestions from kdevelop:
dev-util/kdevelop dev-util/subversion kde-base/konsole

# We never want some other suggestions from kdevelop:
dev-util/kdevelop -dev-util/cvs

# We don't want any suggestions on kmail from anything:
*/* -kde-base/kmail

# Otherwise, we're interested in all kde-base suggestions:
kde-base/* */*
</pre>