summaryrefslogtreecommitdiffstats
path: root/browser/components/shell/search-provider-files/README
diff options
context:
space:
mode:
Diffstat (limited to 'browser/components/shell/search-provider-files/README')
-rw-r--r--browser/components/shell/search-provider-files/README24
1 files changed, 24 insertions, 0 deletions
diff --git a/browser/components/shell/search-provider-files/README b/browser/components/shell/search-provider-files/README
new file mode 100644
index 0000000000..459e012f2a
--- /dev/null
+++ b/browser/components/shell/search-provider-files/README
@@ -0,0 +1,24 @@
+In order to get gnome shell search provider registered and active
+you need to install the org.mozilla.firefox.search-provider.ini,
+org.mozilla.firefox.SearchProvider.service and firefox.desktop files system wide.
+
+The locations may be distro specific, for instance Fedora and Ubuntu expect
+the files at:
+
+/usr/share/gnome-shell/search-providers/org.mozilla.firefox.search-provider.ini
+/usr/share/dbus-1/services/org.mozilla.firefox.SearchProvider.service
+/usr/share/applications/firefox.desktop
+
+firefox.desktop is a system-wide Firefox launcher. It may come with your
+distribution or you can use this one. Update name of firefox desktop file at org.mozilla.firefox.search-provider.ini
+according your actual file at /usr/share/applications.
+
+org.mozilla.firefox.search-provider.ini registers Firefox as a search provider.
+When the file is correctly installed you can see Firefox as a searchable application
+at Settings -> Search at Gnome controll center.
+
+org.mozilla.firefox.SearchProvider.service file makes DBus search provider service
+activatable. Without it thw service is broken, see mzbz#1851393.
+
+Gnome shell search provider is active only when Firefox is running. When it's active
+you can see it as org.mozilla.firefox.SearchProvider D-Bus service.