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

<h1>licenses.conf / licences.conf</h1>

###PALUDISENVIRONMENTONLY###

<div class="note">
    <p>We apologise for misspelling 'licence' as 'license' throughout. This is done to match the ebuild variable
    'LICENSE', whose name cannot be fixed for Gentoo-based distributions for historical reasons.</p>
</div>

<p>On Gentoo and derived distributions, the <code>licenses.conf</code> file controls which licenses are and are not
accepted. It is a standard configuration file which may be a bash file (<code>licenses.bash</code>) and which may use the
<code>licenses.conf.d/</code> directory.</p>

<p>On Exherbo, the <code>licences.conf</code> file controls which licences are and are not accepted. It is a standard
configuration file which may be a bash file (<code>licences.bash</code>) and which may use the
<code>licences.conf.d/</code> directory.</p>

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

<ul>
    <li>The special specification <code>*/*</code>, which matches all packages. Nearly all users will have at least one
    line using this specification.</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>A license symbol can be any of:</p>

<ul>
    <li><code>license</code>, which accepts that license.</li>
    <li><code>-license</code>, which unaccepts that license.</li>
    <li><code>-*</code>, which unaccepts all licenses.</li>
    <li><code>*</code>, which accepts all licenses.</li>
</ul>

<p>Any token may be quoted using either single or double quotes. Note that CRAN repository entries can use spaces in
license names, so quoting would be required to explicitly accept those licenses.</p>

<p>License settings are cumulative. To <em>only</em> accept listed licenses for a given spec, include <code>-*</code> in
the symbols list.</p>

<h2>Example</h2>

<p>Most users will only want:</p>

<pre>
# Accept everything
*/* *
</pre>