- browser plugins v2 unleashed

[packages/browser-plugins.git] / browser-plugins.README

diff --git a/browser-plugins.README b/browser-plugins.README
index b171b3a1890dad732637b0986b8341691e51565c..d1ed40086f58797f817fed24df327143f3b72b12 100644 (file)
--- a/browser-plugins.README
+++ b/browser-plugins.README
@@ -1,13 +1,19 @@
-New browser-plugins
+browser-plugins 2.0 for PLD Linux
+
+Author:        Elan Ruusamäe <glen@pld-linux.org>
+Author:        Patryk Zawadzki <patrys@pld-linux.org>
 
 Technical implementation
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-browser-plugins(%{_target_base_arch}) provides:
-- %dir /etc/browser-plugins
+filesystem provides:
 - %dir %{_plugindir}
 %{_plugindir} expands to %{_libdir}/browser-plugins
 
+browser-plugins provides:
+- %dir /etc/browser-plugins
+- %dir /etc/browser-plugins/browser.d
+- %dir /etc/browser-plugins/blacklist.d
 - %{_sbindir}/update-browser-plugins script
 The script will parse /etc/browser-plugins/*.blacklist and delete dead and add
 new symlinks to browser specific plugin directories.
@@ -15,8 +21,16 @@ new symlinks to browser specific plugin directories.
 The list of browser plugin directories is taken by reading existing symlinks
 matching glob: /etc/browser-plugins/browser.d/<browser>.%{_target_base_arch}
 
-plugin provides
-- %config(noreplace) /etc/browser-plugins/<plugin>-<browser>-%{_target_base_arch}.blacklist
+The update script will scan /usr/lib/browser-plugins and
+/usr/lib64/browser-plugins dir for existing plugins as browser-plugins itself
+is noarch package.
+
+browser-plugins requires:
+- filesystem >= EVR
+the EVR is package version including %{_libdir}/browser-plugins directory.
+
+plugin provides:
+- %config(noreplace) /etc/browser-plugins/blacklist.d/<plugin>-<browser>.%{_target_base_arch}.blacklist
 The blacklist contains shell globs of filenames to be excluded from linking to
 browser specific plugin directory. The shell globs are base of %{_plugindir},
 subdirectories are allowed. Comments and empty lines are ignored.
@@ -24,9 +38,26 @@ subdirectories are allowed. Comments and empty lines are ignored.
 - %post/%postun scriptlet
 the scriptlet will call %update_browser_plugins
 
-browser provides
+plugin requires:
+- BuildRequires: rpmbuild(macros) >= VERSION
+- Requires: browser-plugins >= 2.0
+
+browser provides:
 - /etc/browser-plugins/browser.d/<browser>.%{_target_base_arch} symlink
 the symlink will point to the single directory where it searches for its plugins.
 
 - %post/%postun scriptlet
 the scriptlet will call %update_browser_plugins
+
+browser requires:
+- BuildRequires: rpmbuild(macros) >= VERSION
+- Requires: browser-plugins >= 2.0
+
+rpm-build-macros provides:
+- %update_browser_plugins macro
+the macro will just call /usr/sbin/update-browser-plugins and ignore any errors from it.
+- %{_browser_plugindir} macro
+the macro will be defined as /usr/%{_lib}/browser-plugins
+
+adapter provides:
+- replacement for sole location of browser-plugins with %{_browser_plugindir} macro