[libgpiod][PATCH 0/2] licensing: relicense C++ bindings and add a document on contributing

[libgpiod][PATCH 0/2] licensing: relicense C++ bindings and add a document on contributing

[Bartosz Golaszewski]

From: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>

I'm Cc'ing all copyright holders for this project's C++ source code since
the last license change which are Linaro, BayLibre and Kent Gibson. Please
kindly leave your Acks.

Bartosz Golaszewski (2):
  licensing: relicense C++ bindings under LGPL-2.1-or-later
  doc: add a file explaining the contribution process in detail

 CONTRIBUTING.md                             |  88 +++++++++++
 COPYING                                     |  11 +-
 LICENSES/LGPL-3.0-or-later.txt              | 165 --------------------
 README                                      |   2 +
 bindings/cxx/chip-info.cpp                  |   2 +-
 bindings/cxx/chip.cpp                       |   2 +-
 bindings/cxx/edge-event-buffer.cpp          |   2 +-
 bindings/cxx/edge-event.cpp                 |   2 +-
 bindings/cxx/exception.cpp                  |   2 +-
 bindings/cxx/gpiod.hpp                      |   2 +-
 bindings/cxx/gpiodcxx/chip-info.hpp         |   2 +-
 bindings/cxx/gpiodcxx/chip.hpp              |   2 +-
 bindings/cxx/gpiodcxx/edge-event-buffer.hpp |   2 +-
 bindings/cxx/gpiodcxx/edge-event.hpp        |   2 +-
 bindings/cxx/gpiodcxx/exception.hpp         |   2 +-
 bindings/cxx/gpiodcxx/info-event.hpp        |   2 +-
 bindings/cxx/gpiodcxx/line-config.hpp       |   2 +-
 bindings/cxx/gpiodcxx/line-info.hpp         |   2 +-
 bindings/cxx/gpiodcxx/line-request.hpp      |   2 +-
 bindings/cxx/gpiodcxx/line-settings.hpp     |   2 +-
 bindings/cxx/gpiodcxx/line.hpp              |   2 +-
 bindings/cxx/gpiodcxx/misc.hpp              |   2 +-
 bindings/cxx/gpiodcxx/request-builder.hpp   |   2 +-
 bindings/cxx/gpiodcxx/request-config.hpp    |   2 +-
 bindings/cxx/gpiodcxx/timestamp.hpp         |   2 +-
 bindings/cxx/info-event.cpp                 |   2 +-
 bindings/cxx/internal.cpp                   |   2 +-
 bindings/cxx/internal.hpp                   |   2 +-
 bindings/cxx/line-config.cpp                |   2 +-
 bindings/cxx/line-info.cpp                  |   2 +-
 bindings/cxx/line-request.cpp               |   2 +-
 bindings/cxx/line-settings.cpp              |   2 +-
 bindings/cxx/line.cpp                       |   2 +-
 bindings/cxx/misc.cpp                       |   2 +-
 bindings/cxx/request-builder.cpp            |   2 +-
 bindings/cxx/request-config.cpp             |   2 +-
 bindings/cxx/tests/gpiosim.cpp              |   2 +-
 bindings/cxx/tests/gpiosim.hpp              |   2 +-
 bindings/cxx/tests/helpers.cpp              |   2 +-
 bindings/cxx/tests/helpers.hpp              |   2 +-
 40 files changed, 127 insertions(+), 211 deletions(-)
 create mode 100644 CONTRIBUTING.md
 delete mode 100644 LICENSES/LGPL-3.0-or-later.txt

-- 
2.40.1

[libgpiod][PATCH 1/2] licensing: relicense C++ bindings under LGPL-2.1-or-later

[Bartosz Golaszewski]

From: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>

Commit ea84f882d5d3 ("licensing: relicense C++ library code under
LGPL-3.0-or-later") changed the license of C++ bindings in order to
solve potential issues with code generated from templates[1], default
implementations, etc. However this change makes the bindings less
attractive to projects that have strict licensing restrictions and avoid
GPL-3.0 code[2].

After talking to Grant Likely I decided that the best approach is to
make the bindings available under LGPL-v2.1-or-later and simply let the
end user decide which version's text to apply.

While at it: tweak the README to also mention that examples are provided
under GPL-2.0-or-later.

Link: [1] https://www.spinics.net/lists/linux-gpio/msg46605.html
Link: [2] https://github.com/brgl/libgpiod/issues/72
Suggested-by: Walter Lozano <walter.lozano@collabora.com>
Suggested-by: Grant Likely <grant.likely@linaro.org>
Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
---
 COPYING                                     |  11 +-
 LICENSES/LGPL-3.0-or-later.txt              | 165 --------------------
 bindings/cxx/chip-info.cpp                  |   2 +-
 bindings/cxx/chip.cpp                       |   2 +-
 bindings/cxx/edge-event-buffer.cpp          |   2 +-
 bindings/cxx/edge-event.cpp                 |   2 +-
 bindings/cxx/exception.cpp                  |   2 +-
 bindings/cxx/gpiod.hpp                      |   2 +-
 bindings/cxx/gpiodcxx/chip-info.hpp         |   2 +-
 bindings/cxx/gpiodcxx/chip.hpp              |   2 +-
 bindings/cxx/gpiodcxx/edge-event-buffer.hpp |   2 +-
 bindings/cxx/gpiodcxx/edge-event.hpp        |   2 +-
 bindings/cxx/gpiodcxx/exception.hpp         |   2 +-
 bindings/cxx/gpiodcxx/info-event.hpp        |   2 +-
 bindings/cxx/gpiodcxx/line-config.hpp       |   2 +-
 bindings/cxx/gpiodcxx/line-info.hpp         |   2 +-
 bindings/cxx/gpiodcxx/line-request.hpp      |   2 +-
 bindings/cxx/gpiodcxx/line-settings.hpp     |   2 +-
 bindings/cxx/gpiodcxx/line.hpp              |   2 +-
 bindings/cxx/gpiodcxx/misc.hpp              |   2 +-
 bindings/cxx/gpiodcxx/request-builder.hpp   |   2 +-
 bindings/cxx/gpiodcxx/request-config.hpp    |   2 +-
 bindings/cxx/gpiodcxx/timestamp.hpp         |   2 +-
 bindings/cxx/info-event.cpp                 |   2 +-
 bindings/cxx/internal.cpp                   |   2 +-
 bindings/cxx/internal.hpp                   |   2 +-
 bindings/cxx/line-config.cpp                |   2 +-
 bindings/cxx/line-info.cpp                  |   2 +-
 bindings/cxx/line-request.cpp               |   2 +-
 bindings/cxx/line-settings.cpp              |   2 +-
 bindings/cxx/line.cpp                       |   2 +-
 bindings/cxx/misc.cpp                       |   2 +-
 bindings/cxx/request-builder.cpp            |   2 +-
 bindings/cxx/request-config.cpp             |   2 +-
 bindings/cxx/tests/gpiosim.cpp              |   2 +-
 bindings/cxx/tests/gpiosim.hpp              |   2 +-
 bindings/cxx/tests/helpers.cpp              |   2 +-
 bindings/cxx/tests/helpers.hpp              |   2 +-
 38 files changed, 37 insertions(+), 211 deletions(-)
 delete mode 100644 LICENSES/LGPL-3.0-or-later.txt

diff --git a/COPYING b/COPYING
index 87a9de5..84b4fc6 100644
--- a/COPYING
+++ b/COPYING
@@ -7,7 +7,7 @@ or any later version according with:
 
     LICENSES/LGPL-2.1-or-later.txt
 
-gpio-tools and test suites are provided under:
+gpio-tools, test suites and examples are provided under:
 
     SPDX-License-Identifier: GPL-2.0-or-later
 
@@ -16,15 +16,6 @@ later version according with:
 
     LICENSES/GPL-2.0-or-later.txt
 
-C++ bindings to libgpiod are provided under:
-
-    SPDX-License-Identifier: LGPL-3.0-or-later
-
-Being under the terms of the GNU Lesser General Public License version 3.0
-or any later version according with:
-
-    LICENSES/LGPL-3.0-or-later.txt
-
 The Linux Kernel uAPI headers are provided under:
 
     SPDX-License-Identifier: GPL-2.0-only WITH Linux-syscall-note
diff --git a/LICENSES/LGPL-3.0-or-later.txt b/LICENSES/LGPL-3.0-or-later.txt
deleted file mode 100644
index 0a04128..0000000
--- a/LICENSES/LGPL-3.0-or-later.txt
+++ /dev/null
@@ -1,165 +0,0 @@
-                   GNU LESSER GENERAL PUBLIC LICENSE
-                       Version 3, 29 June 2007
-
- Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-
-  This version of the GNU Lesser General Public License incorporates
-the terms and conditions of version 3 of the GNU General Public
-License, supplemented by the additional permissions listed below.
-
-  0. Additional Definitions.
-
-  As used herein, "this License" refers to version 3 of the GNU Lesser
-General Public License, and the "GNU GPL" refers to version 3 of the GNU
-General Public License.
-
-  "The Library" refers to a covered work governed by this License,
-other than an Application or a Combined Work as defined below.
-
-  An "Application" is any work that makes use of an interface provided
-by the Library, but which is not otherwise based on the Library.
-Defining a subclass of a class defined by the Library is deemed a mode
-of using an interface provided by the Library.
-
-  A "Combined Work" is a work produced by combining or linking an
-Application with the Library.  The particular version of the Library
-with which the Combined Work was made is also called the "Linked
-Version".
-
-  The "Minimal Corresponding Source" for a Combined Work means the
-Corresponding Source for the Combined Work, excluding any source code
-for portions of the Combined Work that, considered in isolation, are
-based on the Application, and not on the Linked Version.
-
-  The "Corresponding Application Code" for a Combined Work means the
-object code and/or source code for the Application, including any data
-and utility programs needed for reproducing the Combined Work from the
-Application, but excluding the System Libraries of the Combined Work.
-
-  1. Exception to Section 3 of the GNU GPL.
-
-  You may convey a covered work under sections 3 and 4 of this License
-without being bound by section 3 of the GNU GPL.
-
-  2. Conveying Modified Versions.
-
-  If you modify a copy of the Library, and, in your modifications, a
-facility refers to a function or data to be supplied by an Application
-that uses the facility (other than as an argument passed when the
-facility is invoked), then you may convey a copy of the modified
-version:
-
-   a) under this License, provided that you make a good faith effort to
-   ensure that, in the event an Application does not supply the
-   function or data, the facility still operates, and performs
-   whatever part of its purpose remains meaningful, or
-
-   b) under the GNU GPL, with none of the additional permissions of
-   this License applicable to that copy.
-
-  3. Object Code Incorporating Material from Library Header Files.
-
-  The object code form of an Application may incorporate material from
-a header file that is part of the Library.  You may convey such object
-code under terms of your choice, provided that, if the incorporated
-material is not limited to numerical parameters, data structure
-layouts and accessors, or small macros, inline functions and templates
-(ten or fewer lines in length), you do both of the following:
-
-   a) Give prominent notice with each copy of the object code that the
-   Library is used in it and that the Library and its use are
-   covered by this License.
-
-   b) Accompany the object code with a copy of the GNU GPL and this license
-   document.
-
-  4. Combined Works.
-
-  You may convey a Combined Work under terms of your choice that,
-taken together, effectively do not restrict modification of the
-portions of the Library contained in the Combined Work and reverse
-engineering for debugging such modifications, if you also do each of
-the following:
-
-   a) Give prominent notice with each copy of the Combined Work that
-   the Library is used in it and that the Library and its use are
-   covered by this License.
-
-   b) Accompany the Combined Work with a copy of the GNU GPL and this license
-   document.
-
-   c) For a Combined Work that displays copyright notices during
-   execution, include the copyright notice for the Library among
-   these notices, as well as a reference directing the user to the
-   copies of the GNU GPL and this license document.
-
-   d) Do one of the following:
-
-       0) Convey the Minimal Corresponding Source under the terms of this
-       License, and the Corresponding Application Code in a form
-       suitable for, and under terms that permit, the user to
-       recombine or relink the Application with a modified version of
-       the Linked Version to produce a modified Combined Work, in the
-       manner specified by section 6 of the GNU GPL for conveying
-       Corresponding Source.
-
-       1) Use a suitable shared library mechanism for linking with the
-       Library.  A suitable mechanism is one that (a) uses at run time
-       a copy of the Library already present on the user's computer
-       system, and (b) will operate properly with a modified version
-       of the Library that is interface-compatible with the Linked
-       Version.
-
-   e) Provide Installation Information, but only if you would otherwise
-   be required to provide such information under section 6 of the
-   GNU GPL, and only to the extent that such information is
-   necessary to install and execute a modified version of the
-   Combined Work produced by recombining or relinking the
-   Application with a modified version of the Linked Version. (If
-   you use option 4d0, the Installation Information must accompany
-   the Minimal Corresponding Source and Corresponding Application
-   Code. If you use option 4d1, you must provide the Installation
-   Information in the manner specified by section 6 of the GNU GPL
-   for conveying Corresponding Source.)
-
-  5. Combined Libraries.
-
-  You may place library facilities that are a work based on the
-Library side by side in a single library together with other library
-facilities that are not Applications and are not covered by this
-License, and convey such a combined library under terms of your
-choice, if you do both of the following:
-
-   a) Accompany the combined library with a copy of the same work based
-   on the Library, uncombined with any other library facilities,
-   conveyed under the terms of this License.
-
-   b) Give prominent notice with the combined library that part of it
-   is a work based on the Library, and explaining where to find the
-   accompanying uncombined form of the same work.
-
-  6. Revised Versions of the GNU Lesser General Public License.
-
-  The Free Software Foundation may publish revised and/or new versions
-of the GNU Lesser General Public License from time to time. Such new
-versions will be similar in spirit to the present version, but may
-differ in detail to address new problems or concerns.
-
-  Each version is given a distinguishing version number. If the
-Library as you received it specifies that a certain numbered version
-of the GNU Lesser General Public License "or any later version"
-applies to it, you have the option of following the terms and
-conditions either of that published version or of any later version
-published by the Free Software Foundation. If the Library as you
-received it does not specify a version number of the GNU Lesser
-General Public License, you may choose any version of the GNU Lesser
-General Public License ever published by the Free Software Foundation.
-
-  If the Library as you received it specifies that a proxy can decide
-whether future versions of the GNU Lesser General Public License shall
-apply, that proxy's public statement of acceptance of any version is
-permanent authorization for you to choose that version for the
-Library.
diff --git a/bindings/cxx/chip-info.cpp b/bindings/cxx/chip-info.cpp
index c4f0ab5..93dd6f5 100644
--- a/bindings/cxx/chip-info.cpp
+++ b/bindings/cxx/chip-info.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <ostream>
diff --git a/bindings/cxx/chip.cpp b/bindings/cxx/chip.cpp
index d6a3a43..8086839 100644
--- a/bindings/cxx/chip.cpp
+++ b/bindings/cxx/chip.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <ostream>
diff --git a/bindings/cxx/edge-event-buffer.cpp b/bindings/cxx/edge-event-buffer.cpp
index c7347a2..0d5cb36 100644
--- a/bindings/cxx/edge-event-buffer.cpp
+++ b/bindings/cxx/edge-event-buffer.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <iterator>
diff --git a/bindings/cxx/edge-event.cpp b/bindings/cxx/edge-event.cpp
index 5ff3af2..9ef311c 100644
--- a/bindings/cxx/edge-event.cpp
+++ b/bindings/cxx/edge-event.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <map>
diff --git a/bindings/cxx/exception.cpp b/bindings/cxx/exception.cpp
index 6957e78..378b249 100644
--- a/bindings/cxx/exception.cpp
+++ b/bindings/cxx/exception.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include "internal.hpp"
diff --git a/bindings/cxx/gpiod.hpp b/bindings/cxx/gpiod.hpp
index b090af4..91e41a5 100644
--- a/bindings/cxx/gpiod.hpp
+++ b/bindings/cxx/gpiod.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/chip-info.hpp b/bindings/cxx/gpiodcxx/chip-info.hpp
index b6bd0f8..e740e94 100644
--- a/bindings/cxx/gpiodcxx/chip-info.hpp
+++ b/bindings/cxx/gpiodcxx/chip-info.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/chip.hpp b/bindings/cxx/gpiodcxx/chip.hpp
index 297db3d..4d67476 100644
--- a/bindings/cxx/gpiodcxx/chip.hpp
+++ b/bindings/cxx/gpiodcxx/chip.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/edge-event-buffer.hpp b/bindings/cxx/gpiodcxx/edge-event-buffer.hpp
index 025517f..2482e8a 100644
--- a/bindings/cxx/gpiodcxx/edge-event-buffer.hpp
+++ b/bindings/cxx/gpiodcxx/edge-event-buffer.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/edge-event.hpp b/bindings/cxx/gpiodcxx/edge-event.hpp
index 4fde561..47c256a 100644
--- a/bindings/cxx/gpiodcxx/edge-event.hpp
+++ b/bindings/cxx/gpiodcxx/edge-event.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/exception.hpp b/bindings/cxx/gpiodcxx/exception.hpp
index e89b384..34737d2 100644
--- a/bindings/cxx/gpiodcxx/exception.hpp
+++ b/bindings/cxx/gpiodcxx/exception.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/info-event.hpp b/bindings/cxx/gpiodcxx/info-event.hpp
index e99cbc4..69b88b6 100644
--- a/bindings/cxx/gpiodcxx/info-event.hpp
+++ b/bindings/cxx/gpiodcxx/info-event.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/line-config.hpp b/bindings/cxx/gpiodcxx/line-config.hpp
index 8a3335c..58c9d87 100644
--- a/bindings/cxx/gpiodcxx/line-config.hpp
+++ b/bindings/cxx/gpiodcxx/line-config.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/line-info.hpp b/bindings/cxx/gpiodcxx/line-info.hpp
index 26d25a9..8b10dc4 100644
--- a/bindings/cxx/gpiodcxx/line-info.hpp
+++ b/bindings/cxx/gpiodcxx/line-info.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/line-request.hpp b/bindings/cxx/gpiodcxx/line-request.hpp
index dfe3e0f..fcc4e0e 100644
--- a/bindings/cxx/gpiodcxx/line-request.hpp
+++ b/bindings/cxx/gpiodcxx/line-request.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/line-settings.hpp b/bindings/cxx/gpiodcxx/line-settings.hpp
index bacf359..1004ccd 100644
--- a/bindings/cxx/gpiodcxx/line-settings.hpp
+++ b/bindings/cxx/gpiodcxx/line-settings.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/line.hpp b/bindings/cxx/gpiodcxx/line.hpp
index 5d0752a..2810571 100644
--- a/bindings/cxx/gpiodcxx/line.hpp
+++ b/bindings/cxx/gpiodcxx/line.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/misc.hpp b/bindings/cxx/gpiodcxx/misc.hpp
index 1e41e9b..eab8eba 100644
--- a/bindings/cxx/gpiodcxx/misc.hpp
+++ b/bindings/cxx/gpiodcxx/misc.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/request-builder.hpp b/bindings/cxx/gpiodcxx/request-builder.hpp
index 90cc8f0..192bd91 100644
--- a/bindings/cxx/gpiodcxx/request-builder.hpp
+++ b/bindings/cxx/gpiodcxx/request-builder.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/request-config.hpp b/bindings/cxx/gpiodcxx/request-config.hpp
index b099eb1..6ebbf99 100644
--- a/bindings/cxx/gpiodcxx/request-config.hpp
+++ b/bindings/cxx/gpiodcxx/request-config.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/gpiodcxx/timestamp.hpp b/bindings/cxx/gpiodcxx/timestamp.hpp
index 7143ab3..fcb4d8d 100644
--- a/bindings/cxx/gpiodcxx/timestamp.hpp
+++ b/bindings/cxx/gpiodcxx/timestamp.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 /**
diff --git a/bindings/cxx/info-event.cpp b/bindings/cxx/info-event.cpp
index 0b19ee9..1f6d0d7 100644
--- a/bindings/cxx/info-event.cpp
+++ b/bindings/cxx/info-event.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <map>
diff --git a/bindings/cxx/internal.cpp b/bindings/cxx/internal.cpp
index 9f1f38f..237d5d5 100644
--- a/bindings/cxx/internal.cpp
+++ b/bindings/cxx/internal.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <map>
diff --git a/bindings/cxx/internal.hpp b/bindings/cxx/internal.hpp
index db78af6..b64daf1 100644
--- a/bindings/cxx/internal.hpp
+++ b/bindings/cxx/internal.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 #ifndef __LIBGPIOD_CXX_INTERNAL_HPP__
diff --git a/bindings/cxx/line-config.cpp b/bindings/cxx/line-config.cpp
index 1179e0a..7e3dc8c 100644
--- a/bindings/cxx/line-config.cpp
+++ b/bindings/cxx/line-config.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <cstdlib>
diff --git a/bindings/cxx/line-info.cpp b/bindings/cxx/line-info.cpp
index 9931ed0..2117f68 100644
--- a/bindings/cxx/line-info.cpp
+++ b/bindings/cxx/line-info.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <map>
diff --git a/bindings/cxx/line-request.cpp b/bindings/cxx/line-request.cpp
index e8e0b96..f6b0a66 100644
--- a/bindings/cxx/line-request.cpp
+++ b/bindings/cxx/line-request.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <iterator>
diff --git a/bindings/cxx/line-settings.cpp b/bindings/cxx/line-settings.cpp
index 30d7899..300858a 100644
--- a/bindings/cxx/line-settings.cpp
+++ b/bindings/cxx/line-settings.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <map>
diff --git a/bindings/cxx/line.cpp b/bindings/cxx/line.cpp
index d99e8fa..d6a92c1 100644
--- a/bindings/cxx/line.cpp
+++ b/bindings/cxx/line.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <iterator>
diff --git a/bindings/cxx/misc.cpp b/bindings/cxx/misc.cpp
index dde48e0..eba0b46 100644
--- a/bindings/cxx/misc.cpp
+++ b/bindings/cxx/misc.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include "internal.hpp"
diff --git a/bindings/cxx/request-builder.cpp b/bindings/cxx/request-builder.cpp
index d11e47b..87ee2fe 100644
--- a/bindings/cxx/request-builder.cpp
+++ b/bindings/cxx/request-builder.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <ostream>
diff --git a/bindings/cxx/request-config.cpp b/bindings/cxx/request-config.cpp
index e578b15..b44b8b6 100644
--- a/bindings/cxx/request-config.cpp
+++ b/bindings/cxx/request-config.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include <ostream>
diff --git a/bindings/cxx/tests/gpiosim.cpp b/bindings/cxx/tests/gpiosim.cpp
index 7267e6d..4bda5a2 100644
--- a/bindings/cxx/tests/gpiosim.cpp
+++ b/bindings/cxx/tests/gpiosim.cpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 #include <map>
diff --git a/bindings/cxx/tests/gpiosim.hpp b/bindings/cxx/tests/gpiosim.hpp
index 320ae96..8151af6 100644
--- a/bindings/cxx/tests/gpiosim.hpp
+++ b/bindings/cxx/tests/gpiosim.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 #ifndef __GPIOD_CXX_GPIOSIM_HPP__
diff --git a/bindings/cxx/tests/helpers.cpp b/bindings/cxx/tests/helpers.cpp
index 6534fdb..eb2c3db 100644
--- a/bindings/cxx/tests/helpers.cpp
+++ b/bindings/cxx/tests/helpers.cpp
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: LGPL-2.1-or-later
 // SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl>
 
 #include "helpers.hpp"
diff --git a/bindings/cxx/tests/helpers.hpp b/bindings/cxx/tests/helpers.hpp
index 157d221..62d9827 100644
--- a/bindings/cxx/tests/helpers.hpp
+++ b/bindings/cxx/tests/helpers.hpp
@@ -1,4 +1,4 @@
-/* SPDX-License-Identifier: LGPL-3.0-or-later */
+/* SPDX-License-Identifier: LGPL-2.1-or-later */
 /* SPDX-FileCopyrightText: 2021-2022 Bartosz Golaszewski <brgl@bgdev.pl> */
 
 #ifndef __GPIOD_CXX_TEST_HELPERS_HPP__
-- 
2.40.1

[libgpiod][PATCH 2/2] doc: add a file explaining the contribution process in detail

[Bartosz Golaszewski]

From: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>

Add a separate document explaining the contribution process for libgpiod
with emphasis on the Developer's Certificate of Origin.

I based the text of this document on the one written by Grant Likely[1]
and adjusted it for libgpiod.

[1] https://github.com/glikely/obs-ptz/blob/main/CONTRIBUTING.md

Suggested-by: Grant Likely <grant.likely@linaro.org>
Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
---
 CONTRIBUTING.md | 88 +++++++++++++++++++++++++++++++++++++++++++++++++
 README          |  2 ++
 2 files changed, 90 insertions(+)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..79b3d80
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,88 @@
+Contributing
+============
+
+Master copy of this project is hosted at kernel.org:
+https://git.kernel.org/pub/scm/libs/libgpiod/libgpiod.git/
+
+Anyone may contribute to this project. Contributions are licensed under GPLv2
+for programs and LGPLv2.1 for libraries and must be made with a Developer
+Certificate of Origin [DCO] "Signed-off-by:" attestation as described below,
+indicating that you wrote the code and have the right to pass it on as an open
+source patch under the GPLv2 license. Patches that are not signed off will not
+be accepted.
+
+Send patches using `git send-email` to the linux-gpio mailing list[2] by
+e-mailing to linux-gpio@vger.kernel.org (add the [libgpiod] prefix to the
+e-mail subject line). Note that the mailing list quietly drops HTML formatted
+e-mail, so be sure to send plain text[3].
+
+Also, please write good git commit messages. A good commit message looks like
+this:
+
+```
+section: explain the commit in one line (use the imperative)
+
+Body of commit message is a few lines of text, explaining things
+in more detail, possibly giving some background about the issue
+being fixed, etc etc.
+
+The body of the commit message can be several paragraphs, and
+please do proper word-wrap and keep columns shorter than about
+74 characters or so. That way "git log" will show things
+nicely even when it's indented.
+
+Make sure you explain your solution and why you're doing what you're
+doing, as opposed to describing what you're doing. Reviewers and your
+future self can read the patch, but might not understand why a
+particular solution was implemented.
+
+Reported-by: whoever-reported-it
+Signed-off-by: Your Name <you@example.com>
+```
+
+Where that header line really should be meaningful, and really should be just
+one line. That header line is what is shown by tools like gitk and shortlog,
+and should summarize the change in one readable line of text, independently of
+the longer explanation. Please use verbs in the imperative in the commit
+message, as in "Fix bug that...", "Add file/feature ...", or "Make plugin ...".
+
+DCO Attestation
+---------------
+
+To help track the origin of contributions, this project uses the same [DCO]
+"sign-off" process as used by the Linux kernel. The sign-off is a simple line
+at the end of the explanation for the patch, which certifies that you wrote it
+or otherwise have the right to pass it on as an open-source patch. The rules
+are pretty simple: if you can certify the below:
+
+### Developer's Certificate of Origin 1.1
+
+By making a contribution to this project, I certify that:
+
+        (a) The contribution was created in whole or in part by me and I
+            have the right to submit it under the open source license
+            indicated in the file; or
+
+        (b) The contribution is based upon previous work that, to the best
+            of my knowledge, is covered under an appropriate open source
+            license and I have the right under that license to submit that
+            work with modifications, whether created in whole or in part
+            by me, under the same open source license (unless I am
+            permitted to submit under a different license), as indicated
+            in the file; or
+
+        (c) The contribution was provided directly to me by some other
+            person who certified (a), (b) or (c) and I have not modified
+            it.
+
+        (d) I understand and agree that this project and the contribution
+            are public and that a record of the contribution (including all
+            personal information I submit with it, including my sign-off) is
+            maintained indefinitely and may be redistributed consistent with
+            this project or the open source license(s) involved.
+
+then you just add a line saying:
+
+        Signed-off-by: Random J Developer <random@developer.example.org>
+
+[DCO]: https://developercertificate.org/
diff --git a/README b/README
index ec60ea1..7a92a49 100644
--- a/README
+++ b/README
@@ -298,6 +298,8 @@ discussions and although PRs can be submitted and discussed, upstreambound
 patches need to go through the mailing list nevertheless while release
 tarballs should be fetched from kernel.org[8].
 
+For more information, refer to CONTRIBUTING.md in this repository.
+
 [1] https://github.com/kward/shunit2
 [2] http://vger.kernel.org/vger-lists.html#linux-gpio
 [3] https://docs.kernel.org/process/email-clients.html
-- 
2.40.1

Re: [libgpiod][PATCH 1/2] licensing: relicense C++ bindings under LGPL-2.1-or-later

[Kent Gibson]

On Tue, Apr 16, 2024 at 11:21:40PM +0200, Bartosz Golaszewski wrote:
> From: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
>
> Commit ea84f882d5d3 ("licensing: relicense C++ library code under
> LGPL-3.0-or-later") changed the license of C++ bindings in order to
> solve potential issues with code generated from templates[1], default
> implementations, etc. However this change makes the bindings less
> attractive to projects that have strict licensing restrictions and avoid
> GPL-3.0 code[2].
>
> After talking to Grant Likely I decided that the best approach is to
> make the bindings available under LGPL-v2.1-or-later and simply let the
> end user decide which version's text to apply.
>
> While at it: tweak the README to also mention that examples are provided
> under GPL-2.0-or-later.
>
> Link: [1] https://www.spinics.net/lists/linux-gpio/msg46605.html
> Link: [2] https://github.com/brgl/libgpiod/issues/72
> Suggested-by: Walter Lozano <walter.lozano@collabora.com>
> Suggested-by: Grant Likely <grant.likely@linaro.org>
> Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>

Acked-by: Kent Gibson <warthog618@gmail.com>

Re: [libgpiod][PATCH 1/2] licensing: relicense C++ bindings under LGPL-2.1-or-later

[Kevin Hilman]

Bartosz Golaszewski <brgl@bgdev.pl> writes:

> From: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
>
> Commit ea84f882d5d3 ("licensing: relicense C++ library code under
> LGPL-3.0-or-later") changed the license of C++ bindings in order to
> solve potential issues with code generated from templates[1], default
> implementations, etc. However this change makes the bindings less
> attractive to projects that have strict licensing restrictions and avoid
> GPL-3.0 code[2].
>
> After talking to Grant Likely I decided that the best approach is to
> make the bindings available under LGPL-v2.1-or-later and simply let the
> end user decide which version's text to apply.
>
> While at it: tweak the README to also mention that examples are provided
> under GPL-2.0-or-later.
>
> Link: [1] https://www.spinics.net/lists/linux-gpio/msg46605.html
> Link: [2] https://github.com/brgl/libgpiod/issues/72
> Suggested-by: Walter Lozano <walter.lozano@collabora.com>
> Suggested-by: Grant Likely <grant.likely@linaro.org>
> Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>

Acked-by: Kevin Hilman <khilman@baylibre.com>

Re: [libgpiod][PATCH 0/2] licensing: relicense C++ bindings and add a document on contributing

[Grant Likely]

On Tue, Apr 16, 2024 at 10:21 PM Bartosz Golaszewski <brgl@bgdev.pl> wrote:
>
> From: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
>
> I'm Cc'ing all copyright holders for this project's C++ source code since
> the last license change which are Linaro, BayLibre and Kent Gibson. Please
> kindly leave your Acks.
>
> Bartosz Golaszewski (2):
>   licensing: relicense C++ bindings under LGPL-2.1-or-later
>   doc: add a file explaining the contribution process in detail

For the series:
Acked-by: Grant Likely <grant.likely@linaro.org>

>
>  CONTRIBUTING.md                             |  88 +++++++++++
>  COPYING                                     |  11 +-
>  LICENSES/LGPL-3.0-or-later.txt              | 165 --------------------
>  README                                      |   2 +
>  bindings/cxx/chip-info.cpp                  |   2 +-
>  bindings/cxx/chip.cpp                       |   2 +-
>  bindings/cxx/edge-event-buffer.cpp          |   2 +-
>  bindings/cxx/edge-event.cpp                 |   2 +-
>  bindings/cxx/exception.cpp                  |   2 +-
>  bindings/cxx/gpiod.hpp                      |   2 +-
>  bindings/cxx/gpiodcxx/chip-info.hpp         |   2 +-
>  bindings/cxx/gpiodcxx/chip.hpp              |   2 +-
>  bindings/cxx/gpiodcxx/edge-event-buffer.hpp |   2 +-
>  bindings/cxx/gpiodcxx/edge-event.hpp        |   2 +-
>  bindings/cxx/gpiodcxx/exception.hpp         |   2 +-
>  bindings/cxx/gpiodcxx/info-event.hpp        |   2 +-
>  bindings/cxx/gpiodcxx/line-config.hpp       |   2 +-
>  bindings/cxx/gpiodcxx/line-info.hpp         |   2 +-
>  bindings/cxx/gpiodcxx/line-request.hpp      |   2 +-
>  bindings/cxx/gpiodcxx/line-settings.hpp     |   2 +-
>  bindings/cxx/gpiodcxx/line.hpp              |   2 +-
>  bindings/cxx/gpiodcxx/misc.hpp              |   2 +-
>  bindings/cxx/gpiodcxx/request-builder.hpp   |   2 +-
>  bindings/cxx/gpiodcxx/request-config.hpp    |   2 +-
>  bindings/cxx/gpiodcxx/timestamp.hpp         |   2 +-
>  bindings/cxx/info-event.cpp                 |   2 +-
>  bindings/cxx/internal.cpp                   |   2 +-
>  bindings/cxx/internal.hpp                   |   2 +-
>  bindings/cxx/line-config.cpp                |   2 +-
>  bindings/cxx/line-info.cpp                  |   2 +-
>  bindings/cxx/line-request.cpp               |   2 +-
>  bindings/cxx/line-settings.cpp              |   2 +-
>  bindings/cxx/line.cpp                       |   2 +-
>  bindings/cxx/misc.cpp                       |   2 +-
>  bindings/cxx/request-builder.cpp            |   2 +-
>  bindings/cxx/request-config.cpp             |   2 +-
>  bindings/cxx/tests/gpiosim.cpp              |   2 +-
>  bindings/cxx/tests/gpiosim.hpp              |   2 +-
>  bindings/cxx/tests/helpers.cpp              |   2 +-
>  bindings/cxx/tests/helpers.hpp              |   2 +-
>  40 files changed, 127 insertions(+), 211 deletions(-)
>  create mode 100644 CONTRIBUTING.md
>  delete mode 100644 LICENSES/LGPL-3.0-or-later.txt
>
> --
> 2.40.1
>

Re: [libgpiod][PATCH 0/2] licensing: relicense C++ bindings and add a document on contributing

[Bartosz Golaszewski]

From: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>


On Tue, 16 Apr 2024 23:21:39 +0200, Bartosz Golaszewski wrote:
> From: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
> 
> I'm Cc'ing all copyright holders for this project's C++ source code since
> the last license change which are Linaro, BayLibre and Kent Gibson. Please
> kindly leave your Acks.
> 
> Bartosz Golaszewski (2):
>   licensing: relicense C++ bindings under LGPL-2.1-or-later
>   doc: add a file explaining the contribution process in detail
> 
> [...]

Applied, thanks!

[1/2] licensing: relicense C++ bindings under LGPL-2.1-or-later
      commit: 76ecc337c519d65c16e331343c9402f176eead5a
[2/2] doc: add a file explaining the contribution process in detail
      commit: 2bcc49ed325ea19a04aba4cc0aedb742b51f779b

Best regards,
-- 
Bartosz Golaszewski <bartosz.golaszewski@linaro.org>