en/glep/glep-0023.html

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!--
This HTML is auto-generated.  DO NOT EDIT THIS FILE!  If you are writing a new
PEP, see http://www.python.org/peps/pep-0001.html for instructions and links
to templates.  DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
-->
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta name="generator" content="Docutils 0.3.0: http://docutils.sourceforge.net/" />
  <title>GLEP 23 -- Portage handling of ACCEPT_LICENSE</title>
  <link rel="stylesheet" href="tools/glep.css" type="text/css" />
</head>
<body bgcolor="white">
<table class="navigation" cellpadding="0" cellspacing="0"
       width="100%" border="0">
<tr><td class="navicon" width="150" height="35">
<a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
 border="0" width="150" height="35" /></a></td>
<td class="textlinks" align="left">
[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>]
[<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>]
[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0023.txt">GLEP Source</a></b>]
</td></tr></table>
<div class="document">
<table class="rfc2822 field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">23</td>
</tr>
<tr class="field"><th class="field-name">Title:</th><td class="field-body">Portage handling of ACCEPT_LICENSE</td>
</tr>
<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.1</td>
</tr>
<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0023.txt?cvsroot=gentoo">2004/03/08 17:26:04</a></td>
</tr>
<tr class="field"><th class="field-name">Author:</th><td class="field-body">Jason Stubbs &lt;jstubbs&#32;&#97;t&#32;gentoo.org&gt;,</td>
</tr>
<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td>
</tr>
<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
</tr>
<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0002.html">text/x-rst</a></td>
</tr>
<tr class="field"><th class="field-name">Created:</th><td class="field-body">9-Mar-2004</td>
</tr>
<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">8-Mar-2004</td>
</tr>
</tbody>
</table>
<hr />
<div class="contents topic" id="contents">
<p class="topic-title"><a name="contents">Contents</a></p>
<ul class="simple">
<li><a class="reference" href="#abstract" id="id5" name="id5">Abstract</a></li>
<li><a class="reference" href="#motivation" id="id6" name="id6">Motivation</a></li>
<li><a class="reference" href="#specification" id="id7" name="id7">Specification</a><ul>
<li><a class="reference" href="#ebuild-license-variable" id="id8" name="id8">Ebuild LICENSE Variable</a></li>
<li><a class="reference" href="#license-groups" id="id9" name="id9">License Groups</a></li>
<li><a class="reference" href="#accept-license" id="id10" name="id10">ACCEPT_LICENSE</a></li>
<li><a class="reference" href="#emerge-behaviour" id="id11" name="id11">Emerge Behaviour</a></li>
</ul>
</li>
<li><a class="reference" href="#rationale" id="id12" name="id12">Rationale</a></li>
<li><a class="reference" href="#reference-implementation" id="id13" name="id13">Reference Implementation</a></li>
<li><a class="reference" href="#backwards-compatibility" id="id14" name="id14">Backwards Compatibility</a></li>
<li><a class="reference" href="#references" id="id15" name="id15">References</a></li>
<li><a class="reference" href="#copyright" id="id16" name="id16">Copyright</a></li>
</ul>
</div>
<div class="section" id="abstract">
<h1><a class="toc-backref" href="#id5" name="abstract">Abstract</a></h1>
<p>Currently, every ebuild in the portage tree is required to have a valid 
LICENSE entry.  However, the syntax of this entry is not officially 
defined and the entry itself is only used when outputting package 
details.</p>
</div>
<div class="section" id="motivation">
<h1><a class="toc-backref" href="#id6" name="motivation">Motivation</a></h1>
<p>Many users wish to regulate the software they install with regards to 
licenses for various reasons <a class="footnote-reference" href="#id3" id="id1" name="id1">[1]</a>.  Some want a system free of any 
software that is not OSI-approved; others are simply curious as to what 
licenses they are implicitly accepting.</p>
<p>Furthermore, some software requires that a user interactively accept its 
license for its author's to consider it legally binding.  This is 
currently implemented using <tt class="literal"><span class="pre">eutils.eclass</span></tt>.</p>
</div>
<div class="section" id="specification">
<h1><a class="toc-backref" href="#id7" name="specification">Specification</a></h1>
<div class="section" id="ebuild-license-variable">
<h2><a class="toc-backref" href="#id8" name="ebuild-license-variable">Ebuild LICENSE Variable</a></h2>
<p>Most ebuilds are for software which is released under a single license.  
In these cases, the current LICENSE variable can remain as is.  For 
example:</p>
<pre class="literal-block">
LICENSE=&quot;single-license&quot;
</pre>
<p>However, there are several ebuilds for software which is released under 
several licenses, of which the user must accept one, some or all <a class="footnote-reference" href="#id4" id="id2" name="id2">[2]</a>.  
To complicate this, some ebuilds include optional components which fall 
under a different license.</p>
<p>To accomodate these cases, LICENSE syntax should accomodate all 
functionality offered by a DEPEND string.  To keep things simple, this 
GLEP proposes that the syntax be identical.  For example:</p>
<pre class="literal-block">
LICENSE=&quot;mandatory-license \
    ( || choosable-licence1 chooseable-license-2 ) \
    useflag? ( optional-component-license )&quot;
</pre>
</div>
<div class="section" id="license-groups">
<h2><a class="toc-backref" href="#id9" name="license-groups">License Groups</a></h2>
<p>Almost all users are willing to install any software that is 
OSI-approved.  Other users are willing to install any software and 
implicitly accept its license.  To this end, portage will also need to 
handle grouping of licenses.</p>
<p>At a minimum, there needs to be the groups <tt class="literal"><span class="pre">OSI-APPROVED</span></tt> and 
<tt class="literal"><span class="pre">NON-INTERACTIVE</span></tt>.  <tt class="literal"><span class="pre">NON-INTERACTIVE</span></tt> licenses are those that don't 
require interactive acceptance for it to be considered legally binding.  
This is the current behaviour of portage.</p>
</div>
<div class="section" id="accept-license">
<h2><a class="toc-backref" href="#id10" name="accept-license">ACCEPT_LICENSE</a></h2>
<p>This GLEP proposes that a user be able to explicitly accept or decline 
licenses by editing a new variable <tt class="literal"><span class="pre">ACCEPT_LICENSE</span></tt> in 
<tt class="literal"><span class="pre">/etc/make.conf</span></tt>.  Again, to keep things simple, the syntax should be 
similar to that of other incrementals.  For example:</p>
<pre class="literal-block">
ACCEPT_LICENSE=&quot;-* accepted-license -declined-license&quot;
</pre>
<p>As an extension, <tt class="literal"><span class="pre">ACCEPT_LICENSE</span></tt> must also support <a class="reference" href="#license-groups">license groups</a>.  
This GLEP proposes that the license group be prepended by the special 
character &quot;<tt class="literal"><span class="pre">&#64;</span></tt>&quot;.  For example:</p>
<pre class="literal-block">
ACCEPT_LICENSE=&quot;-* &#64;OSI-APPROVED&quot;
</pre>
</div>
<div class="section" id="emerge-behaviour">
<h2><a class="toc-backref" href="#id11" name="emerge-behaviour">Emerge Behaviour</a></h2>
<p>At a minimum, emerge must handle unaccepted licenses the same way that 
it handles blockers.  That is, with the --pretend flag the 
not-yet-accepted license should be listed in the output.  Without the 
--pretend flag, emerge should stop before any software is installed.</p>
<p>This GLEP proposes that, unlike blockers, dependencies for software 
should be checked regardless of license acceptance.  Doing so will allow 
the user to review all necessary licenses before initiating an actual 
emerge.</p>
<p>It is also proposed that the --ask option will display an unaccepted 
license and ask for acceptance, but not update any configuration files 
at this stage.  Finally, the --verbose option should also list the 
licenses accepted for each package.</p>
</div>
</div>
<div class="section" id="rationale">
<h1><a class="toc-backref" href="#id12" name="rationale">Rationale</a></h1>
<p>An implementation of this proposal should make it easy for users wishing 
to regulate their software without affecting those that don't.</p>
</div>
<div class="section" id="reference-implementation">
<h1><a class="toc-backref" href="#id13" name="reference-implementation">Reference Implementation</a></h1>
<p>TODO</p>
</div>
<div class="section" id="backwards-compatibility">
<h1><a class="toc-backref" href="#id14" name="backwards-compatibility">Backwards Compatibility</a></h1>
<p>There should be no change to the user experience without the user 
explicitly choosing to do so.  This mandates that the 
configuration variable be named <tt class="literal"><span class="pre">ACCEPT_LICENSE</span></tt> as some users may 
already have it set due to ebuilds using <tt class="literal"><span class="pre">eutil.eclass</span></tt>'s 
implementation.  It also mandates that the default <tt class="literal"><span class="pre">ACCEPT_LICENSE</span></tt> be 
set to <tt class="literal"><span class="pre">&#64;NON-INTERACTIVE</span></tt>.</p>
</div>
<div class="section" id="references">
<h1><a class="toc-backref" href="#id15" name="references">References</a></h1>
<table class="footnote" frame="void" id="id3" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id1" name="id3">[1]</a></td><td>Gentoo Linux Bug 17367
(<a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=17367">http://bugs.gentoo.org/show_bug.cgi?id=17367</a>)</td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id4" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id2" name="id4">[2]</a></td><td>Gentoo Linux Bug 34146 
(<a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=34146">http://bugs.gentoo.org/show_bug.cgi?id=34146</a>)</td></tr>
</tbody>
</table>
</div>
<div class="section" id="copyright">
<h1><a class="toc-backref" href="#id16" name="copyright">Copyright</a></h1>
<p>This document has been placed in the public domain.</p>
</div>
</div>

<hr class="footer"/>
<div class="footer">
<a class="reference" href="glep-0023.txt">View document source</a>.
Generated on: 2004-03-08 17:26 UTC.
Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
</div>
</body>
</html>

1	<?xml version="1.0" encoding="utf-8" ?>
2	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3	<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4	<!--
5	This HTML is auto-generated. DO NOT EDIT THIS FILE! If you are writing a new
6	PEP, see http://www.python.org/peps/pep-0001.html for instructions and links
7	to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
8	-->
9	<head>
10	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11	<meta name="generator" content="Docutils 0.3.0: http://docutils.sourceforge.net/" />
12	<title>GLEP 23 -- Portage handling of ACCEPT_LICENSE</title>
13	<link rel="stylesheet" href="tools/glep.css" type="text/css" />
14	</head>
15	<body bgcolor="white">
16	<table class="navigation" cellpadding="0" cellspacing="0"
17	width="100%" border="0">
18	<tr><td class="navicon" width="150" height="35">
19	<a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
20	<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
21	border="0" width="150" height="35" /></a></td>
22	<td class="textlinks" align="left">
23	[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>]
24	[<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>]
25	[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0023.txt">GLEP Source</a></b>]
26	</td></tr></table>
27	<div class="document">
28	<table class="rfc2822 field-list" frame="void" rules="none">
29	<col class="field-name" />
30	<col class="field-body" />
31	<tbody valign="top">
32	<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">23</td>
33	</tr>
34	<tr class="field"><th class="field-name">Title:</th><td class="field-body">Portage handling of ACCEPT_LICENSE</td>
35	</tr>
36	<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.1</td>
37	</tr>
38	<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0023.txt?cvsroot=gentoo">2004/03/08 17:26:04</a></td>
39	</tr>
40	<tr class="field"><th class="field-name">Author:</th><td class="field-body">Jason Stubbs <jstubbs at gentoo.org>,</td>
41	</tr>
42	<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td>
43	</tr>
44	<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
45	</tr>
46	<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0002.html">text/x-rst</a></td>
47	</tr>
48	<tr class="field"><th class="field-name">Created:</th><td class="field-body">9-Mar-2004</td>
49	</tr>
50	<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">8-Mar-2004</td>
51	</tr>
52	</tbody>
53	</table>
54	<hr />
55	<div class="contents topic" id="contents">
56	<p class="topic-title"><a name="contents">Contents</a></p>
57	<ul class="simple">
58	<li><a class="reference" href="#abstract" id="id5" name="id5">Abstract</a></li>
59	<li><a class="reference" href="#motivation" id="id6" name="id6">Motivation</a></li>
60	<li><a class="reference" href="#specification" id="id7" name="id7">Specification</a><ul>
61	<li><a class="reference" href="#ebuild-license-variable" id="id8" name="id8">Ebuild LICENSE Variable</a></li>
62	<li><a class="reference" href="#license-groups" id="id9" name="id9">License Groups</a></li>
63	<li><a class="reference" href="#accept-license" id="id10" name="id10">ACCEPT_LICENSE</a></li>
64	<li><a class="reference" href="#emerge-behaviour" id="id11" name="id11">Emerge Behaviour</a></li>
65	</ul>
66	</li>
67	<li><a class="reference" href="#rationale" id="id12" name="id12">Rationale</a></li>
68	<li><a class="reference" href="#reference-implementation" id="id13" name="id13">Reference Implementation</a></li>
69	<li><a class="reference" href="#backwards-compatibility" id="id14" name="id14">Backwards Compatibility</a></li>
70	<li><a class="reference" href="#references" id="id15" name="id15">References</a></li>
71	<li><a class="reference" href="#copyright" id="id16" name="id16">Copyright</a></li>
72	</ul>
73	</div>
74	<div class="section" id="abstract">
75	<h1><a class="toc-backref" href="#id5" name="abstract">Abstract</a></h1>
76	<p>Currently, every ebuild in the portage tree is required to have a valid
77	LICENSE entry. However, the syntax of this entry is not officially
78	defined and the entry itself is only used when outputting package
79	details.</p>
80	</div>
81	<div class="section" id="motivation">
82	<h1><a class="toc-backref" href="#id6" name="motivation">Motivation</a></h1>
83	<p>Many users wish to regulate the software they install with regards to
84	licenses for various reasons <a class="footnote-reference" href="#id3" id="id1" name="id1">[1]</a>. Some want a system free of any
85	software that is not OSI-approved; others are simply curious as to what
86	licenses they are implicitly accepting.</p>
87	<p>Furthermore, some software requires that a user interactively accept its
88	license for its author's to consider it legally binding. This is
89	currently implemented using <tt class="literal"><span class="pre">eutils.eclass</span></tt>.</p>
90	</div>
91	<div class="section" id="specification">
92	<h1><a class="toc-backref" href="#id7" name="specification">Specification</a></h1>
93	<div class="section" id="ebuild-license-variable">
94	<h2><a class="toc-backref" href="#id8" name="ebuild-license-variable">Ebuild LICENSE Variable</a></h2>
95	<p>Most ebuilds are for software which is released under a single license.
96	In these cases, the current LICENSE variable can remain as is. For
97	example:</p>
98	<pre class="literal-block">
99	LICENSE="single-license"
100	</pre>
101	<p>However, there are several ebuilds for software which is released under
102	several licenses, of which the user must accept one, some or all <a class="footnote-reference" href="#id4" id="id2" name="id2">[2]</a>.
103	To complicate this, some ebuilds include optional components which fall
104	under a different license.</p>
105	<p>To accomodate these cases, LICENSE syntax should accomodate all
106	functionality offered by a DEPEND string. To keep things simple, this
107	GLEP proposes that the syntax be identical. For example:</p>
108	<pre class="literal-block">
109	LICENSE="mandatory-license \
110	( \|\| choosable-licence1 chooseable-license-2 ) \
111	useflag? ( optional-component-license )"
112	</pre>
113	</div>
114	<div class="section" id="license-groups">
115	<h2><a class="toc-backref" href="#id9" name="license-groups">License Groups</a></h2>
116	<p>Almost all users are willing to install any software that is
117	OSI-approved. Other users are willing to install any software and
118	implicitly accept its license. To this end, portage will also need to
119	handle grouping of licenses.</p>
120	<p>At a minimum, there needs to be the groups <tt class="literal"><span class="pre">OSI-APPROVED</span></tt> and
121	<tt class="literal"><span class="pre">NON-INTERACTIVE</span></tt>. <tt class="literal"><span class="pre">NON-INTERACTIVE</span></tt> licenses are those that don't
122	require interactive acceptance for it to be considered legally binding.
123	This is the current behaviour of portage.</p>
124	</div>
125	<div class="section" id="accept-license">
126	<h2><a class="toc-backref" href="#id10" name="accept-license">ACCEPT_LICENSE</a></h2>
127	<p>This GLEP proposes that a user be able to explicitly accept or decline
128	licenses by editing a new variable <tt class="literal"><span class="pre">ACCEPT_LICENSE</span></tt> in
129	<tt class="literal"><span class="pre">/etc/make.conf</span></tt>. Again, to keep things simple, the syntax should be
130	similar to that of other incrementals. For example:</p>
131	<pre class="literal-block">
132	ACCEPT_LICENSE="-* accepted-license -declined-license"
133	</pre>
134	<p>As an extension, <tt class="literal"><span class="pre">ACCEPT_LICENSE</span></tt> must also support <a class="reference" href="#license-groups">license groups</a>.
135	This GLEP proposes that the license group be prepended by the special
136	character "<tt class="literal"><span class="pre">@</span></tt>". For example:</p>
137	<pre class="literal-block">
138	ACCEPT_LICENSE="-* @OSI-APPROVED"
139	</pre>
140	</div>
141	<div class="section" id="emerge-behaviour">
142	<h2><a class="toc-backref" href="#id11" name="emerge-behaviour">Emerge Behaviour</a></h2>
143	<p>At a minimum, emerge must handle unaccepted licenses the same way that
144	it handles blockers. That is, with the --pretend flag the
145	not-yet-accepted license should be listed in the output. Without the
146	--pretend flag, emerge should stop before any software is installed.</p>
147	<p>This GLEP proposes that, unlike blockers, dependencies for software
148	should be checked regardless of license acceptance. Doing so will allow
149	the user to review all necessary licenses before initiating an actual
150	emerge.</p>
151	<p>It is also proposed that the --ask option will display an unaccepted
152	license and ask for acceptance, but not update any configuration files
153	at this stage. Finally, the --verbose option should also list the
154	licenses accepted for each package.</p>
155	</div>
156	</div>
157	<div class="section" id="rationale">
158	<h1><a class="toc-backref" href="#id12" name="rationale">Rationale</a></h1>
159	<p>An implementation of this proposal should make it easy for users wishing
160	to regulate their software without affecting those that don't.</p>
161	</div>
162	<div class="section" id="reference-implementation">
163	<h1><a class="toc-backref" href="#id13" name="reference-implementation">Reference Implementation</a></h1>
164	<p>TODO</p>
165	</div>
166	<div class="section" id="backwards-compatibility">
167	<h1><a class="toc-backref" href="#id14" name="backwards-compatibility">Backwards Compatibility</a></h1>
168	<p>There should be no change to the user experience without the user
169	explicitly choosing to do so. This mandates that the
170	configuration variable be named <tt class="literal"><span class="pre">ACCEPT_LICENSE</span></tt> as some users may
171	already have it set due to ebuilds using <tt class="literal"><span class="pre">eutil.eclass</span></tt>'s
172	implementation. It also mandates that the default <tt class="literal"><span class="pre">ACCEPT_LICENSE</span></tt> be
173	set to <tt class="literal"><span class="pre">@NON-INTERACTIVE</span></tt>.</p>
174	</div>
175	<div class="section" id="references">
176	<h1><a class="toc-backref" href="#id15" name="references">References</a></h1>
177	<table class="footnote" frame="void" id="id3" rules="none">
178	<colgroup><col class="label" /><col /></colgroup>
179	<tbody valign="top">
180	<tr><td class="label"><a class="fn-backref" href="#id1" name="id3">[1]</a></td><td>Gentoo Linux Bug 17367
181	(<a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=17367">http://bugs.gentoo.org/show_bug.cgi?id=17367</a>)</td></tr>
182	</tbody>
183	</table>
184	<table class="footnote" frame="void" id="id4" rules="none">
185	<colgroup><col class="label" /><col /></colgroup>
186	<tbody valign="top">
187	<tr><td class="label"><a class="fn-backref" href="#id2" name="id4">[2]</a></td><td>Gentoo Linux Bug 34146
188	(<a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=34146">http://bugs.gentoo.org/show_bug.cgi?id=34146</a>)</td></tr>
189	</tbody>
190	</table>
191	</div>
192	<div class="section" id="copyright">
193	<h1><a class="toc-backref" href="#id16" name="copyright">Copyright</a></h1>
194	<p>This document has been placed in the public domain.</p>
195	</div>
196	</div>
197
198	<hr class="footer"/>
199	<div class="footer">
200	<a class="reference" href="glep-0023.txt">View document source</a>.
201	Generated on: 2004-03-08 17:26 UTC.
202	Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
203	</div>
204	</body>
205	</html>
206