From ccc9cce4c122e8d287ef460b8b4857d73c008002 Mon Sep 17 00:00:00 2001
From: Emanoil Kotsev <deloptes@gmail.com>
Date: Fri, 14 May 2021 10:25:26 +0200
Subject: Replace gdbus and GTK with dbus-1-tqt and TDE native notifications

Signed-off-by: Emanoil Kotsev <deloptes@gmail.com>
---
 README | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 README

(limited to 'README')

diff --git a/README b/README
new file mode 100644
index 0000000..990a47a
--- /dev/null
+++ b/README
@@ -0,0 +1,70 @@
+
+ kdbusnotification - a DBUS notification service for TDE.
+
+
+Kdbusnotification is a small program for the Trinity Desktop that
+displays DBUS notifications via passive popups.
+
+
+
+
+ CONTRIBUTING
+==============
+
+If you wish to contribute to Kdbusnotification (TDE), you might do so:
+
+- TDE Gitea Workspace (TGW) collaboration tool.
+  https://mirror.git.trinitydesktop.org/gitea
+
+- TDE Weblate Translation Workspace (TWTW) collaboration tool.
+  https://mirror.git.trinitydesktop.org/weblate
+
+ DOCUMENTATION
+===============
+
+https://specifications.freedesktop.org/notification-spec/latest/ar01s09.html
+https://sylvaindurand.org/update-notifications-with-libnotify/
+
+gdbus call \
+    --session \
+    --dest org.freedesktop.Notifications \
+    --object-path /org/freedesktop/Notifications \
+    --method org.freedesktop.Notifications.Notify \
+    "identifier" \
+    "1" \
+    "" \
+    "Notification title" \
+    "Notification description" \
+    "[]" \
+    "{}" \
+    "2000"
+    
+The second identifier (here 1) concerns the id of the notification we wish to replace, 
+we will come back to this shortly. 
+The next identifier allows you to define an icon. 
+"[]" allows you to define actions, "{}" to define hints, 
+and finally the last argument 2000 presents the time during which the notification 
+must remain visible (in milliseconds).
+
+Once this command is executed, the system returns a response that looks like :
+
+(uint32 13,)
+
+This number, here 13, is the id of the notification that we will be able to replace.
+
+This means that the following command will not create a new notification, but will 
+replace the one we just created:
+
+gdbus call \
+    --session \
+    --dest org.freedesktop.Notifications \
+    --object-path /org/freedesktop/Notifications \
+    --method org.freedesktop.Notifications.Notify \
+    "identifier" \
+    "13" \
+    "" \
+    "My updated title" \
+    "My updated description" \
+    "[]" \
+    "{}" \
+    "2000"
-- 
cgit v1.2.1