[PATCH] org-protocol.org: updated Linux setup (Gnome) section

[Wilko Meyer <w@wmeyer.eu>]

[-- Attachment #1: Type: text/plain, Size: 347 bytes --]

Good evening,

I'd like to suggest an update to the org-protocol.org "Linux setup (Gnome)"
section as it is refering to gconf/gconftool-2 which is deprecated as of
Gnome 3. It may be a good idea to use .desktop-Files (as described in
freedesktop.orgs Desktop Entry/Menu Specification) here to complete this
step (which is what my patch suggests).

[-- Attachment #2: 0001-org-protocol.org-updated-Linux-setup-Gnome-section-a.patch --]
[-- Type: text/plain, Size: 1414 bytes --]

From 8c62f173c34929dd03e324ff3ec4d457850e52c4 Mon Sep 17 00:00:00 2001
From: Wilko Meyer <w@wmeyer.eu>
Date: Thu, 10 Mar 2022 19:59:45 +0100
Subject: [PATCH] org-protocol.org: updated Linux setup (Gnome) section as
 gconf is deprecated by now

---
 org-contrib/org-protocol.org | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/org-contrib/org-protocol.org b/org-contrib/org-protocol.org
index 57cab17f..b10ef41e 100644
--- a/org-contrib/org-protocol.org
+++ b/org-contrib/org-protocol.org
@@ -89,10 +89,21 @@ actions. Just register your custom sub-protocol and handler with the variable
 
 *** Linux setup (Gnome)
 
-    For this to work, you'll need the Gnome-Libraries to be installed.
+    Add a file =org-protocol.desktop= to =~/.local/share/applications/=:
+
+    #+begin_example    
+    [Desktop Entry]
+    Name=org-protocol
+    Exec=emacsclient '%u'
+    Type=Application
+    Terminal=false
+    Categories=System;
+    MimeType=x-scheme-handler/org-protocol;
+    #+end_example
+
+    Update the cache database of MIME types handled by desktop files via:
 
-    : gconftool-2 -s /desktop/gnome/url-handlers/org-protocol/command '/usr/local/bin/emacsclient %s' --type String
-    : gconftool-2 -s /desktop/gnome/url-handlers/org-protocol/enabled --type Boolean true
+    : update-desktop-database ~/.local/share/applications/
 
 *** Linux setup (KDE)
 
-- 
2.35.1