You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/07/29 20:37:10 UTC

[1/3] docs commit: [CB-4379 CB-3818] specify CLI interface to API features

Updated Branches:
  refs/heads/master 357c3a35b -> c9c4c0643


[CB-4379 CB-3818] specify CLI interface to API features


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/857cf3df
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/857cf3df
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/857cf3df

Branch: refs/heads/master
Commit: 857cf3df12f5206464c50253d5419f66f3861986
Parents: 357c3a3
Author: Mike Sierra <le...@gmail.com>
Authored: Fri Jul 26 13:39:19 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Mon Jul 29 11:31:43 2013 -0700

----------------------------------------------------------------------
 .../edge/cordova/accelerometer/accelerometer.md | 38 +++++++++--------
 docs/en/edge/cordova/camera/camera.md           | 42 ++++++++++---------
 docs/en/edge/cordova/compass/compass.md         | 34 +++++++++-------
 docs/en/edge/cordova/connection/connection.md   | 39 ++++++++++--------
 docs/en/edge/cordova/contacts/contacts.md       | 37 +++++++++--------
 docs/en/edge/cordova/device/device.md           | 41 ++++++++++---------
 docs/en/edge/cordova/events/events.md           | 33 ++++++---------
 docs/en/edge/cordova/file/file.md               | 36 ++++++++--------
 docs/en/edge/cordova/geolocation/geolocation.md | 41 ++++++++++---------
 .../edge/cordova/globalization/globalization.md | 16 ++++++--
 .../edge/cordova/inappbrowser/inappbrowser.md   | 26 +++++++-----
 docs/en/edge/cordova/media/capture/capture.md   | 37 +++++++++--------
 docs/en/edge/cordova/media/media.md             | 37 +++++++++--------
 .../edge/cordova/notification/notification.md   | 43 ++++++++++++--------
 .../edge/cordova/splashscreen/splashscreen.md   | 21 ++++++----
 docs/en/edge/cordova/storage/storage.md         | 25 +++++-------
 16 files changed, 299 insertions(+), 247 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/accelerometer/accelerometer.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/accelerometer/accelerometer.md b/docs/en/edge/cordova/accelerometer/accelerometer.md
index 31d6012..f23abc2 100644
--- a/docs/en/edge/cordova/accelerometer/accelerometer.md
+++ b/docs/en/edge/cordova/accelerometer/accelerometer.md
@@ -41,42 +41,46 @@ Objects (Read-Only)
 
 - Acceleration
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion.git
+        $ cordova plugin rm org.apache.cordova.core.device-motion
 
-    <plugin name="Accelerometer" value="org.apache.cordova.AccelListener" />
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
 
-### BlackBerry WebWorks
+* Android
 
-#### www/plugins.xml
+    # app/res/xml/config.xml
+    <plugin name="Accelerometer" value="org.apache.cordova.AccelListener" />
 
-    <plugin name="Accelerometer" value="org.apache.cordova.accelerometer.Accelerometer" />
+* BlackBerry WebWorks
 
-#### www/config.xml
+    # www/plugins.xml
+    <plugin name="Accelerometer" value="org.apache.cordova.accelerometer.Accelerometer" />
 
+    # www/config.xml
     <feature id="blackberry.system"  required="true" version="1.0.0.0" />
     <feature id="org.apache.cordova" required="true" version="1.0.0" />
 
-### iOS
-
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="Accelerometer" value="CDVAccelerometer" />
 
-### Windows Phone
-
-#### Properties/WPAppManifest.xml
+* Windows Phone
 
+    # Properties/WPAppManifest.xml
     <Capabilities>
         <Capability Name="ID_CAP_SENSORS" />
     </Capabilities>
 
 Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
 
-### Tizen
+* Tizen
 
-    No permissions are required.
+  No special permissions are required.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/camera/camera.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/camera/camera.md b/docs/en/edge/cordova/camera/camera.md
index 9b100e4..9eea801 100644
--- a/docs/en/edge/cordova/camera/camera.md
+++ b/docs/en/edge/cordova/camera/camera.md
@@ -30,43 +30,46 @@ Methods
 - camera.getPicture
 - camera.cleanup
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-camera.git
+        $ cordova plugin rm org.apache.cordova.core.camera
 
-    <plugin name="Camera" value="org.apache.cordova.CameraLauncher" />
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
 
-#### app/AndroidManifest
+* Android
 
-    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+    # app/res/xml/config.xml
+    <plugin name="Camera" value="org.apache.cordova.CameraLauncher" />
 
-### BlackBerry WebWorks
+    # app/AndroidManifest
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
-#### www/plugins.xml
+* BlackBerry WebWorks
 
+    # www/plugins.xml
     <plugin name="Camera" value="org.apache.cordova.camera.Camera" />
 
-#### www/config.xml
-
+    # www/config.xml
     <feature id="blackberry.media.camera" />
 
     <rim:permissions>
         <rim:permit>use_camera</rim:permit>
     </rim:permissions>
 
-### iOS
-
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="Camera" value="CDVCamera" />
 
-### Windows Phone
-
-#### Properties/WPAppManifest.xml
+* Windows Phone
 
+    # Properties/WPAppManifest.xml
     <Capabilities>
         <Capability Name="ID_CAP_ISV_CAMERA" />
         <Capability Name="ID_HW_FRONTCAMERA" />
@@ -74,10 +77,9 @@ Permissions
 
 Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
 
-### Tizen
-
-#### config.xml
+* Tizen
 
+    # config.xml
     <feature name="http://tizen.org/api/application" required="true"/>
     <feature name="http://tizen.org/api/application.launch" required="true"/>
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/compass/compass.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/compass/compass.md b/docs/en/edge/cordova/compass/compass.md
index 43ca2bc..31ef597 100755
--- a/docs/en/edge/cordova/compass/compass.md
+++ b/docs/en/edge/cordova/compass/compass.md
@@ -39,35 +39,41 @@ Arguments
 - compassOptions
 - compassHeading
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-orientation.git
+        $ cordova plugin rm org.apache.cordova.core.device-orientation
 
-    <plugin name="Compass" value="org.apache.cordova.CompassListener" />
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
+
+* Android
 
-### BlackBerry WebWorks
+    # app/res/xml/config.xml
+    <plugin name="Compass" value="org.apache.cordova.CompassListener" />
 
-    No permissions are required.
+* BlackBerry WebWorks
 
-### iOS
+  No special permissions are required.
 
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="Compass" value="CDVLocation" />
 
-### Windows Phone
-
-#### Properties/WPAppManifest.xml
+* Windows Phone
 
+    # Properties/WPAppManifest.xml
     <Capabilities>
         <Capability Name="ID_CAP_SENSORS" />
     </Capabilities>
 
 Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
 
-### Tizen
+* Tizen
 
-    No permissions are required.
+  No special permissions are required.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/connection/connection.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/connection/connection.md b/docs/en/edge/cordova/connection/connection.md
index 8831dcf..0e5ed1d 100644
--- a/docs/en/edge/cordova/connection/connection.md
+++ b/docs/en/edge/cordova/connection/connection.md
@@ -39,47 +39,50 @@ Constants
 - Connection.CELL
 - Connection.NONE
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git
+        $ cordova plugin rm org.apache.cordova.core.network-information
 
-    <plugin name="NetworkStatus" value="org.apache.cordova.NetworkManager" />
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
+
+* Android
 
-#### app/AndroidManifest.xml
+    # app/res/xml/config.xml
+    <plugin name="NetworkStatus" value="org.apache.cordova.NetworkManager" />
 
+    # app/AndroidManifest.xml
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     <uses-permission android:name="android.permission.READ_PHONE_STATE" />
 
-### BlackBerry WebWorks
-
-#### www/plugins.xml
+* BlackBerry WebWorks
 
+    # www/plugins.xml
     <plugin name="Network Status" value="org.apache.cordova.network.Network" />
 
-### iOS
-
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="NetworkStatus" value="CDVConnection" />
 
-### Windows Phone
-
-#### Properties/WPAppManifest.xml
+* Windows Phone
 
+    # Properties/WPAppManifest.xml
     <Capabilities>
         <Capability Name="ID_CAP_NETWORKING" />
     </Capabilities>
 
 Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
 
-### Tizen
-
-#### config.xml
+* Tizen
 
+    # config.xml
     <feature name="http://tizen.org/api/systeminfo" required="true"/>
 
 Reference: [Application Manifest for Tizen Web Application](https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures)

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/contacts/contacts.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/contacts.md b/docs/en/edge/cordova/contacts/contacts.md
index ec50fd7..ad8c7f8 100644
--- a/docs/en/edge/cordova/contacts/contacts.md
+++ b/docs/en/edge/cordova/contacts/contacts.md
@@ -49,44 +49,47 @@ Objects
 - ContactFindOptions
 - ContactError
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git
+        $ cordova plugin rm org.apache.cordova.core.contacts
 
-    <plugin name="Contacts" value="org.apache.cordova.ContactManager" />
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
+
+* Android
 
-#### app/AndroidManifest.xml
+    # app/res/xml/config.xml
+    <plugin name="Contacts" value="org.apache.cordova.ContactManager" />
 
+    # app/AndroidManifest.xml
     <uses-permission android:name="android.permission.GET_ACCOUNTS" />
     <uses-permission android:name="android.permission.READ_CONTACTS" />
     <uses-permission android:name="android.permission.WRITE_CONTACTS" />
 
-### BlackBerry WebWorks
-
-#### www/plugins.xml
+* BlackBerry WebWorks
 
+    # www/plugins.xml
     <plugin name="Contact" value="org.apache.cordova.pim.Contact" />
 
-#### www/config.xml
-
+    # www/config.xml
     <feature id="blackberry.find"        required="true" version="1.0.0.0" />
     <feature id="blackberry.identity"    required="true" version="1.0.0.0" />
     <feature id="blackberry.pim.Address" required="true" version="1.0.0.0" />
     <feature id="blackberry.pim.Contact" required="true" version="1.0.0.0" />
 
-### iOS
-
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="Contacts" value="CDVContacts" />
 
-### Windows Phone
-
-#### Properties/WPAppManifest.xml
+* Windows Phone
 
+    # Properties/WPAppManifest.xml
     <Capabilities>
         <Capability Name="ID_CAP_CONTACTS" />
     </Capabilities>

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/device/device.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/device/device.md b/docs/en/edge/cordova/device/device.md
index 38abb0c..ffbfaef 100644
--- a/docs/en/edge/cordova/device/device.md
+++ b/docs/en/edge/cordova/device/device.md
@@ -41,40 +41,44 @@ Since `device` is assigned to the `window` object, it is implicitly in the globa
     var phoneName = window.device.name;
     var phoneName = device.name;
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
+        $ cordova plugin rm org.apache.cordova.core.device
 
-    <plugin name="Device" value="org.apache.cordova.Device" />
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
 
-#### app/AndroidManifest.xml
+* Android
 
-    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
+    # app/res/xml/config.xml
+    <plugin name="Device" value="org.apache.cordova.Device" />
 
-### BlackBerry WebWorks
+    # app/AndroidManifest.xml
+    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
 
-#### www/plugins.xml
+* BlackBerry WebWorks
 
+    # www/plugins.xml
     <plugin name="Device" value="org.apache.cordova.device.Device" />
 
-#### www/config.xml
-
+    # www/config.xml
     <feature id="blackberry.app" required="true" version="1.0.0.0" />
     <rim:permissions>
         <rim:permit>read_device_identifying_information</rim:permit>
     </rim:permissions>
 
-### iOS
-
-    No permissions are required.
+* iOS
 
-### Windows Phone
+  No special permissions are required.
 
-#### Properties/WPAppManifest.xml
+* Windows Phone
 
+    # Properties/WPAppManifest.xml
     <Capabilities>
         <Capability Name="ID_CAP_WEBBROWSERCOMPONENT" />
         <Capability Name="ID_CAP_IDENTITY_DEVICE" />
@@ -83,10 +87,9 @@ Permissions
 
 Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
 
-### Tizen
-
-#### config.xml
+* Tizen
 
+    # config.xml
     <feature name="http://tizen.org/api/systeminfo" required="true"/>
 
 Reference: [Application Manifest for Tizen Web Application](https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures)

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/events/events.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/events/events.md b/docs/en/edge/cordova/events/events.md
index bdecd16..8e471f3 100644
--- a/docs/en/edge/cordova/events/events.md
+++ b/docs/en/edge/cordova/events/events.md
@@ -41,45 +41,38 @@ Event Types
 - volumedownbutton
 - volumeupbutton
 
-Permissions
------------
-
-### Android
+## Accessing the Feature
 
-#### app/res/xml/config.xml
+* Android
 
+    # app/res/xml/config.xml
     <plugin name="Battery" value="org.apache.cordova.BatteryListener" />
 
-#### app/AndroidManifest.xml
-
+    # app/AndroidManifest.xml
     <uses-permission android:name="android.permission.BROADCAST_STICKY" />
 
-### BlackBerry WebWorks
-
-#### www/plugins.xml
+* BlackBerry WebWorks
 
+    # www/plugins.xml
     <plugin name="Battery" value="org.apache.cordova.battery.Battery" />
 
-#### www/config.xml
-
+    # www/config.xml
     <feature id="blackberry.app"          required="true" version="1.0.0.0" />
     <feature id="blackberry.app.event"    required="true" version="1.0.0.0" />
     <feature id="blackberry.system.event" required="true" version="1.0.0.0" />
 
-### iOS
-
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="Battery" value="CDVBattery" />
 
-### Windows Phone
-
-    No permissions are required.
+* Windows Phone
 
-### Tizen
+  No special permissions are required.
 
-#### config.xml
+* Tizen
 
+    # config.xml
     <feature name="http://tizen.org/api/systeminfo" required="true"/>
 
 Reference: [Application Manifest for Tizen Web Application](https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures)

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/file/file.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/file/file.md b/docs/en/edge/cordova/file/file.md
index 52c24ba..c70c6f9 100644
--- a/docs/en/edge/cordova/file/file.md
+++ b/docs/en/edge/cordova/file/file.md
@@ -41,29 +41,34 @@ Objects
 - LocalFileSystem
 - Metadata
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-file.git
+        $ cordova plugin rm org.apache.cordova.core.file
 
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
+
+* Android
+
+    # app/res/xml/config.xml
     <plugin name="File" value="org.apache.cordova.FileUtils" />
     <plugin name="FileTransfer" value="org.apache.cordova.FileTransfer" />
 
-#### app/AndroidManifest.xml
-
+    # app/AndroidManifest.xml
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
-### BlackBerry WebWorks
-
-#### www/plugins.xml
+* BlackBerry WebWorks
 
+    # www/plugins.xml
     <plugin name="File" value="org.apache.cordova.file.FileManager" />
     <plugin name="FileTransfer" value="org.apache.cordova.http.FileTransfer" />
 
-#### www/config.xml
-
+    # www/config.xml
     <feature id="blackberry.io.file" required="true" version="1.0.0.0" />
     <feature id="blackberry.utils"   required="true" version="1.0.0.0" />
     <feature id="blackberry.io.dir"  required="true" version="1.0.0.0" />
@@ -71,13 +76,12 @@ Permissions
         <rim:permit>access_shared</rim:permit>
     </rim:permissions>
 
-### iOS
-
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="File" value="CDVFile" />
     <plugin name="FileTransfer" value="CDVFileTransfer" />
 
-### Windows Phone
+* Windows Phone
 
-    No permissions are required.
+  No special permissions are required.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/geolocation/geolocation.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/geolocation/geolocation.md b/docs/en/edge/cordova/geolocation/geolocation.md
index f2444c5..1338479 100644
--- a/docs/en/edge/cordova/geolocation/geolocation.md
+++ b/docs/en/edge/cordova/geolocation/geolocation.md
@@ -56,49 +56,52 @@ Objects (Read-Only)
 - PositionError
 - Coordinates
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
+        $ cordova plugin rm org.apache.cordova.core.geolocation
 
-    <plugin name="Geolocation" value="org.apache.cordova.GeoBroker" />
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
+
+* Android
 
-#### app/AndroidManifest.xml
+    # app/res/xml/config.xml
+    <plugin name="Geolocation" value="org.apache.cordova.GeoBroker" />
 
+    # app/AndroidManifest.xml
     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
     <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
 
-### BlackBerry WebWorks
-
-#### www/plugins.xml
+* BlackBerry WebWorks
 
+    # www/plugins.xml
     <plugin name="Geolocation" value="org.apache.cordova.geolocation.Geolocation" />
 
-#### www/config.xml
-
+    # www/config.xml
     <rim:permissions>
         <rim:permit>read_geolocation</rim:permit>
     </rim:permissions>
 
-### iOS
-
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="Geolocation" value="CDVLocation" />
 
-### Windows Phone
-
-#### Properties/WPAppManifest.xml
+* Windows Phone
 
+    # Properties/WPAppManifest.xml
     <Capabilities>
         <Capability Name="ID_CAP_LOCATION" />
     </Capabilities>
 
 Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
 
-### Tizen
+* Tizen
 
-    No permissions are required.
+  No special permissions are required.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/globalization/globalization.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/globalization/globalization.md b/docs/en/edge/cordova/globalization/globalization.md
index b473ec9..813244c 100644
--- a/docs/en/edge/cordova/globalization/globalization.md
+++ b/docs/en/edge/cordova/globalization/globalization.md
@@ -53,11 +53,19 @@ therefore has global scope.
     // The global globalization object
     var globalization = navigator.globalization;
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization.git
+        $ cordova plugin rm org.apache.cordova.core.globalization
 
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
+
+* Android
+
+    # app/res/xml/config.xml
     <plugin name="Globalization" value="org.apache.cordova.Globalization" />

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/inappbrowser/inappbrowser.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/inappbrowser/inappbrowser.md b/docs/en/edge/cordova/inappbrowser/inappbrowser.md
index 3c6b5f8..f47ac94 100644
--- a/docs/en/edge/cordova/inappbrowser/inappbrowser.md
+++ b/docs/en/edge/cordova/inappbrowser/inappbrowser.md
@@ -39,25 +39,31 @@ Methods
 - executeScript
 - insertCSS
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-inappbrowser.git
+        $ cordova plugin rm org.apache.cordova.core.inappbrowser
 
-    <plugin name="InAppBrowser" value="org.apache.cordova.InAppBrowser" />
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
 
-### iOS
+* Android
 
-#### config.xml
+    # app/res/xml/config.xml
+    <plugin name="InAppBrowser" value="org.apache.cordova.InAppBrowser" />
 
-    <plugin name="InAppBrowser" value="CDVInAppBrowser" />
+* iOS
 
-### Windows Phone 7 + 8
+    # config.xml
+    <plugin name="InAppBrowser" value="CDVInAppBrowser" />
 
-#### config.xml
+* Windows Phone 7 + 8
 
+    # config.xml
     <plugin name="InAppBrowser" />
 
 addEventListener

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/media/capture/capture.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/media/capture/capture.md b/docs/en/edge/cordova/media/capture/capture.md
index ca184bb..1637ee3 100644
--- a/docs/en/edge/cordova/media/capture/capture.md
+++ b/docs/en/edge/cordova/media/capture/capture.md
@@ -77,41 +77,44 @@ Supported Platforms
 - Windows Phone 7 and 8
 - Windows 8
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/plugins.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-media-capture.git
+        $ cordova plugin rm org.apache.cordova.core.media-capture
 
-    <plugin name="Capture" value="org.apache.cordova.Capture"/>
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
+
+* Android
 
-#### app/AndroidManifest.xml
+    # app/res/xml/plugins.xml
+    <plugin name="Capture" value="org.apache.cordova.Capture"/>
 
+    # app/AndroidManifest.xml
     <uses-permission android:name="android.permission.RECORD_AUDIO" />
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
-### BlackBerry WebWorks
-
-#### www/plugins.xml
+* BlackBerry WebWorks
 
+    # www/plugins.xml
     <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture" />
 
-#### www/config.xml
-
+    # www/config.xml
     <feature id="blackberry.system"  required="true" version="1.0.0.0" />
     <feature id="blackberry.io.file" required="true" version="1.0.0.0" />
 
-### iOS
-
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="Capture" value="CDVCapture" />
 
-### Windows Phone
-
-#### Properties/WPAppManifest.xml
+* Windows Phone
 
+    # Properties/WPAppManifest.xml
     <Capabilities>
         <Capability Name="ID_CAP_MEDIALIB" />
         <Capability Name="ID_CAP_MICROPHONE" />

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/media/media.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/media/media.md b/docs/en/edge/cordova/media/media.md
index 2f9e49e..ce76c53 100644
--- a/docs/en/edge/cordova/media/media.md
+++ b/docs/en/edge/cordova/media/media.md
@@ -80,37 +80,40 @@ Supported Platforms
 - Tizen
 - Windows 8
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-media.git    
 
-    <plugin name="Media" value="org.apache.cordova.AudioHandler" />
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
+
+* Android
 
-#### app/AndroidManifest.xml
+    # app/res/xml/config.xml
+    <plugin name="Media" value="org.apache.cordova.AudioHandler" />
 
+    # app/AndroidManifest.xml
     <uses-permission android:name="android.permission.RECORD_AUDIO" />
     <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
-### BlackBerry WebWorks
-
-#### www/plugins.xml
+* BlackBerry WebWorks
 
+    # www/plugins.xml
     <plugin name="Capture" value="org.apache.cordova.media.MediaCapture" />
 
-### iOS
-
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="Media" value="CDVSound" />
 
-### Windows Phone
-
-#### Properties/WPAppManifest.xml
+* Windows Phone
 
+    # Properties/WPAppManifest.xml
     <Capabilities>
         <Capability Name="ID_CAP_MEDIALIB" />
         <Capability Name="ID_CAP_MICROPHONE" />
@@ -121,9 +124,9 @@ Permissions
 
 Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
 
-### Tizen
+* Tizen
 
-    No permissions are required.
+  No special permissions are required.
 
 ### Windows Phone Quirks
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/notification/notification.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/notification/notification.md b/docs/en/edge/cordova/notification/notification.md
index d72d51b..ce0a217 100644
--- a/docs/en/edge/cordova/notification/notification.md
+++ b/docs/en/edge/cordova/notification/notification.md
@@ -31,39 +31,46 @@ Methods
 - `notification.beep`
 - `notification.vibrate`
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-vibration.git
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-dialogs.git
+        $ cordova plugin rm org.apache.cordova.core.dialogs
+        $ cordova plugin rm org.apache.cordova.core.vibration
 
-    <plugin name="Notification" value="org.apache.cordova.Notification"/>
 
-#### app/AndroidManifest.xml
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
 
-    <uses-permission android:name="android.permission.VIBRATE" />
+* Android
 
-### BlackBerry WebWorks
+    # app/res/xml/config.xml
+    <plugin name="Notification" value="org.apache.cordova.Notification"/>
 
-#### www/plugins.xml
+    # app/AndroidManifest.xml
+    <uses-permission android:name="android.permission.VIBRATE" />
 
-    <plugin name="Notification" value="org.apache.cordova.notification.Notification" />
+* BlackBerry WebWorks
 
-#### www/config.xml
+    # www/plugins.xml
+    <plugin name="Notification" value="org.apache.cordova.notification.Notification" />
 
+    # www/config.xml
     <feature id="blackberry.ui.dialog" />
 
-### iOS
-
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="Notification" value="CDVNotification" />
 
-### Windows Phone
+* Windows Phone
 
-    No permissions are required.
+  No special permissions are required.
 
-### Tizen
+* Tizen
 
-    No permissions are required.
+  No special permissions are required.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/splashscreen/splashscreen.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/splashscreen/splashscreen.md b/docs/en/edge/cordova/splashscreen/splashscreen.md
index c2cc060..7fe6867 100644
--- a/docs/en/edge/cordova/splashscreen/splashscreen.md
+++ b/docs/en/edge/cordova/splashscreen/splashscreen.md
@@ -28,19 +28,26 @@ Methods
 - splashscreen.show
 - splashscreen.hide
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-line
+Interface, to add or remove this feature for a project:
 
-#### app/res/xml/config.xml
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-splashscreen.git
+        $ cordova plugin rm org.apache.cordova.core.splashscreen
 
-    <plugin name="SplashScreen" value="org.apache.cordova.SplashScreen"/>
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
 
-### iOS
+* Android
+
+    # app/res/xml/config.xml
+    <plugin name="SplashScreen" value="org.apache.cordova.SplashScreen"/>
 
-#### config.xml
+* iOS
 
+    # config.xml
     <plugin name="SplashScreen" value="CDVSplashScreen" />
 
 Setup

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/857cf3df/docs/en/edge/cordova/storage/storage.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/storage/storage.md b/docs/en/edge/cordova/storage/storage.md
index 1f703fd..0ac6641 100644
--- a/docs/en/edge/cordova/storage/storage.md
+++ b/docs/en/edge/cordova/storage/storage.md
@@ -52,29 +52,26 @@ Objects
 - SQLError
 - localStorage
 
-Permissions
------------
+## Accessing the Feature
 
-### Android
-
-#### app/res/xml/config.xml
+* Android
 
+    # app/res/xml/config.xml
     <plugin name="Storage" value="org.apache.cordova.Storage" />
 
-### BlackBerry WebWorks
-
-#### www/config.xml
+* BlackBerry WebWorks
 
+    # www/config.xml
     <feature id="blackberry.widgetcache" required="true" version="1.0.0.0" />
 
-### iOS
+* iOS
 
-    No permissions are required.
+  No special permissions are required.
 
-### Windows Phone
+* Windows Phone
 
-    No permissions are required.
+  No special permissions are required.
 
-### Tizen
+* Tizen
 
-    No permissions are required.
+  No special permissions are required.


[3/3] docs commit: [CB-4379] plugin becomes feature when there's no value param?

Posted by mw...@apache.org.
[CB-4379] plugin becomes feature when there's no value param?


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/c9c4c064
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/c9c4c064
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/c9c4c064

Branch: refs/heads/master
Commit: c9c4c0643de2ad06d8a463471f8bdf1604343222
Parents: 7b8a92b
Author: Mike Sierra <le...@gmail.com>
Authored: Sat Jul 27 08:32:12 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Mon Jul 29 11:36:56 2013 -0700

----------------------------------------------------------------------
 docs/en/edge/cordova/inappbrowser/inappbrowser.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c9c4c064/docs/en/edge/cordova/inappbrowser/inappbrowser.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/inappbrowser/inappbrowser.md b/docs/en/edge/cordova/inappbrowser/inappbrowser.md
index ac5ec14..02754cb 100644
--- a/docs/en/edge/cordova/inappbrowser/inappbrowser.md
+++ b/docs/en/edge/cordova/inappbrowser/inappbrowser.md
@@ -68,7 +68,7 @@ platform-specific configuration settings described below:
 * Windows Phone 7 + 8
 
     <!-- config.xml -->
-    <plugin name="InAppBrowser" />
+    <feature name="InAppBrowser" />
 
 addEventListener
 ================


[2/3] docs commit: [CB-4379] feature tag syntax replaces plugin

Posted by mw...@apache.org.
[CB-4379] feature tag syntax replaces plugin


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/7b8a92b6
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/7b8a92b6
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/7b8a92b6

Branch: refs/heads/master
Commit: 7b8a92b67b42db5deb65f0ffbd0b938c51eb6bdd
Parents: 857cf3d
Author: Mike Sierra <le...@gmail.com>
Authored: Sat Jul 27 08:15:06 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Mon Jul 29 11:36:15 2013 -0700

----------------------------------------------------------------------
 .../edge/cordova/accelerometer/accelerometer.md | 22 +++++++-----
 docs/en/edge/cordova/camera/camera.md           | 26 ++++++++------
 docs/en/edge/cordova/compass/compass.md         | 14 +++++---
 docs/en/edge/cordova/connection/connection.md   | 24 ++++++++-----
 docs/en/edge/cordova/contacts/contacts.md       | 24 ++++++++-----
 docs/en/edge/cordova/device/device.md           | 20 ++++++-----
 docs/en/edge/cordova/events/events.md           | 24 ++++++++-----
 docs/en/edge/cordova/file/file.md               | 36 +++++++++++++-------
 docs/en/edge/cordova/geolocation/geolocation.md | 24 ++++++++-----
 .../edge/cordova/globalization/globalization.md |  6 ++--
 .../edge/cordova/inappbrowser/inappbrowser.md   | 14 +++++---
 docs/en/edge/cordova/media/capture/capture.md   | 24 ++++++++-----
 docs/en/edge/cordova/media/media.md             | 22 +++++++-----
 .../edge/cordova/notification/notification.md   | 22 +++++++-----
 .../edge/cordova/splashscreen/splashscreen.md   | 12 ++++---
 docs/en/edge/cordova/storage/storage.md         |  8 +++--
 16 files changed, 204 insertions(+), 118 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/accelerometer/accelerometer.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/accelerometer/accelerometer.md b/docs/en/edge/cordova/accelerometer/accelerometer.md
index f23abc2..9c2704d 100644
--- a/docs/en/edge/cordova/accelerometer/accelerometer.md
+++ b/docs/en/edge/cordova/accelerometer/accelerometer.md
@@ -55,26 +55,32 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Accelerometer" value="org.apache.cordova.AccelListener" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="Accelerometer">
+        <param name="android-package" value="org.apache.cordova.AccelListener" />
+    </feature>
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="Accelerometer" value="org.apache.cordova.accelerometer.Accelerometer" />
+    <!-- www/plugins.xml -->
+    <feature name="Accelerometer">
+        <param name="blackberry-package" value="org.apache.cordova.accelerometer.Accelerometer" />
+    </feature>
 
-    # www/config.xml
+    <!-- www/config.xml -->
     <feature id="blackberry.system"  required="true" version="1.0.0.0" />
     <feature id="org.apache.cordova" required="true" version="1.0.0" />
 
 * iOS
 
-    # config.xml
-    <plugin name="Accelerometer" value="CDVAccelerometer" />
+    <!-- config.xml -->
+    <feature name="Accelerometer">
+        <param name="ios-package" value="CDVAccelerometer" />
+    </feature>
 
 * Windows Phone
 
-    # Properties/WPAppManifest.xml
+    <!-- Properties/WPAppManifest.xml -->
     <Capabilities>
         <Capability Name="ID_CAP_SENSORS" />
     </Capabilities>

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/camera/camera.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/camera/camera.md b/docs/en/edge/cordova/camera/camera.md
index 9eea801..54649dd 100644
--- a/docs/en/edge/cordova/camera/camera.md
+++ b/docs/en/edge/cordova/camera/camera.md
@@ -44,18 +44,22 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Camera" value="org.apache.cordova.CameraLauncher" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="Camera">
+        <param name="android-package" value="org.apache.cordova.CameraLauncher" />
+    </feature>
 
-    # app/AndroidManifest
+    <!-- app/AndroidManifest -->
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="Camera" value="org.apache.cordova.camera.Camera" />
+    <!-- www/plugins.xml -->
+    <feature name="Camera">
+        <param name="blackberry-package" value="org.apache.cordova.camera.Camera" />
+    </feature>
 
-    # www/config.xml
+    <!-- www/config.xml -->
     <feature id="blackberry.media.camera" />
 
     <rim:permissions>
@@ -64,12 +68,14 @@ platform-specific configuration settings described below:
 
 * iOS
 
-    # config.xml
-    <plugin name="Camera" value="CDVCamera" />
+    <!-- config.xml -->
+    <feature name="Camera">
+        <param name="ios-package" value="CDVCamera" />
+    </feature>
 
 * Windows Phone
 
-    # Properties/WPAppManifest.xml
+    <!-- Properties/WPAppManifest.xml -->
     <Capabilities>
         <Capability Name="ID_CAP_ISV_CAMERA" />
         <Capability Name="ID_HW_FRONTCAMERA" />
@@ -79,7 +85,7 @@ Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en
 
 * Tizen
 
-    # config.xml
+    <!-- config.xml -->
     <feature name="http://tizen.org/api/application" required="true"/>
     <feature name="http://tizen.org/api/application.launch" required="true"/>
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/compass/compass.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/compass/compass.md b/docs/en/edge/cordova/compass/compass.md
index 31ef597..fdd3096 100755
--- a/docs/en/edge/cordova/compass/compass.md
+++ b/docs/en/edge/cordova/compass/compass.md
@@ -53,8 +53,10 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Compass" value="org.apache.cordova.CompassListener" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="Compass">
+        <param name="android-package" value="org.apache.cordova.CompassListener" />
+    </feature>
 
 * BlackBerry WebWorks
 
@@ -62,12 +64,14 @@ platform-specific configuration settings described below:
 
 * iOS
 
-    # config.xml
-    <plugin name="Compass" value="CDVLocation" />
+    <!-- config.xml -->
+    <feature name="Compass">
+        <param name="ios-package" value="CDVLocation" />
+    </feature>
 
 * Windows Phone
 
-    # Properties/WPAppManifest.xml
+    <!-- Properties/WPAppManifest.xml -->
     <Capabilities>
         <Capability Name="ID_CAP_SENSORS" />
     </Capabilities>

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/connection/connection.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/connection/connection.md b/docs/en/edge/cordova/connection/connection.md
index 0e5ed1d..c1fcf60 100644
--- a/docs/en/edge/cordova/connection/connection.md
+++ b/docs/en/edge/cordova/connection/connection.md
@@ -53,27 +53,33 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="NetworkStatus" value="org.apache.cordova.NetworkManager" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="NetworkStatus">
+        <param name="android-package" value="org.apache.cordova.NetworkManager" />
+    </feature>
 
-    # app/AndroidManifest.xml
+    <!-- app/AndroidManifest.xml -->
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     <uses-permission android:name="android.permission.READ_PHONE_STATE" />
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="Network Status" value="org.apache.cordova.network.Network" />
+    <!-- www/plugins.xml -->
+    <feature name="Network Status">
+        <param name="blackberry-package" value="org.apache.cordova.network.Network" />
+    </feature>
 
 * iOS
 
-    # config.xml
-    <plugin name="NetworkStatus" value="CDVConnection" />
+    <!-- config.xml -->
+    <feature name="NetworkStatus">
+        <param name="ios-package" value="CDVConnection" />
+    </feature>
 
 * Windows Phone
 
-    # Properties/WPAppManifest.xml
+    <!-- Properties/WPAppManifest.xml -->
     <Capabilities>
         <Capability Name="ID_CAP_NETWORKING" />
     </Capabilities>
@@ -82,7 +88,7 @@ Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en
 
 * Tizen
 
-    # config.xml
+    <!-- config.xml -->
     <feature name="http://tizen.org/api/systeminfo" required="true"/>
 
 Reference: [Application Manifest for Tizen Web Application](https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures)

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/contacts/contacts.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/contacts.md b/docs/en/edge/cordova/contacts/contacts.md
index ad8c7f8..7e33118 100644
--- a/docs/en/edge/cordova/contacts/contacts.md
+++ b/docs/en/edge/cordova/contacts/contacts.md
@@ -63,20 +63,24 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Contacts" value="org.apache.cordova.ContactManager" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="Contacts">
+        <param name="android-package" value="org.apache.cordova.ContactManager" />
+    </feature>
 
-    # app/AndroidManifest.xml
+    <!-- app/AndroidManifest.xml -->
     <uses-permission android:name="android.permission.GET_ACCOUNTS" />
     <uses-permission android:name="android.permission.READ_CONTACTS" />
     <uses-permission android:name="android.permission.WRITE_CONTACTS" />
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="Contact" value="org.apache.cordova.pim.Contact" />
+    <!-- www/plugins.xml -->
+    <feature name="Contact">
+        <param name="blackberry-package" value="org.apache.cordova.pim.Contact" />
+    </feature>
 
-    # www/config.xml
+    <!-- www/config.xml -->
     <feature id="blackberry.find"        required="true" version="1.0.0.0" />
     <feature id="blackberry.identity"    required="true" version="1.0.0.0" />
     <feature id="blackberry.pim.Address" required="true" version="1.0.0.0" />
@@ -84,12 +88,14 @@ platform-specific configuration settings described below:
 
 * iOS
 
-    # config.xml
-    <plugin name="Contacts" value="CDVContacts" />
+    <!-- config.xml -->
+    <feature name="Contacts">
+        <param name="ios-package" value="CDVContacts" />
+    </feature>
 
 * Windows Phone
 
-    # Properties/WPAppManifest.xml
+    <!-- Properties/WPAppManifest.xml -->
     <Capabilities>
         <Capability Name="ID_CAP_CONTACTS" />
     </Capabilities>

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/device/device.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/device/device.md b/docs/en/edge/cordova/device/device.md
index ffbfaef..ced2c76 100644
--- a/docs/en/edge/cordova/device/device.md
+++ b/docs/en/edge/cordova/device/device.md
@@ -55,18 +55,22 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Device" value="org.apache.cordova.Device" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="Device">
+        <param name="android-package" value="org.apache.cordova.Device" />
+    </feature>
 
-    # app/AndroidManifest.xml
+    <!-- app/AndroidManifest.xml -->
     <uses-permission android:name="android.permission.READ_PHONE_STATE" />
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="Device" value="org.apache.cordova.device.Device" />
+    <!-- www/plugins.xml -->
+    <feature name="Device">
+        <param name="blackberry-package" value="org.apache.cordova.device.Device" />
+    </feature>
 
-    # www/config.xml
+    <!-- www/config.xml -->
     <feature id="blackberry.app" required="true" version="1.0.0.0" />
     <rim:permissions>
         <rim:permit>read_device_identifying_information</rim:permit>
@@ -78,7 +82,7 @@ platform-specific configuration settings described below:
 
 * Windows Phone
 
-    # Properties/WPAppManifest.xml
+    <!-- Properties/WPAppManifest.xml -->
     <Capabilities>
         <Capability Name="ID_CAP_WEBBROWSERCOMPONENT" />
         <Capability Name="ID_CAP_IDENTITY_DEVICE" />
@@ -89,7 +93,7 @@ Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en
 
 * Tizen
 
-    # config.xml
+    <!-- config.xml -->
     <feature name="http://tizen.org/api/systeminfo" required="true"/>
 
 Reference: [Application Manifest for Tizen Web Application](https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures)

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/events/events.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/events/events.md b/docs/en/edge/cordova/events/events.md
index 8e471f3..eb51584 100644
--- a/docs/en/edge/cordova/events/events.md
+++ b/docs/en/edge/cordova/events/events.md
@@ -45,26 +45,32 @@ Event Types
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Battery" value="org.apache.cordova.BatteryListener" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="Battery">
+        <param name="android-package" value="org.apache.cordova.BatteryListener" />
+    </feature>
 
-    # app/AndroidManifest.xml
+    <!-- app/AndroidManifest.xml -->
     <uses-permission android:name="android.permission.BROADCAST_STICKY" />
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="Battery" value="org.apache.cordova.battery.Battery" />
+    <!-- www/plugins.xml -->
+    <feature name="Battery">
+        <param name="blackberry-package" value="org.apache.cordova.battery.Battery" />
+    </feature>
 
-    # www/config.xml
+    <!-- www/config.xml -->
     <feature id="blackberry.app"          required="true" version="1.0.0.0" />
     <feature id="blackberry.app.event"    required="true" version="1.0.0.0" />
     <feature id="blackberry.system.event" required="true" version="1.0.0.0" />
 
 * iOS
 
-    # config.xml
-    <plugin name="Battery" value="CDVBattery" />
+    <!-- config.xml -->
+    <feature name="Battery">
+        <param name="ios-package" value="CDVBattery" />
+    </feature>
 
 * Windows Phone
 
@@ -72,7 +78,7 @@ Event Types
 
 * Tizen
 
-    # config.xml
+    <!-- config.xml -->
     <feature name="http://tizen.org/api/systeminfo" required="true"/>
 
 Reference: [Application Manifest for Tizen Web Application](https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures)

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/file/file.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/file/file.md b/docs/en/edge/cordova/file/file.md
index c70c6f9..2a8350b 100644
--- a/docs/en/edge/cordova/file/file.md
+++ b/docs/en/edge/cordova/file/file.md
@@ -55,20 +55,28 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="File" value="org.apache.cordova.FileUtils" />
-    <plugin name="FileTransfer" value="org.apache.cordova.FileTransfer" />
-
-    # app/AndroidManifest.xml
+    <!-- app/res/xml/config.xml -->
+    <feature name="File">
+        <param name="android-package" value="org.apache.cordova.FileUtils" />
+    </feature>
+    <feature name="FileTransfer">
+        <param name="android-package" value="org.apache.cordova.FileTransfer" />
+    </feature>
+
+    <!-- app/AndroidManifest.xml -->
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="File" value="org.apache.cordova.file.FileManager" />
-    <plugin name="FileTransfer" value="org.apache.cordova.http.FileTransfer" />
+    <!-- www/plugins.xml -->
+    <feature name="File">
+        <param name="blackberry-package" value="org.apache.cordova.file.FileManager" />
+    </feature>
+    <feature name="FileTransfer">
+        <param name="blackberry-package" value="org.apache.cordova.http.FileTransfer" />
+    </feature>
 
-    # www/config.xml
+    <!-- www/config.xml -->
     <feature id="blackberry.io.file" required="true" version="1.0.0.0" />
     <feature id="blackberry.utils"   required="true" version="1.0.0.0" />
     <feature id="blackberry.io.dir"  required="true" version="1.0.0.0" />
@@ -78,9 +86,13 @@ platform-specific configuration settings described below:
 
 * iOS
 
-    # config.xml
-    <plugin name="File" value="CDVFile" />
-    <plugin name="FileTransfer" value="CDVFileTransfer" />
+    <!-- config.xml -->
+    <feature name="File">
+        <param name="ios-package" value="CDVFile" />
+    </feature>
+    <feature name="FileTransfer">
+        <param name="ios-package" value="CDVFileTransfer" />
+    </feature>
 
 * Windows Phone
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/geolocation/geolocation.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/geolocation/geolocation.md b/docs/en/edge/cordova/geolocation/geolocation.md
index 1338479..0f39c66 100644
--- a/docs/en/edge/cordova/geolocation/geolocation.md
+++ b/docs/en/edge/cordova/geolocation/geolocation.md
@@ -70,32 +70,38 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Geolocation" value="org.apache.cordova.GeoBroker" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="Geolocation">
+        <param name="android-package" value="org.apache.cordova.GeoBroker" />
+    </feature>
 
-    # app/AndroidManifest.xml
+    <!-- app/AndroidManifest.xml -->
     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
     <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="Geolocation" value="org.apache.cordova.geolocation.Geolocation" />
+    <!-- www/plugins.xml -->
+    <feature name="Geolocation">
+        <param name="blackberry-package" value="org.apache.cordova.geolocation.Geolocation" />
+    </feature>
 
-    # www/config.xml
+    <!-- www/config.xml -->
     <rim:permissions>
         <rim:permit>read_geolocation</rim:permit>
     </rim:permissions>
 
 * iOS
 
-    # config.xml
-    <plugin name="Geolocation" value="CDVLocation" />
+    <!-- config.xml -->
+    <feature name="Geolocation">
+        <param name="ios-package" value="CDVLocation" />
+    </feature>
 
 * Windows Phone
 
-    # Properties/WPAppManifest.xml
+    <!-- Properties/WPAppManifest.xml -->
     <Capabilities>
         <Capability Name="ID_CAP_LOCATION" />
     </Capabilities>

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/globalization/globalization.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/globalization/globalization.md b/docs/en/edge/cordova/globalization/globalization.md
index 813244c..f9ad81a 100644
--- a/docs/en/edge/cordova/globalization/globalization.md
+++ b/docs/en/edge/cordova/globalization/globalization.md
@@ -67,5 +67,7 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Globalization" value="org.apache.cordova.Globalization" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="Globalization">
+        <param name="android-package" value="org.apache.cordova.Globalization" />
+    </feature>

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/inappbrowser/inappbrowser.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/inappbrowser/inappbrowser.md b/docs/en/edge/cordova/inappbrowser/inappbrowser.md
index f47ac94..ac5ec14 100644
--- a/docs/en/edge/cordova/inappbrowser/inappbrowser.md
+++ b/docs/en/edge/cordova/inappbrowser/inappbrowser.md
@@ -53,17 +53,21 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="InAppBrowser" value="org.apache.cordova.InAppBrowser" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="InAppBrowser">
+        <param name="android-package" value="org.apache.cordova.InAppBrowser" />
+    </feature>
 
 * iOS
 
-    # config.xml
-    <plugin name="InAppBrowser" value="CDVInAppBrowser" />
+    <!-- config.xml -->
+    <feature name="InAppBrowser">
+        <param name="ios-package" value="CDVInAppBrowser" />
+    </feature>
 
 * Windows Phone 7 + 8
 
-    # config.xml
+    <!-- config.xml -->
     <plugin name="InAppBrowser" />
 
 addEventListener

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/media/capture/capture.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/media/capture/capture.md b/docs/en/edge/cordova/media/capture/capture.md
index 1637ee3..bf8a395 100644
--- a/docs/en/edge/cordova/media/capture/capture.md
+++ b/docs/en/edge/cordova/media/capture/capture.md
@@ -91,30 +91,36 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/plugins.xml
-    <plugin name="Capture" value="org.apache.cordova.Capture"/>
+    <!-- app/res/xml/plugins.xml -->
+    <feature name="Capture">
+        <param name="android-package" value="org.apache.cordova.Capture" />
+    </feature>
 
-    # app/AndroidManifest.xml
+    <!-- app/AndroidManifest.xml -->
     <uses-permission android:name="android.permission.RECORD_AUDIO" />
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture" />
+    <!-- www/plugins.xml -->
+    <feature name="Capture">
+        <param name="blackberry-package" value="org.apache.cordova.capture.MediaCapture" />
+    </feature>
 
-    # www/config.xml
+    <!-- www/config.xml -->
     <feature id="blackberry.system"  required="true" version="1.0.0.0" />
     <feature id="blackberry.io.file" required="true" version="1.0.0.0" />
 
 * iOS
 
-    # config.xml
-    <plugin name="Capture" value="CDVCapture" />
+    <!-- config.xml -->
+    <feature name="Capture">
+        <param name="ios-package" value="CDVCapture" />
+    </feature>
 
 * Windows Phone
 
-    # Properties/WPAppManifest.xml
+    <!-- Properties/WPAppManifest.xml -->
     <Capabilities>
         <Capability Name="ID_CAP_MEDIALIB" />
         <Capability Name="ID_CAP_MICROPHONE" />

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/media/media.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/media/media.md b/docs/en/edge/cordova/media/media.md
index ce76c53..f673f38 100644
--- a/docs/en/edge/cordova/media/media.md
+++ b/docs/en/edge/cordova/media/media.md
@@ -93,27 +93,33 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Media" value="org.apache.cordova.AudioHandler" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="Media">
+        <param name="android-package" value="org.apache.cordova.AudioHandler" />
+    </feature>
 
-    # app/AndroidManifest.xml
+    <!-- app/AndroidManifest.xml -->
     <uses-permission android:name="android.permission.RECORD_AUDIO" />
     <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="Capture" value="org.apache.cordova.media.MediaCapture" />
+    <!-- www/plugins.xml -->
+    <feature name="Capture">
+        <param name="blackberry-package" value="org.apache.cordova.media.MediaCapture" />
+    </feature>
 
 * iOS
 
-    # config.xml
-    <plugin name="Media" value="CDVSound" />
+    <!-- config.xml -->
+    <feature name="Media">
+        <param name="ios-package" value="CDVSound" />
+    </feature>
 
 * Windows Phone
 
-    # Properties/WPAppManifest.xml
+    <!-- Properties/WPAppManifest.xml -->
     <Capabilities>
         <Capability Name="ID_CAP_MEDIALIB" />
         <Capability Name="ID_CAP_MICROPHONE" />

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/notification/notification.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/notification/notification.md b/docs/en/edge/cordova/notification/notification.md
index ce0a217..dba157d 100644
--- a/docs/en/edge/cordova/notification/notification.md
+++ b/docs/en/edge/cordova/notification/notification.md
@@ -48,24 +48,30 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Notification" value="org.apache.cordova.Notification"/>
+    <!-- app/res/xml/config.xml -->
+    <feature name="Notification">
+        <param name="android-package" value="org.apache.cordova.Notification" />
+    </feature>
 
-    # app/AndroidManifest.xml
+    <!-- app/AndroidManifest.xml -->
     <uses-permission android:name="android.permission.VIBRATE" />
 
 * BlackBerry WebWorks
 
-    # www/plugins.xml
-    <plugin name="Notification" value="org.apache.cordova.notification.Notification" />
+    <!-- www/plugins.xml -->
+    <feature name="Notification">
+        <param name="blackberry-package" value="org.apache.cordova.notification.Notification" />
+    </feature>
 
-    # www/config.xml
+    <!-- www/config.xml -->
     <feature id="blackberry.ui.dialog" />
 
 * iOS
 
-    # config.xml
-    <plugin name="Notification" value="CDVNotification" />
+    <!-- config.xml -->
+    <feature name="Notification">
+        <param name="ios-package" value="CDVNotification" />
+    </feature>
 
 * Windows Phone
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/splashscreen/splashscreen.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/splashscreen/splashscreen.md b/docs/en/edge/cordova/splashscreen/splashscreen.md
index 7fe6867..40588d5 100644
--- a/docs/en/edge/cordova/splashscreen/splashscreen.md
+++ b/docs/en/edge/cordova/splashscreen/splashscreen.md
@@ -42,13 +42,17 @@ platform-specific configuration settings described below:
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="SplashScreen" value="org.apache.cordova.SplashScreen"/>
+    <!-- app/res/xml/config.xml -->
+    <feature name="SplashScreen">
+        <param name="android-package" value="org.apache.cordova.SplashScreen" />
+    </feature>
 
 * iOS
 
-    # config.xml
-    <plugin name="SplashScreen" value="CDVSplashScreen" />
+    <!-- config.xml -->
+    <feature name="SplashScreen">
+        <param name="ios-package" value="CDVSplashScreen" />
+    </feature>
 
 Setup
 -----

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7b8a92b6/docs/en/edge/cordova/storage/storage.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/storage/storage.md b/docs/en/edge/cordova/storage/storage.md
index 0ac6641..234523f 100644
--- a/docs/en/edge/cordova/storage/storage.md
+++ b/docs/en/edge/cordova/storage/storage.md
@@ -56,12 +56,14 @@ Objects
 
 * Android
 
-    # app/res/xml/config.xml
-    <plugin name="Storage" value="org.apache.cordova.Storage" />
+    <!-- app/res/xml/config.xml -->
+    <feature name="Storage">
+        <param name="android-package" value="org.apache.cordova.Storage" />
+    </feature>
 
 * BlackBerry WebWorks
 
-    # www/config.xml
+    <!-- www/config.xml -->
     <feature id="blackberry.widgetcache" required="true" version="1.0.0.0" />
 
 * iOS