mirror of https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git synced 2026-03-07 02:50:38 +01:00

History

Thomas Haller 615221a99c format: reformat source tree with clang-format 13.0 We use clang-format for automatic formatting of our source files. Since clang-format is actively maintained software, the actual formatting depends on the used version of clang-format. That is unfortunate and painful, but really unavoidable unless clang-format would be strictly bug-compatible. So the version that we must use is from the current Fedora release, which is also tested by our gitlab-ci. Previously, we were using Fedora 34 with clang-tools-extra-12.0.1-1.fc34.x86_64. As Fedora 35 comes along, we need to update our formatting as Fedora 35 comes with version "13.0.0~rc1-1.fc35". An alternative would be to freeze on version 12, but that has different problems (like, it's cumbersome to rebuild clang 12 on Fedora 35 and it would be cumbersome for our developers which are on Fedora 35 to use a clang that they cannot easily install). The (differently painful) solution is to reformat from time to time, as we switch to a new Fedora (and thus clang) version. Usually we would expect that such a reformatting brings minor changes. But this time, the changes are huge. That is mentioned in the release notes [1] as Makes PointerAligment: Right working with AlignConsecutiveDeclarations. (Fixes https://llvm.org/PR27353) [1] https://releases.llvm.org/13.0.0/tools/clang/docs/ReleaseNotes.html#clang-format		2021-11-29 09:31:09 +00:00
..
meson.build	build/meson: cleanup dependencies for libnm-core-aux-intern	2021-02-28 10:42:05 +01:00
nm-auth-subject.c	format: reformat source tree with clang-format 13.0	2021-11-29 09:31:09 +00:00
nm-auth-subject.h	build: move "libnm-core/" to "src/" and split it	2021-02-18 19:46:51 +01:00
nm-common-macros.h	build: move "libnm-core/" to "src/" and split it	2021-02-18 19:46:51 +01:00
nm-libnm-core-utils.c	format: reformat source tree with clang-format 13.0	2021-11-29 09:31:09 +00:00
nm-libnm-core-utils.h	format: reformat source tree with clang-format 13.0	2021-11-29 09:31:09 +00:00
README.md	build: move "libnm-core/" to "src/" and split it	2021-02-18 19:46:51 +01:00

README.md

libnm-core-aux-intern

libnm-core-aux-intern is a static library that:

uses parts of libnm-core-impl, that are public API of libnm (i.e. libnm-core-public).
that is statically linked into libnm-core-impl (and thus libnm and NetworkManager core.
that can also be statically linked into other users of libnm.

Basically, it is a static library with utility functions that extends libnm-core-impl (the part that is public API of libnm), but it is also used by libnm-core-impl itself.

That means:

you can use it everywhere where you either statically link with libnm-core-impl, or dynamically link with libnm.
you can even use it inside of libnm-core-impl itself. This is the difference between libnm-core-aux-intern and libnm-core-aux-extern.

Note that libnm-core-aux-intern only uses public API of libnm.

This directory should not be added to the include search path. Instead, users should fully qualify the include like #include "libnm-core-aux-intern/nm-auth-subject.h".