Issue 6301 - Update documentation

README.md

 Adblock Plus Library for Android
 ================================
 
 An Android library project, tests and demo application for AdblockWebView widget.
 
 ## Updating the dependencies
 
 Adblock Plus for Android has dependencies that aren't in this repository.
 To update those, call:
 
@@ skipping 201 matching lines @@
 
 ## Settings
 
 An Android library that provides a configuration interface for Adblock Plus.
 You can find it in the 'libadblockplus-android-settings' directory:
 * GeneralSettingsFragment - main fragment
 * WhitelistedDomainsSettingsFragment - whitelisted domains fragment
 
 ### Usage
 
-Create `AdblockEngine` instance with factory methods and `AdblockSettingsStorage` instance.
+Create `AdblockEngineProvider` instance and `AdblockSettingsStorage` instance.
 You can use `SharedPrefsStorage` implementation to store settings in `SharedPreferences`.
 Or you can use AdblockHelper:
 
-    AdblockHelper.get().init(this, getFilesDir().getAbsolutePath(), true, AdblockHelper.PREFERENCE_NAME);
+    AdblockHelper
+      .get()
+      .init(this, getFilesDir().getAbsolutePath(), true, AdblockHelper.PREFERENCE_NAME);
 
-    // optional - provide preloaded subscription files in app resoruces
-    AdblockHelper.get().preloadSubscriptions(AdblockHelper.PRELOAD_PREFERENCE_NAME, map);
+      // optional - provide preloaded subscription files in app resoruces
+      .preloadSubscriptions(AdblockHelper.PRELOAD_PREFERENCE_NAME, map);
 
 Implement the following interfaces in your settings activity:
 
 * `BaseSettingsFragment.Provider`
 * `GeneralSettingsFragment.Listener`
 * `WhitelistedDomainsSettingsFragment.Listener`
 
 and return created instance or AdblockHelper instances:
 
-    AdblockHelper.get().getEngine();  // engine
+    AdblockHelper.get().getProvider().getEngine();  // engine
     AdblockHelper.get().getStorage(); // storage
 
 Retain Adblock instance in activity `onCreate` in synchronous mode (it may take few seconds):
 
-    AdblockHelper.get().retain(false);
+    AdblockHelper.get().getProvider().retain(false);
 
 or in asynchronous mode (without current thread lock):
 
-    AdblockHelper.get().retain(true);
+    AdblockHelper.get().getProvider().retain(true);
 
 Invoke `waitforReady` every time you need AdblockEngine instance if retained in asynchronous mode:
 
-    AdblockHelper.get().waitForReady();
+    AdblockHelper.get().getProvider().waitForReady();
 
 Release Adblock instance in activity `onDestroy`:
 
-    AdblockHelper.get().release();
+    AdblockHelper.get().getProvider().release();
 
 Insert `GeneralSettingsFragment` fragment instance in runtime to start showing settings UI.
 
 ### Building
 
 #### Building with Ant
 
 In the 'libadblockplus-android-settings' directory create the file _local.properties_ and set
 _sdk.dir_ to where you installed it, e.g.:
 
@@ skipping 33 matching lines @@
 In java source code:
 
     AdblockWebView webView = (AdblockWebView) findViewById(R.id.main_webview);
 
 Use `setAdblockEnabled(boolean adblockEnabled)` to enable/disable adblocking.
 
 Use `setDebugMode(boolean debugMode)` to turn debug log output (Android log and JS console) on/off.
 
 Use `setAllowDrawDelay(int allowDrawDelay)` to set custom delay to start render webpage after 'DOMContentLoaded' event is fired.
 
-Use `setAdblockEngine(AdblockEngine adblockEngine)` to use external adblock engine.
-If adblock engine is not set, it's created by AdblockWebView instance automatically.
+Use `setProvider(AdblockEngineProvider provider)` to use external adblock engine provider.
+The simplest solution is to use `AdblockHelper` from `-settings` as external adblock engine provider:
+
+    webView.setProvider(AdblockHelper.get().getProvider());
+
+If adblock engine provider is not set, it's created by AdblockWebView instance automatically.
 
 Use `dispose(Runnable disposeFinished)` to release resources (**required**).
 Note it can be invoked from background thread.
 
 ### Building
 
 #### Building with Ant
 
 In the 'libadblockplus-android-webview' directory create the file _local.properties_ and set
 _sdk.dir_ to where you installed it, e.g.:
@@ skipping 35 matching lines @@
 
 This will generate *.apk in the 'libadblockplus-android-webviewapp/bin/' directory.
 
 #### Building with Gradle
 
 In the project root directory run:
 
     ./gradlew assemble
 
 This will generate *.apk in the 'libadblockplus-android-webviewapp/build/outputs/apk/' directory.