Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml
Date: Wed, 03 Mar 2010 00:36:51
Message-Id: E1NmcZu-0008V0-Rq@stork.gentoo.org
1 nightmorph 10/03/03 00:36:42
2
3 Modified: hb-working-portage.xml
4 Log:
5 Wrote some stuff on ACCEPT_LICENSE, prompted by bug 292445
6
7 Revision Changes Path
8 1.74 xml/htdocs/doc/en/handbook/hb-working-portage.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.74&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.74&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.73&r2=1.74
13
14 Index: hb-working-portage.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
17 retrieving revision 1.73
18 retrieving revision 1.74
19 diff -u -r1.73 -r1.74
20 --- hb-working-portage.xml 13 Feb 2010 20:54:07 -0000 1.73
21 +++ hb-working-portage.xml 3 Mar 2010 00:36:42 -0000 1.74
22 @@ -4,7 +4,7 @@
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25
26 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.73 2010/02/13 20:54:07 nightmorph Exp $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.74 2010/03/03 00:36:42 nightmorph Exp $ -->
28
29 <sections>
30
31 @@ -13,8 +13,8 @@
32 maintain the software on his system.
33 </abstract>
34
35 -<version>1.66</version>
36 -<date>2010-02-13</date>
37 +<version>1.67</version>
38 +<date>2010-03-02</date>
39
40 <section>
41 <title>Welcome to Portage</title>
42 @@ -370,6 +370,96 @@
43 </body>
44 </subsection>
45 </section>
46 +<section id="license">
47 +<title>Licenses</title>
48 +<subsection>
49 +<body>
50 +
51 +<p>
52 +Beginning with Portage version 2.1.7, you can accept or reject software
53 +installation based on its license. All packages in the tree contain a
54 +<c>LICENSE</c> entry in their ebuilds. Running <c>emerge --search
55 +packagename</c> will tell you the package's license.
56 +</p>
57 +
58 +<p>
59 +By default, Portage permits all licenses, except End User License Agreements
60 +(EULAs) that require reading and signing an acceptance agreement.
61 +</p>
62 +
63 +<p>
64 +The variable that controls permitted licenses is <c>ACCEPT_LICENSE</c>, which
65 +can be set in <path>/etc/make.conf</path>:
66 +</p>
67 +
68 +<pre caption="Default ACCEPT_LICENSE in /etc/make.conf">
69 +ACCEPT_LICENSE="* -@EULA"
70 +</pre>
71 +
72 +<p>
73 +With this configuration, packages that require interaction during installation
74 +to approve their EULA <e>will not</e> be installed. Packages without an EULA
75 +<e>will</e> be installed.
76 +</p>
77 +
78 +<p>
79 +You can set <c>ACCEPT_LICENSE</c> globally in <path>/etc/make.conf</path>, or
80 +you can specify it on a per-package basis in
81 +<path>/etc/portage/package.license</path>.
82 +</p>
83 +
84 +<p>
85 +For example, if you want to allow the <c>truecrypt-2.7</c> license for
86 +<c>app-crypt/truecrypt</c>, add the following to
87 +<path>/etc/portage/package.license</path>:
88 +</p>
89 +
90 +<pre caption="Specifying a truecrypt license in package.license">
91 +app-crypt/truecrypt truecrypt-2.7
92 +</pre>
93 +
94 +<p>
95 +This permits installation of truecrypt versions that have the
96 +<c>truecrypt-2.7</c> license, but not versions with the <c>truecrypt-2.8</c>
97 +license.
98 +</p>
99 +
100 +<impo>
101 +Licenses are stored in <path>/usr/portage/licenses</path>, and license groups
102 +are kept in <path>/usr/portage/license_groups</path>. The first entry of each
103 +line in CAPITAL letters is the name of the license group, and every entry after
104 +that is an individual license.
105 +</impo>
106 +
107 +<p>
108 +License groups defined in <c>ACCEPT_LICENSE</c> are prefixed with an <b>@</b>
109 +sign. Here's an example of a system that globally permits the GPL-compatible
110 +license group, as well as a few other groups and individual licenses:
111 +</p>
112 +
113 +<pre caption="ACCEPT_LICENSE in /etc/make.conf">
114 +ACCEPT_LICENSE="@GPL-COMPATIBLE @OSI-APPROVED @EULA atheros-hal BitstreamVera"
115 +</pre>
116 +
117 +<p>
118 +If you want only free software and documentation on your system, you might use
119 +the following setup:
120 +</p>
121 +
122 +<pre caption="Use only free licenses">
123 +ACCEPT_LICENSE="-* @FREE"
124 +</pre>
125 +
126 +<p>
127 +In this case, "free" is mostly defined by the <uri
128 +link="http://www.gnu.org/philosophy/free-sw.html">FSF</uri> and <uri
129 +link="http://www.opensource.org/docs/osd">OSI</uri>. Any package whose license
130 +does not meet these requirements will not be installed on your system.
131 +</p>
132 +
133 +</body>
134 +</subsection>
135 +</section>
136 <section>
137 <title>When Portage is Complaining...</title>
138 <subsection>
139 @@ -491,6 +581,7 @@
140 - dev-util/cvsd-1.0.2 (masked by: <i>missing keyword</i>)
141 - games-fps/unreal-tournament-451 (masked by: <i>package.mask</i>)
142 - sys-libs/glibc-2.3.2-r11 (masked by: <i>profile</i>)
143 +- net-im/skype-2.1.0.81 (masked by: skype-eula <i>license</i>(s))
144 </pre>
145
146 <p>
147 @@ -525,6 +616,13 @@
148 profile. The application might break your system if you installed it or is
149 just not compatible with the profile you use.
150 </li>
151 + <li>
152 + <b>license</b> means that the package's license is not compatible with your
153 + <c>ACCEPT_LICENSE</c> setting. You must explicitly permit its license or
154 + license group by setting it in <path>/etc/make.conf</path> or in
155 + <path>/etc/portage/package.license</path>. Refer to <uri
156 + link="#license">Licenses</uri> to learn how licenses work.
157 + </li>
158 </ul>
159
160 </body>