Skip to contentSkip to conversation

licensing: relicense C++ bindings and add a document on contributing

PATCH Applied Bartosz Golaszewski 4 participants 7 messages Apr 16, 2024 – Apr 22, 2024

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

cover licensing: relicense C++ bindings and add a document on contributing

From: Bartosz Golaszewski <[email protected]>

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
Signature · 1 line
2.40.1
#1 lore raw

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

From: Bartosz Golaszewski <[email protected]>

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.

---
 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
COPYING +1 -10
index 87a9de5..84b4fc6 100644
@@ -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
LICENSES/LGPL-3.0-or-later.txt deleted +0 -165

165 lines not on this page · raw message

bindings/cxx/chip-info.cpp +1 -1
index c4f0ab5..93dd6f5 100644
@@ -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 <[email protected]>
 
 #include <ostream>
bindings/cxx/chip.cpp +1 -1
index d6a3a43..8086839 100644
@@ -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 <[email protected]>
 
 #include <ostream>
bindings/cxx/edge-event-buffer.cpp +1 -1
index c7347a2..0d5cb36 100644
@@ -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 <[email protected]>
 
 #include <iterator>
bindings/cxx/edge-event.cpp +1 -1
index 5ff3af2..9ef311c 100644
@@ -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 <[email protected]>
 
 #include <map>
bindings/cxx/exception.cpp +1 -1
index 6957e78..378b249 100644
@@ -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 <[email protected]>
 
 #include "internal.hpp"
bindings/cxx/gpiod.hpp +1 -1
index b090af4..91e41a5 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/chip-info.hpp +1 -1
index b6bd0f8..e740e94 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/chip.hpp +1 -1
index 297db3d..4d67476 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/edge-event-buffer.hpp +1 -1
index 025517f..2482e8a 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/edge-event.hpp +1 -1
index 4fde561..47c256a 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/exception.hpp +1 -1
index e89b384..34737d2 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/info-event.hpp +1 -1
index e99cbc4..69b88b6 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/line-config.hpp +1 -1
index 8a3335c..58c9d87 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/line-info.hpp +1 -1
index 26d25a9..8b10dc4 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/line-request.hpp +1 -1
index dfe3e0f..fcc4e0e 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/line-settings.hpp +1 -1
index bacf359..1004ccd 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/line.hpp +1 -1
index 5d0752a..2810571 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/misc.hpp +1 -1
index 1e41e9b..eab8eba 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/request-builder.hpp +1 -1
index 90cc8f0..192bd91 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/request-config.hpp +1 -1
index b099eb1..6ebbf99 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/gpiodcxx/timestamp.hpp +1 -1
index 7143ab3..fcb4d8d 100644
@@ -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 <[email protected]> */
 
 /**
bindings/cxx/info-event.cpp +1 -1
index 0b19ee9..1f6d0d7 100644
@@ -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 <[email protected]>
 
 #include <map>
bindings/cxx/internal.cpp +1 -1
index 9f1f38f..237d5d5 100644
@@ -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 <[email protected]>
 
 #include <map>
bindings/cxx/internal.hpp +1 -1
index db78af6..b64daf1 100644
@@ -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 <[email protected]> */
 
 #ifndef __LIBGPIOD_CXX_INTERNAL_HPP__
bindings/cxx/line-config.cpp +1 -1
index 1179e0a..7e3dc8c 100644
@@ -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 <[email protected]>
 
 #include <cstdlib>
bindings/cxx/line-info.cpp +1 -1
index 9931ed0..2117f68 100644
@@ -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 <[email protected]>
 
 #include <map>
bindings/cxx/line-request.cpp +1 -1
index e8e0b96..f6b0a66 100644
@@ -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 <[email protected]>
 
 #include <iterator>
bindings/cxx/line-settings.cpp +1 -1
index 30d7899..300858a 100644
@@ -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 <[email protected]>
 
 #include <map>
bindings/cxx/line.cpp +1 -1
index d99e8fa..d6a92c1 100644
@@ -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 <[email protected]>
 
 #include <iterator>
bindings/cxx/misc.cpp +1 -1
index dde48e0..eba0b46 100644
@@ -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 <[email protected]>
 
 #include "internal.hpp"
bindings/cxx/request-builder.cpp +1 -1
index d11e47b..87ee2fe 100644
@@ -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 <[email protected]>
 
 #include <ostream>
bindings/cxx/request-config.cpp +1 -1
index e578b15..b44b8b6 100644
@@ -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 <[email protected]>
 
 #include <ostream>
bindings/cxx/tests/gpiosim.cpp +1 -1
index 7267e6d..4bda5a2 100644
@@ -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 <[email protected]> */
 
 #include <map>
bindings/cxx/tests/gpiosim.hpp +1 -1
index 320ae96..8151af6 100644
@@ -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 <[email protected]> */
 
 #ifndef __GPIOD_CXX_GPIOSIM_HPP__
bindings/cxx/tests/helpers.cpp +1 -1
index 6534fdb..eb2c3db 100644
@@ -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 <[email protected]>
 
 #include "helpers.hpp"
bindings/cxx/tests/helpers.hpp +1 -1
index 157d221..62d9827 100644
@@ -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 <[email protected]> */
 
 #ifndef __GPIOD_CXX_TEST_HELPERS_HPP__
Signature · 1 line
2.40.1
Acked-by on v1 1/2
#2 lore raw

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

Quoted 13 lines · Bartosz Golaszewski

From: Bartosz Golaszewski <[email protected]>

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.

Quoted 8 lines

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

Acked-by on v1 1/2
#3 lore raw

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

In reply to Bartosz Golaszewski
Quoted 13 lines · Bartosz Golaszewski

From: Bartosz Golaszewski <[email protected]>

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.

Quoted 8 lines

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

#4 lore raw

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

In reply to Bartosz Golaszewski

From: Bartosz Golaszewski <[email protected]>

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

---
 CONTRIBUTING.md | 88 +++++++++++++++++++++++++++++++++++++++++++++++++
 README          |  2 ++
 2 files changed, 90 insertions(+)
 create mode 100644 CONTRIBUTING.md
CONTRIBUTING.md new file +88 -0
new file mode 100644
index 0000000..79b3d80
@@ -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 [email protected] (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 <[email protected]>
+```
+
+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 <[email protected]>
+
+[DCO]: https://developercertificate.org/
README +2 -0
index ec60ea1..7a92a49 100644
@@ -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
Signature · 1 line
2.40.1
Acked-by on the v1 series
#5 lore raw
In reply to Bartosz Golaszewski
Quoted 10 lines · Bartosz Golaszewski

From: Bartosz Golaszewski <[email protected]>

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:

Quoted 48 lines
 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

author Applied
#6 lore raw
In reply to Bartosz Golaszewski

From: Bartosz Golaszewski <[email protected]>

Quoted 11 lines · Bartosz Golaszewski

From: Bartosz Golaszewski <[email protected]>

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,

Signature · 1 line
Bartosz Golaszewski <[email protected]>