summary refs log tree commit diff
path: root/src/libnm-core-intern/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'src/libnm-core-intern/README.md')
-rw-r--r--src/libnm-core-intern/README.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/src/libnm-core-intern/README.md b/src/libnm-core-intern/README.md
new file mode 100644
index 00000000..f17cf4da
--- /dev/null
+++ b/src/libnm-core-intern/README.md
@@ -0,0 +1,19 @@
+libnm-core-intern
+=================
+
+This contains header files only, which are also part of
+the internal API of [`libnm-core-impl`](../libnm-core-impl).
+
+[`libnm-core-impl`](../libnm-core-impl) is a static library that (among others) implements
+[`libnm-core-public`](../libnm-core-public) (which is a part of the public API of [`libnm`](../../libnm)).
+This library gets statically linked into [`libnm`](../../libnm) and `NetworkManager`.
+Hence, those components can also access internal (but not private) API of
+[`libnm-core-impl`](../libnm-core-impl), and this API is in [`libnm-core-intern`](../libnm-core-intern).
+
+These headers can thus be included by anybody who statically links with
+[`libnm-core-impl`](../libnm-core-impl) (including [`libnm-core-impl`](../libnm-core-impl) itself).
+
+The directory should not be added to the include search path, instead
+users should explicitly `#include "libnm-core-intern/nm-core-internal.h"`)
+
+There is no source code here and no static library to link against.