From fa04927d0c6cd804e4db70b0d393b3086065f7d0 Mon Sep 17 00:00:00 2001
From: Simon McVittie <smcv@debian.org>
Date: Mon, 22 Jan 2018 17:53:02 +0000
Subject: [PATCH] dbus-gmain: Add a README

Signed-off-by: Simon McVittie <smcv@debian.org>
---
 dbus-gmain/README | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 dbus-gmain/README

diff --git a/dbus-gmain/README b/dbus-gmain/README
new file mode 100644
index 00000000..17919fe1
--- /dev/null
+++ b/dbus-gmain/README
@@ -0,0 +1,15 @@
+dbus-gmain - GLib main loop integration for libdbus
+===================================================
+
+This directory contains GLib main loop integration for libdbus, salvaged
+from dbus-glib. At the moment it is designed to be bundled in other
+projects using the `git subtree` or `git submodule` commands.
+
+Please do not use this module unless you really need it. The majority
+of GLib-based D-Bus users would be better off using GDBus, part of GLib,
+instead of the low-level APIs provided by libdbus. In particular, the
+combination of dbus-gmain and libdbus is known to have thread-safety
+issues.
+
+However, using this module is still better than using dbus-glib; the
+rest of dbus-glib mostly consists of design flaws.
-- 
GitLab