aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2007-10-22 22:19:10 +0000
committerAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2007-10-22 22:19:10 +0000
commitb65a30e5bca1bf3fb3b7fe997b8c92e60db2f94d (patch)
tree55846c958919eb01b5f5ecd1c7fc2dc0e0ad0e8e
parent1d20f5812f00a7c5f27cc07d9669723ee8a5a9e4 (diff)
downloadpaludis-b65a30e5bca1bf3fb3b7fe997b8c92e60db2f94d.tar.gz
paludis-b65a30e5bca1bf3fb3b7fe997b8c92e60db2f94d.tar.xz
licenses.conf
-rw-r--r--doc/configuration/Makefile.am12
-rw-r--r--doc/configuration/licenses.html.part.in41
2 files changed, 53 insertions, 0 deletions
diff --git a/doc/configuration/Makefile.am b/doc/configuration/Makefile.am
index 492e7e5..a7dde54 100644
--- a/doc/configuration/Makefile.am
+++ b/doc/configuration/Makefile.am
@@ -21,6 +21,8 @@ CLEANFILES = *~ gmon.out *.gcov *.gcno *.gcda \
keywords.html.part \
use.html \
use.html.part \
+ licenses.html \
+ licenses.html.part \
configfiles.html \
specs.html
@@ -52,6 +54,7 @@ paludisconfigurationhtml_DATA = \
specpath.html \
environment.html \
keywords.html \
+ licenses.html \
use.html \
configfiles.html \
specs.html
@@ -130,6 +133,12 @@ keywords.html.part : $(srcdir)/keywords.html.part.in $(srcdir)/paludisenvironmen
-e 's,###PALUDISENVIRONMENTONLY###,,g' \
< $(srcdir)/keywords.html.part.in > keywords.html.part
+licenses.html.part : $(srcdir)/licenses.html.part.in $(srcdir)/paludisenvironmentonly.html.part
+ sed \
+ -e '/###PALUDISENVIRONMENTONLY###/r $(srcdir)/paludisenvironmentonly.html.part' \
+ -e 's,###PALUDISENVIRONMENTONLY###,,g' \
+ < $(srcdir)/licenses.html.part.in > licenses.html.part
+
use.html.part : $(srcdir)/use.html.part.in $(srcdir)/paludisenvironmentonly.html.part
sed \
-e '/###PALUDISENVIRONMENTONLY###/r $(srcdir)/paludisenvironmentonly.html.part' \
@@ -148,6 +157,9 @@ environment.html : header.html.part environment.html.part footer.html.part
keywords.html : header.html.part keywords.html.part footer.html.part
cat header.html.part keywords.html.part footer.html.part > $@
+licenses.html : header.html.part licenses.html.part footer.html.part
+ cat header.html.part licenses.html.part footer.html.part > $@
+
use.html : header.html.part use.html.part footer.html.part
cat header.html.part use.html.part footer.html.part > $@
diff --git a/doc/configuration/licenses.html.part.in b/doc/configuration/licenses.html.part.in
new file mode 100644
index 0000000..918550e
--- /dev/null
+++ b/doc/configuration/licenses.html.part.in
@@ -0,0 +1,41 @@
+<!-- vim: set tw=120 ft=html sw=4 sts=4 et : -->
+
+<h1>licenses.conf</h1>
+
+###PALUDISENVIRONMENTONLY###
+
+<p>The <code>license.conf</code> file controls which licenses are and are not accepted. It is a standard configuration
+file which may be a bash file and which may use the <code>licenses.conf.d/</code> directory.</p>
+
+<p>Each line in the file consists of a specification followed by one or more licence 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>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>
+