docs/manual: refer to SPDX License List

We want to use SPDX short identifier for license string as much as
possible. So refer to SPDX license list and use SPDX short identifier
for license strings in documentation.

Also remove License abbreviations that we have.

Signed-off-by: Rahul Bedarkar <rahulbedarkar89@gmail.com>
[Thomas: take into account suggestions from Arnout.]
Acked-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
This commit is contained in:
Rahul Bedarkar 2017-03-30 19:13:30 +05:30 committed by Thomas Petazzoni
parent 11359c5e3b
commit 5286dec396
6 changed files with 11 additions and 86 deletions

View File

@ -22,7 +22,7 @@ system is based on hand-written Makefiles or shell scripts.
07: LIBFOO_VERSION = 1.0 07: LIBFOO_VERSION = 1.0
08: LIBFOO_SOURCE = libfoo-$(LIBFOO_VERSION).tar.gz 08: LIBFOO_SOURCE = libfoo-$(LIBFOO_VERSION).tar.gz
09: LIBFOO_SITE = http://www.foosoftware.org/download 09: LIBFOO_SITE = http://www.foosoftware.org/download
10: LIBFOO_LICENSE = GPLv3+ 10: LIBFOO_LICENSE = GPL-3.0+
11: LIBFOO_LICENSE_FILES = COPYING 11: LIBFOO_LICENSE_FILES = COPYING
12: LIBFOO_INSTALL_STAGING = YES 12: LIBFOO_INSTALL_STAGING = YES
13: LIBFOO_CONFIG_SCRIPTS = libfoo-config 13: LIBFOO_CONFIG_SCRIPTS = libfoo-config
@ -396,8 +396,8 @@ information is (assuming the package name is +libfoo+) :
* +LIBFOO_LICENSE+ defines the license (or licenses) under which the package * +LIBFOO_LICENSE+ defines the license (or licenses) under which the package
is released. is released.
This name will appear in the manifest file produced by +make legal-info+. This name will appear in the manifest file produced by +make legal-info+.
If the license appears in xref:legal-info-list-licenses[the following list], If the license appears in https://spdx.org/licenses/[the SPDX License List],
use the same string to make the manifest file uniform. use the SPDX short identifier to make the manifest file uniform.
Otherwise, describe the license in a precise and concise way, avoiding Otherwise, describe the license in a precise and concise way, avoiding
ambiguous names such as +BSD+ which actually name a family of licenses. ambiguous names such as +BSD+ which actually name a family of licenses.
This variable is optional. If it is not defined, +unknown+ will appear in This variable is optional. If it is not defined, +unknown+ will appear in
@ -405,12 +405,12 @@ information is (assuming the package name is +libfoo+) :
The expected format for this variable must comply with the following rules: The expected format for this variable must comply with the following rules:
** If different parts of the package are released under different ** If different parts of the package are released under different
licenses, then +comma+ separate licenses (e.g. +`LIBFOO_LICENSE = licenses, then +comma+ separate licenses (e.g. +`LIBFOO_LICENSE =
GPLv2+, LGPLv2.1+`+). If there is clear distinction between which GPL-2.0+, LGPL-2.1+`+). If there is clear distinction between which
component is licensed under what license, then annotate the license component is licensed under what license, then annotate the license
with that component, between parenthesis (e.g. +`LIBFOO_LICENSE = with that component, between parenthesis (e.g. +`LIBFOO_LICENSE =
GPLv2+ (programs), LGPLv2.1+ (libraries)`+). GPL-2.0+ (programs), LGPL-2.1+ (libraries)`+).
** If the package is dual licensed, then separate licenses with the ** If the package is dual licensed, then separate licenses with the
+or+ keyword (e.g. +`LIBFOO_LICENSE = AFLv2.1 or GPLv2+`+). +or+ keyword (e.g. +`LIBFOO_LICENSE = AFL-2.1 or GPL-2.0+`+).
* +LIBFOO_LICENSE_FILES+ is a space-separated list of files in the package * +LIBFOO_LICENSE_FILES+ is a space-separated list of files in the package
tarball that contain the license(s) under which the package is released. tarball that contain the license(s) under which the package is released.

View File

@ -24,7 +24,7 @@ builds a kernel module, and no other component:
07: FOO_VERSION = 1.2.3 07: FOO_VERSION = 1.2.3
08: FOO_SOURCE = foo-$(FOO_VERSION).tar.xz 08: FOO_SOURCE = foo-$(FOO_VERSION).tar.xz
09: FOO_SITE = http://www.foosoftware.org/download 09: FOO_SITE = http://www.foosoftware.org/download
10: FOO_LICENSE = GPLv2 10: FOO_LICENSE = GPL-2.0
11: FOO_LICENSE_FILES = COPYING 11: FOO_LICENSE_FILES = COPYING
12: 12:
13: $(eval $(kernel-module)) 13: $(eval $(kernel-module))
@ -63,7 +63,7 @@ Let's look at a more complex example:
07: FOO_VERSION = 1.2.3 07: FOO_VERSION = 1.2.3
08: FOO_SOURCE = foo-$(FOO_VERSION).tar.xz 08: FOO_SOURCE = foo-$(FOO_VERSION).tar.xz
09: FOO_SITE = http://www.foosoftware.org/download 09: FOO_SITE = http://www.foosoftware.org/download
10: FOO_LICENSE = GPLv2 10: FOO_LICENSE = GPL-2.0
11: FOO_LICENSE_FILES = COPYING 11: FOO_LICENSE_FILES = COPYING
12: 12:
13: FOO_MODULE_SUBDIRS = driver/base 13: FOO_MODULE_SUBDIRS = driver/base

View File

@ -21,7 +21,7 @@ with an example :
08: PERL_FOO_BAR_SOURCE = Foo-Bar-$(PERL_FOO_BAR_VERSION).tar.gz 08: PERL_FOO_BAR_SOURCE = Foo-Bar-$(PERL_FOO_BAR_VERSION).tar.gz
09: PERL_FOO_BAR_SITE = $(BR2_CPAN_MIRROR)/authors/id/M/MO/MONGER 09: PERL_FOO_BAR_SITE = $(BR2_CPAN_MIRROR)/authors/id/M/MO/MONGER
10: PERL_FOO_BAR_DEPENDENCIES = perl-strictures 10: PERL_FOO_BAR_DEPENDENCIES = perl-strictures
11: PERL_FOO_BAR_LICENSE = Artistic or GPLv1+ 11: PERL_FOO_BAR_LICENSE = Artistic or GPL-1.0+
12: PERL_FOO_BAR_LICENSE_FILES = LICENSE 12: PERL_FOO_BAR_LICENSE_FILES = LICENSE
13: 13:
14: $(eval $(perl-package)) 14: $(eval $(perl-package))

View File

@ -24,7 +24,7 @@ with an example :
07: PYTHON_FOO_VERSION = 1.0 07: PYTHON_FOO_VERSION = 1.0
08: PYTHON_FOO_SOURCE = python-foo-$(PYTHON_FOO_VERSION).tar.xz 08: PYTHON_FOO_SOURCE = python-foo-$(PYTHON_FOO_VERSION).tar.xz
09: PYTHON_FOO_SITE = http://www.foosoftware.org/download 09: PYTHON_FOO_SITE = http://www.foosoftware.org/download
10: PYTHON_FOO_LICENSE = BSD-3c 10: PYTHON_FOO_LICENSE = BSD-3-Clause
11: PYTHON_FOO_LICENSE_FILES = LICENSE 11: PYTHON_FOO_LICENSE_FILES = LICENSE
12: PYTHON_FOO_ENV = SOME_VAR=1 12: PYTHON_FOO_ENV = SOME_VAR=1
13: PYTHON_FOO_DEPENDENCIES = libmad 13: PYTHON_FOO_DEPENDENCIES = libmad

View File

@ -227,7 +227,7 @@ Finally, the patch should be signed off. This is done by adding
+Signed-off-by: Your Real Name <your@email.address>+ at the end of the +Signed-off-by: Your Real Name <your@email.address>+ at the end of the
commit message. +git commit -s+ does that for you, if configured commit message. +git commit -s+ does that for you, if configured
properly. The +Signed-off-by+ tag means that you publish the patch properly. The +Signed-off-by+ tag means that you publish the patch
under the Buildroot license (i.e. GPLv2, except for package patches, under the Buildroot license (i.e. GPL-2.0, except for package patches,
which have the upstream license), and that you are allowed to do so. which have the upstream license), and that you are allowed to do so.
See http://developercertificate.org/[the Developer Certificate of See http://developercertificate.org/[the Developer Certificate of
Origin] for details. Origin] for details.

View File

@ -83,81 +83,6 @@ of +make legal-info+ before using it as your own compliance delivery. See
the _NO WARRANTY_ clauses (clauses 11 and 12) in the +COPYING+ file at the the _NO WARRANTY_ clauses (clauses 11 and 12) in the +COPYING+ file at the
root of the Buildroot distribution. root of the Buildroot distribution.
[[legal-info-list-licenses]]
=== License abbreviations
Here is a list of the licenses that are most widely used by packages in
Buildroot, with the name used in the manifest files:
* `AGPLv3`:
http://www.gnu.org/licenses/agpl-3.0.en.html[
GNU Affero General Public License, version 3];
* `GPLv2`:
http://www.gnu.org/licenses/old-licenses/gpl-2.0.html[
GNU General Public License, version 2];
* `GPLv2+`:
http://www.gnu.org/licenses/old-licenses/gpl-2.0.html[
GNU General Public License, version 2]
or (at your option) any later version;
* `GPLv3`:
http://www.gnu.org/licenses/gpl.html[
GNU General Public License, version 3];
* `GPLv3+`:
http://www.gnu.org/licenses/gpl.html[
GNU General Public License, version 3]
or (at your option) any later version;
* `GPL`:
http://www.gnu.org/licenses/gpl.html[
GNU General Public License] (any version);
* `LGPLv2`:
http://www.gnu.org/licenses/old-licenses/lgpl-2.0.html[
GNU Library General Public License, version 2];
* `LGPLv2+`:
http://www.gnu.org/licenses/old-licenses/lgpl-2.0.html[
GNU Library General Public License, version 2]
or (at your option) any later version;
* `LGPLv2.1`:
http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html[
GNU Lesser General Public License, version 2.1];
* `LGPLv2.1+`:
http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html[
GNU Lesser General Public License, version 2.1]
or (at your option) any later version;
* `LGPLv3`:
http://www.gnu.org/licenses/lgpl.html[
GNU Lesser General Public License, version 3];
* `LGPLv3+`:
http://www.gnu.org/licenses/lgpl.html[
GNU Lesser General Public License, version 3]
or (at your option) any later version;
* `LGPL`:
http://www.gnu.org/licenses/lgpl.html[
GNU Lesser General Public License] (any version);
* `BSD-4c`:
http://directory.fsf.org/wiki/License:BSD_4Clause[
Original BSD 4-clause license];
* `BSD-3c`:
http://opensource.org/licenses/BSD-3-Clause[
BSD 3-clause license];
* `BSD-2c`:
http://opensource.org/licenses/BSD-2-Clause[
BSD 2-clause license];
* `MIT`:
http://opensource.org/licenses/mit-license.html[
MIT-style license];
* `Apache-2.0`:
http://apache.org/licenses/LICENSE-2.0.html[
Apache License, version 2.0];
* `ISC`:
https://opensource.org/licenses/ISC[
ISC License];
* `MPLv1.1`:
https://www.mozilla.org/en-US/MPL/1.1[
Mozilla Public License Version 1.1]
* `MPLv2.0`:
https://www.mozilla.org/en-US/MPL/2.0[
Mozilla Public License Version 2.0]
[[legal-info-buildroot]] [[legal-info-buildroot]]
=== Complying with the Buildroot license === Complying with the Buildroot license