- nspluginwrapper -v -a -i is needed to be called when flash pkg is updated

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

diff --git a/browser-plugins.README b/browser-plugins.README
index 5dc88c498b0298e15ea9bb5ca5f8b2d007bb4b04..d1ed40086f58797f817fed24df327143f3b72b12 100644 (file)
--- a/browser-plugins.README
+++ b/browser-plugins.README
@@ -1,27 +1,63 @@
-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:
+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.
 
-update-browser-plugins script knows about browsers. it has hardcoded list of
-browser 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}
+
+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.
 
-plugin provides
-- %config(noreplace) /etc/browser-plugins/<plugin>-<browser>-%{_target_base_arch}.blacklist
+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.
+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