linux-gpio.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Bartosz Golaszewski <brgl@bgdev.pl>
To: Linus Walleij <linus.walleij@linaro.org>,
	 Kent Gibson <warthog618@gmail.com>,
	Vincent Fazio <vfazio@xes-inc.com>,
	 Erik Wierich <erik@riscstar.com>,
	Viresh Kumar <viresh.kumar@linaro.org>
Cc: linux-gpio@vger.kernel.org,
	 Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
Subject: [PATCH libgpiod 0/7] build: detach the libgpiod API version from the libgpiod package version
Date: Wed, 03 Sep 2025 15:01:58 +0200	[thread overview]
Message-ID: <20250903-api-version-detach-v1-0-027ca5928518@linaro.org> (raw)

The versioning of libgpiod has become quite messy due to the rapid
evolution of the project in its initial stages (which forced an ABI
version change without bumping the API) and later extension with several
bindings and tools kept in the same repository.

Currently the library API version and the package version are the same
but we're at a stage where the core C API will most likely remain quite
stable but we're still extending other features of the project, like
the DBus API, tools and possibly other bindings. Bumping the C API
version because we added new features to included programs makes no
sense so this series proposes to detach the core C API version from the
libgpiod package version (except for the major version updates but I
don't expect there to be one anytime soon).

The core C API will also apply to C++ and GLib bindings as they track
the C API closely. Rust and Python bindings already have their own API
versions.

Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
---
Bartosz Golaszewski (7):
      bindings: cxx: move misc.hpp inclusion to the correct place
      build: define a separate API version for the core C library
      core: change the behavior of gpiod_api_version()
      tests: update library API version string tests
      tools: display C API *and* libgpiod package version for '-v'
      dbus: manager: display C API *and* libgpiod package version for '-v'
      dbus: gpiocli: display the libgpiod package version for --version

 bindings/cxx/gpiod.hpp                 | 1 +
 bindings/cxx/gpiodcxx/line-request.hpp | 2 --
 bindings/cxx/tests/tests-misc.cpp      | 2 +-
 bindings/glib/tests/tests-misc.c       | 2 +-
 bindings/python/tests/tests_module.py  | 2 +-
 configure.ac                           | 4 ++++
 dbus/client/gpiocli.c                  | 2 +-
 dbus/manager/gpio-manager.c            | 5 +++--
 lib/misc.c                             | 2 +-
 tests/tests-misc.c                     | 2 +-
 tools/tools-common.c                   | 3 ++-
 11 files changed, 16 insertions(+), 11 deletions(-)
---
base-commit: d0006cc3d57b0e8fe090a1596934340c34e69ab4
change-id: 20250901-api-version-detach-67d8e984d529

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


             reply	other threads:[~2025-09-03 13:02 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-09-03 13:01 Bartosz Golaszewski [this message]
2025-09-03 13:01 ` [PATCH libgpiod 1/7] bindings: cxx: move misc.hpp inclusion to the correct place Bartosz Golaszewski
2025-09-03 13:02 ` [PATCH libgpiod 2/7] build: define a separate API version for the core C library Bartosz Golaszewski
2025-09-03 13:02 ` [PATCH libgpiod 3/7] core: change the behavior of gpiod_api_version() Bartosz Golaszewski
2025-09-03 13:02 ` [PATCH libgpiod 4/7] tests: update library API version string tests Bartosz Golaszewski
2025-09-03 13:02 ` [PATCH libgpiod 5/7] tools: display C API *and* libgpiod package version for '-v' Bartosz Golaszewski
2025-09-03 13:02 ` [PATCH libgpiod 6/7] dbus: manager: " Bartosz Golaszewski
2025-09-03 13:02 ` [PATCH libgpiod 7/7] dbus: gpiocli: display the libgpiod package version for --version Bartosz Golaszewski
2025-09-04  6:13 ` [PATCH libgpiod 0/7] build: detach the libgpiod API version from the libgpiod package version Erik Schilling
2025-09-09  9:25 ` Bartosz Golaszewski

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20250903-api-version-detach-v1-0-027ca5928518@linaro.org \
    --to=brgl@bgdev.pl \
    --cc=bartosz.golaszewski@linaro.org \
    --cc=erik@riscstar.com \
    --cc=linus.walleij@linaro.org \
    --cc=linux-gpio@vger.kernel.org \
    --cc=vfazio@xes-inc.com \
    --cc=viresh.kumar@linaro.org \
    --cc=warthog618@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).