Reply-To: dev@cordova.apache.org Delivered-To: mailing list commits@cordova.apache.org Received: (qmail 5215 invoked by uid 99); 28 Apr 2014 19:25:35 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 28 Apr 2014 19:25:35 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 28 Apr 2014 19:25:29 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 9EB2C2388B3A; Mon, 28 Apr 2014 19:25:09 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: svn commit: r1590759 [3/8] - in /cordova/site/public/docs: en/2.3.0/ en/2.4.0/ en/2.5.0/ en/2.6.0/ en/2.7.0/ en/2.8.0/ en/2.9.0/ en/3.2.0/ en/3.3.0/ en/3.4.0/ en/edge/ es/edge/ fr/edge/ Date: Mon, 28 Apr 2014 19:25:05 -0000 To: commits@cordova.apache.org From: ian@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20140428192509.9EB2C2388B3A@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Modified: cordova/site/public/docs/en/edge/guide_platforms_android_index.md.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_android_index.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff ============================================================================== --- cordova/site/public/docs/en/edge/guide_platforms_android_index.md.html (original) +++ cordova/site/public/docs/en/edge/guide_platforms_android_index.md.html Mon Apr 28 19:25:02 2014 @@ -114,9 +114,13 @@

Android Platform Guide

+ +

@@ -148,47 +152,41 @@

Android Platform Guide

This guide shows how to set up your SDK development environment to -deploy Cordova apps for Android devices. It shows how to install the -Android SDK, open an Android project in the SDK, and deploy it to an -emulator or device. You need to follow the instructions to install -the Android SDK, regardless of whether you use the cross-platform -workflow discussed in the Overview, or the platform-centered shell -tools detailed at Android Command-line Tools.

- -

See the following for more detailed platform-specific information:

- -

The command-line tools above refer to versions prior to Cordova 3.0. -See The Command-Line Interface for information about the -current interface.

This guide shows how to set up your SDK environment to deploy Cordova +apps for Android devices, and how to optionally use Android-centered +command-line tools in your development workflow. You need to install +the Android SDK regardless of whether you want to use these +platform-centered shell tools or cross-platform Cordova CLI for +development. For a comparison of the two development paths, see the +Overview. For details on the CLI, see The Command-Line Interface.

Requirements and Support

See the System Requirements -for the Android SDK.

See the Android SDK's System Requirements.

Cordova supports Android 2.2, 2.3, and 4.x. As a general rule, platforms are deprecated as they dip below 5% on Google's distribution dashboard.

- - -

Developers should use the cordova utility in conjunction with -the Android SDK. See The Command-Line Interface for -information how to install it, add projects, then build and deploy a -project.

Install Cordova Shell Tools

+ +

If you want to use Cordova's Android-centered shell tools in +conjunction with the SDK, download Cordova from +cordova.apache.org. Otherwise ignore this +section if you plan to use the cross-platform CLI tool described in +The Command-Line Interface.

+ +

The Cordova download contains separate archives for each platform. Be +sure to expand the appropriate archive, android in this case, within +an empty directory. The relevant executible utilities are available +in the top-level bin directory. (Consult the README file if +necessary for more detailed directions.)

+ +

These shell tools allow you to create, build, and run Android apps. +For information on the additional command-line interface that enables +plugin features across all platforms, see Using Plugman to Manage +Plugins. See Application Plugins for details on how to develop +plugins.

Install the Android SDK from developer.android.com/sdk. The android sdk @@ -197,18 +195,13 @@ On windows, the adt-bundle is packaged w On OSX and Linux, simply unpack the 'adt-bundle' in the location you store development tools. More detailed information on Android SDK setup can be found here

For Cordova command-line tools to work, you need to include the SDK's -tools and platform-tools directories in your PATH environment. You also -will need java and ant. You may already have java and ant in your -PATH environment, try invoking them from a command line prompt to see if they -are missing, and add only what is missing to your PATH. Be aware that Mavericks -omits ant as compared to previous versions of OSX, so you may need to -install ant separately if you are using Mavericks or later of OSX. On -OSX or Linux, you can use a text editor to create or modify the -~/.bash_profile file, adding a line such as the following (modify the -locations to where the SDK is installed on your workstation):

For Cordova command-line tools to work, or the CLI that is based upon +them, you need to include the SDK's tools and platform-tools +directories in your PATH. On a Mac, you can use a text editor to +create or modify the ~/.bash_profile file, adding a line such as the +following, depending on where the SDK installs:

export PATH=${PATH}:/Development/adt-bundle/sdk/platform-tools:/Development/adt-bundle/sdk/tools
+    export PATH=${PATH}:/Development/adt-bundle/sdk/platform-tools:/Development/adt-bundle/sdk/tools
 
 
 Add the paths for java and ant if needed. This line in ~/.bash_profile
@@ -216,85 +209,126 @@ exposes these tools in newly opened term
 window is already open in OSX, or to avoid a logout/login on Linux, run
 this to make them available in the current terminal window:
 
-$ source ~/.bash_profile
+    $ source ~/.bash_profile
 
 
-To modify the PATH environment on Windows:
+To modify the PATH environment on Windows 7:
 
-
+
 Click on the Start menu in the lower-left corner of the desktop,
-right-click on Computer, then click Properties.
-Click Advanced System Settings in the column on the left.
+right-click on Computer, then select Properties.
+Select Advanced System Settings in the column on the left.
 In the resulting dialog box, press Environment Variables.
 Select the PATH variable and press Edit.
 
-Append the following to the PATH based on where you installed the
+
Append the following to the PATH based on where you installed the
 SDK, for example:
 
 ;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools
 
 
 Save the value and close both dialog boxes.
-
-You may also need to add Java and Ant. Open a command prompt and
-type java, and also type ant. For whichever fail to run, append to the PATH
-like this:
+
 
-;%JAVA_HOME%\bin;%ANT_HOME%\bin
+You may also need to enable Java and Ant. Open a command prompt and
+type java, and also type ant. Append to the PATH whichever of
+these fails to run:
+
+    ;%JAVA_HOME%\bin;%ANT_HOME%\bin
 
-
-

 
-Open a Project in the SDK
+Open a New Project in the SDK
 
-Use the cordova utility to set up a new project, as described in The
-Cordova The Command-Line Interface. For example, in a source-code directory:
+At this point, to create a new project you can choose between the
+cross-platform CLI tool described in The Command-Line Interface, or
+the set of Android-specific shell tools. From within a source-code
+directory, here's the CLI approach:
 
-    $ cordova create hello com.example.hello "HelloWorld"
+    $ cordova create hello com.example.hello HelloWorld
     $ cd hello
     $ cordova platform add android
     $ cordova build
 
 
-Once created, you can use the Eclipse that comes along with the Android SDK to modify it:
+Here's the corresponding lower-level shell-tool approach for both Unix
+and Windows:
 
-
+    $ /path/to/cordova-android/bin/create /path/to/new/hello com.example.hello HelloWorld
+    C:\path\to\cordova-android\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld
+
+
+Here's how to use the SDK to modify it:
+
+
 Launch the Eclipse application.
 Select the New Project menu item.
-Choose Android Project from Existing Code from the resulting dialog box, and press Next:
-
-Navigate to hello, or whichever directory you created for the project, then to the platforms/android subdirectory.
-Make sure both hello and hello-CordovaLib projects are selected to be imported. The hello-CordovaLib project is needed as of Cordova 3.3.0 because Cordova is now used as an Android Library instead of a .jar file.
+
+Choose Android Project from Existing Code from the resulting
+dialog box, and press Next:
+
+
+
+If you're using the CLI, navigate to the hello directory you
+created for the project, then to the platforms/android
+subdirectory. Alternately, if you use the create shell utility,
+simply navigate to the hello directory.
 Press Finish.
-
+
 
 Once the Eclipse window opens, a red X may appear to indicate
 unresolved problems. If so, follow these additional steps:
 
-
+
 Right-click on the project directory.
 In the resulting Properties dialog, select Android from the navigation pane.
 For the project build target, select the highest Android API level you have installed.
 Click OK.
 Select Clean from the Project menu. This should correct all the errors in the project.
-
+
 
-Deploy to Emulator
+Build the Project
 
-You can use the cordova utility to run an app in an emulator, or you
-can run it within the SDK.  Either way, the SDK must first be
-configured to display at least one device. To do so, use the Android
-SDK Manager, a Java application that runs separately from Eclipse.
-There are two ways to open it:
+If you are using the CLI in development, the project directory's
+top-level www directory contains the source files. Run either of
+these within the project directory to rebuild the app:
 
-
+    $ cordova build
+    $ cordova build android   # do not rebuild other platforms
+
+
+If you are using the Android-specific shell tools in development,
+there is a different approach.  Once you generate the project, the
+default app's source is available in the assets/www subdirectory.
+Subsequent commands are available in its cordova subdirectory.
+
+The build command cleans project files and rebuilds the app. Here is
+the syntax for both Mac and Windows. The first pair of examples
+generate debugging information, and the second signs the apps for
+release:
+
+    $ /path/to/project/cordova/build --debug
+    C:\path\to\project\cordova\build.bat --debug
+
+    $ /path/to/project/cordova/build --release
+    C:\path\to\project\cordova\build.bat --release
+
+
+Configure an Emulator
+
+You can use either the cordova CLI utility or Cordova's
+Android-centered shell tools to run an app in an emulator.  Either
+way, the SDK must first be configured to display at least one device.
+To do so, use the Android SDK Manager, a Java application that runs
+separately from Eclipse.  There are two ways to open it:
+
+
 Run android on the command line.
 
 From within Eclipse, press this toolbar icon:
 
 
 
-
+
 
 Once open, the Android SDK Manager displays various runtime libraries:
 
@@ -321,13 +355,37 @@ additional controls available for hardwa
 
 
 
-At this point you can use the cordova utility to deploy the
+
Deploy to Emulator
+
+At this point you can use the cordova CLI utility to deploy the
 application to the emulator from the command line:
 
     $ cordova emulate android
 
 
-If instead you work within Eclipse, right-click the project and
+
Otherwise use the alternate shell interface:
+
+    $ /path/to/project/cordova/run --emulator
+
+
+Instead of relying on whichever emulator is currently enabled within
+the SDK, you can refer to each by the names you supply:
+
+    $ /path/to/project/cordova/run --target=NAME
+
+
+This pushes the app to the home screen and launches it:
+
+
+
+When you run the app, you also build it. You can append additional
+--debug, --release, and --nobuild flags to control how it is
+built, or even whether a rebuild is necessary:
+
+    $ /path/to/project/cordova/run --emulator --nobuild
+
+
+If instead you are working within Eclipse, right-click the project and
 choose Run As â Android Application. You may be asked to
 specify an AVD if none are already open.
 
@@ -367,13 +425,16 @@ Android SDK at extras/intel/Hardwa
 Note:If you have any problems installing the package, you can find more information and step by step guidance check this 
 Intel Article.
 
-Once installed, in order to test it, create new a AVD  with the CPU/ABI set to an Intel (Atom) x86  Image:
-
-
-
-If you are using Linux-based system, follow the instructions in the Android Developer Site.
-
-When starting the emulator, ensure there are no error messages indicating a failure to load HAXM modules.
+
+Install one or more Intel x86 Atom System Images as well as the
+Intel Hardware Accelerated Execution Manager, available under
+Extras.
+Run the Intel installer, which is available within your Android SDK
+at extras/intel/Hardware_Accelerated_Execution_Manager.
+Create a new AVD with the target set to an Intel image.
+When starting the emulator, ensure there are no error messages
+indicating a failure to load HAX modules.
+
 
 Deploy to Device
 
@@ -382,13 +443,36 @@ enabled on your device as described on t
 Android Developer Site,
 and use a mini USB cable to plug it into your system.
 
-You can push the app to the device from the command line:
+You can use this CLI command to push the app to the device:
 
     $ cordova run android
 
 
-Alternately within Eclipse, right-click the project and choose Run
-As â Android Application.
+...or use this Android-centered shell interface:
+
+    $ /path/to/project/cordova/run --device
+
+
+With no flags specified, the run command detects a connected
+device, or a currently running emulator if no device is found,
+otherwise it prompts to specify an emulator.
+
+To run the app from within Eclipse, right-click the project and choose
+Run As â Android Application.
+
+Other Commands
+
+The following generates a detailed log of the app as it runs:
+
+    $ /path/to/project/cordova/log
+    C:\path\to\project\cordova\log.bat
+
+
+The following cleans the project files:
+
+    $ /path/to/project/cordova/clean
+    C:\path\to\project\cordova\clean.bat
+



Modified: cordova/site/public/docs/en/edge/guide_platforms_android_tools.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_android_tools.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_android_tools.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_android_tools.md.html Mon Apr 28 19:25:02 2014
@@ -111,12 +111,12 @@
             
         
         
-            Android Command-line Tools
-            
+            Android Shell Tool Guide
+            
         
 
         
@@ -146,50 +146,57 @@
 
         
             
-                Android Command-line Tools
+                Android Shell Tool Guide
 
-The cordova command-line utility is a high-level tool that allows
-you to build applications across several platforms at once. An older
-version of the Cordova framework provides sets of command-line tools
-specific to each platform. To use them as an alternative to the CLI,
-you need to download this version of Cordova from
+
This guide shows how to use Cordova's set of platform-centered shell
+tools to develop Android apps. This development path, discussed in the
+Overview, may offer you a greater range of development options than
+the cross-platform CLI tool described in The Command-Line Interface.
+For example, you need to use shell tools when deploying a custom
+Cordova WebView alongside native components.  Before using either
+development path, you must first configure the Android SDK environment
+as described in the Android Platform Guide.
+
+To enable shell tools for Android, download Cordova from
 cordova.apache.org. The download contains
-separate archives for each platform. Expand the platform you wish to
-target. The tools described here are typically available in the
-top-level bin directory, otherwise consult the README file for
-more detailed directions.
-
-For information on the low-level command-line interface that enables
-plugins, see Using Plugman to Manage Plugins. See Application Plugins
-for an overview.
+separate archives for each platform. Expand each you wish to target,
+android in this case. The relevant tools are typically available in
+the top-level bin directory, otherwise consult the README file
+for more detailed directions.
+
+These tools allow you to create, build, and run Android apps.  For
+information on the additional command-line interface that enables
+plugin features across all platforms, see Using Plugman to Manage
+Plugins. See Application Plugins for details on how to develop
+plugins.
 
-Create a Project
+Create a Project
 
 Run the create command, specifying the existing path to the project,
 the reverse-domain-style package identifier, and the app's display
 name.  Here is the syntax for both Mac and Windows:
 
-$ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName
-$ C:\path\to\cordova-android\bin\create.bat C:\path\to\project com.example.project_name ProjectName
+    $ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName
+    $ C:\path\to\cordova-android\bin\create.bat C:\path\to\project com.example.project_name ProjectName
 
 
-Build
+Build
 
 This cleans then builds a project.
 
 Debug, on Mac or Windows:
 
-$ /path/to/project/cordova/build --debug
-$ C:\path\to\project\cordova\build.bat --debug
+    $ /path/to/project/cordova/build --debug
+    $ C:\path\to\project\cordova\build.bat --debug
 
 
 Release, on Mac or Windows:
 
-$ /path/to/project/cordova/build --release
-$ C:\path\to\project\cordova\build.bat --release
+    $ /path/to/project/cordova/build --release
+    $ C:\path\to\project\cordova\build.bat --release
 
 
-Run the App
+Run the App
 
 The run command accepts the following optional parameters:
 
@@ -198,8 +205,9 @@ $ C:\path\to\project\cordova\build.bat -
 
 Build specification. This includes --debug, --release, or --nobuild.
 
-$ /path/to/project/cordova/run [Target] [Build]
-$ C:\path\to\project\cordova\run.bat [Target] [Build]
+$ /path/to/project/cordova/run [Target] [Build]
+$ C:\path\to\project\cordova\run.bat [Target] [Build]
+
 
 
 
@@ -209,16 +217,16 @@ AVD is available as a target, you're pro
 default the run command detects a connected device, or a currently
 running emulator if no device is found.
 
-Logging
+Logging
 
-$ /path/to/project/cordova/log
-$ C:\path\to\project\cordova\log.bat
+    $ /path/to/project/cordova/log
+    $ C:\path\to\project\cordova\log.bat
 
 
 Cleaning
 
-$ /path/to/project/cordova/clean
-$ C:\path\to\project\cordova\clean.bat
+    $ /path/to/project/cordova/clean
+    $ C:\path\to\project\cordova\clean.bat
 
 
             


Modified: cordova/site/public/docs/en/edge/guide_platforms_android_webview.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_android_webview.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_android_webview.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_android_webview.md.html Mon Apr 28 19:25:02 2014
@@ -144,7 +144,7 @@
             
                 Android WebViews
 
-This section shows how to embed a Cordova-enabled WebView component
+
This guide shows how to embed a Cordova-enabled WebView component
 within a larger Android application. For details on how these
 components can communicate with each other, see Application Plugins.
 

Modified: cordova/site/public/docs/en/edge/guide_platforms_blackberry10_config.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_blackberry10_config.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_blackberry10_config.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_blackberry10_config.md.html Mon Apr 28 19:25:02 2014
@@ -173,7 +173,7 @@ popups display in a child browser window
 WebSecurity (disable or the default enable): Set to disable
 to override web security settings, allowing access to remote content
 from unknown sources. This preference is intended as a development
-convenience only, so remove it before packaging your app for
+convenience only, so remove it before packaging the app for
 distribution.  For the released app, all URIs should be known and
 whitelisted using the <access> element, described in the Domain
 Whitelist Guide.

Modified: cordova/site/public/docs/en/edge/guide_platforms_blackberry10_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_blackberry10_index.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_blackberry10_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_blackberry10_index.md.html Mon Apr 28 19:25:02 2014
@@ -114,6 +114,7 @@
             BlackBerry 10 Platform Guide
             
-
-
-
-
-
+            BlackBerry 10 Shell Tool Guide
+            
         
 
         
@@ -147,7 +147,7 @@
 
         
             
-                BlackBerry 10 Command-line Tools
+                BlackBerry 10 Shell Tool Guide
 
 The cordova command-line utility is a high-level tool that allows
 you to build applications across several platforms at once. An older
@@ -162,18 +162,18 @@ more detailed directions.
 
 For information on the low-level command-line interface that enables
 plugins, see Using Plugman to Manage Plugins. See Application Plugins
-for an overview.
+for details on how to develop plugins.
 
 If you need help with any command listed below, type the command along
 with the -h or -help arguments, which are supported by all
 commands and which provide descriptions for each of the available
 arguments.
 
-Create an App
+Create an App
 
 The create command creates a new project:
 
-bin/create <path-to-project> <project-package> <project-name>
+    bin/create <path-to-project> <project-package> <project-name>
 
 
 where
@@ -191,15 +191,15 @@ privileges.  If there's problem on OSX/L
 before using the create command. On Windows, run npm install in a
 command-line utility opened with administrator privileges.
 
-Create a Target
+Create a Target
 
 The target command allows you to manage the emulator or BlackBerry
-devices that you use to test your app. You can add or remove a target,
+devices that you use to test the app. You can add or remove a target,
 or set a target as the default target.
 
 Add a Target
 
-<path-to-project>/cordova/target add <name> <ip-address> [-t | --type <device | simulator>] [-p | --password <password>] [--pin <device-pin>]
+    <path-to-project>/cordova/target add <name> <ip-address> [-t | --type <device | simulator>] [-p | --password <password>] [--pin <device-pin>]
 
 
 where
@@ -219,23 +219,23 @@ token.
 
 Remove a Target
 
-<path-to-project>/cordova/target remove <name>
+    <path-to-project>/cordova/target remove <name>
 
 
 Set a Target as the Default
 
-<path-to-project>/cordova/target default <name>
+    <path-to-project>/cordova/target default <name>
 
 
-Build the App
+Build the App
 
 The build command builds the project as a .bar file. You can build
-your app in either release mode (which produces a signed .bar file) or
+the app in either release mode (which produces a signed .bar file) or
 in debug mode (which produces an unsigned .bar file).
 
 Build the App in Release Mode
 
-<path-to-project>/cordova/build release [-k | --keystorepass <password>] [-b | --buildId <number>] [-p | --params <params-JSON-file>]
+    <path-to-project>/cordova/build release [-k | --keystorepass <password>] [-b | --buildId <number>] [-p | --params <params-JSON-file>]
 
 
 where
@@ -248,7 +248,7 @@ in debug mode (which produces an unsigne
 
 Build the Project in Debug Mode
 
-<path-to-project>/cordova/build debug [<target>] [-k | --keystorepass <password>] [-p | --params <params-JSON-file>]  [-ll | --loglevel <error|warn|verbose>]
+    <path-to-project>/cordova/build debug [<target>] [-k | --keystorepass <password>] [-p | --params <params-JSON-file>]  [-ll | --loglevel <error|warn|verbose>]
 
 
 where
@@ -257,7 +257,7 @@ in debug mode (which produces an unsigne
 <target> specifies the name of a previously added target. If
 <target> is not specified, the default target is used, if one has
 been created. This argument is only required if you want the script
-to deploy your app to a BlackBerry device or emulator and you have
+to deploy the app to a BlackBerry device or emulator and you have
 not created a default target. Additionally, if <target> is a
 device, then that device must be connected to your computer by USB
 connection or be connected to the same Wi-Fi network as your
@@ -278,43 +278,43 @@ installed a debug token, if that target 
 can run the script with no arguments, and the script packages your
 app and deploys it to the default target. For example:
 
-<path-to-project>/cordova/build debug
+    <path-to-project>/cordova/build debug
 
 
-Run the App
+Run the App
 
 The run command deploys the app's most recent build on the specified
 BlackBerry device or an emulator. To deploy your app, you need to
 specify a target for the device or emulator:
 
-<path-to-project>/cordova/run <target>
+    <path-to-project>/cordova/run <target>
 
 
 ...where <target>specifies the name of a previously added target.
 If <target> is a device, then it must be connected to your computer
 via USB cable, or else over the same Wi-Fi network as your computer.
 
-Handle Plugins
+Handle Plugins
 
 The target command allows you to add and remove plugins.  To fetch a
 locally hosted plugin:
 
-<path-to-project>/cordova/plugin fetch <path-to-plugin>
+    <path-to-project>/cordova/plugin fetch <path-to-plugin>
 
 
 View a list of installed plugins:
 
-<path-to-project>/cordova/plugin ls
+    <path-to-project>/cordova/plugin ls
 
 
 Add a plugin:
 
-<path-to-project>/cordova/plugin add <name>
+    <path-to-project>/cordova/plugin add <name>
 
 
 Remove a plugin:
 
-<path-to-project>/cordova/plugin rm <name>
+    <path-to-project>/cordova/plugin rm <name>
 
 
             


Modified: cordova/site/public/docs/en/edge/guide_platforms_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_index.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_index.md.html Mon Apr 28 19:25:02 2014
@@ -184,21 +184,22 @@ a lower-level alternative to the c
 
 
 Android Platform Guide
+Android Shell Tool Guide
 Android Configuration
-Android WebViews
 Android Plugins
-Android Command-line Tools
-Upgrading Android
+Android WebViews
+Upgrading Android
 
 
 BlackBerry 10
 
 
 BlackBerry 10 Platform Guide
-BlackBerry 10 Configuration
+BlackBerry 10 Shell Tool Guide
+BlackBerry Configuration
 BlackBerry 10 Plugins
-BlackBerry 10 Command-line Tools
-Upgrading BlackBerry 10
+BlackBerry 10 Command-line Tools
+Upgrading BlackBerry 10
 
 
 Firefox OS
@@ -211,11 +212,11 @@ a lower-level alternative to the c
 
 
 iOS Platform Guide
+iOS Shell Tool Guide
 iOS Configuration
-iOS WebViews
 iOS Plugins
-iOS Command-line Tools
-Upgrading iOS
+iOS WebViews
+Upgrading iOS
 
 
 Ubuntu
@@ -229,14 +230,14 @@ a lower-level alternative to the c
 
 Windows Phone Platform Guide
 Windows Phone Plugins
-Upgrading Windows Phone
+Upgrading Windows Phone
 
 
 Windows 8
 
 
 Windows 8 Platform Guide
-Upgrading Windows 8
+Upgrading Windows 8
 
 
 Tizen

Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_index.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_index.md.html Mon Apr 28 19:25:02 2014
@@ -156,10 +156,10 @@ following for more detailed platform-spe
 
 
 iOS Configuration
-Upgrading iOS
+Upgrading iOS
 iOS WebViews
 iOS Plugins
-iOS Command-line Tools
+iOS Command-line Tools
 
 
 The command-line tools above refer to versions prior to Cordova 3.0.

Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html Mon Apr 28 19:25:02 2014
@@ -378,7 +378,7 @@ example:
 For JavaScript, on iOS 5.0 you can use Weinre, an Apache Cordova
 Project or iWebInspector,
 a third-party utility.  For iOS 6, you
-can attach Safari 6.0 to your app running within the iOS 6 Simulator.
+can attach Safari 6.0 to the app running within the iOS 6 Simulator.
 
 Common Pitfalls
 

Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_tools.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_tools.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_tools.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_tools.md.html Mon Apr 28 19:25:02 2014
@@ -111,13 +111,13 @@
             
         

         
-            iOS Command-line Tools
-            
+            iOS Shell Tool Guide
+            
         
 
         
@@ -147,53 +147,58 @@
 
         
             
-                iOS Command-line Tools
+                iOS Shell Tool Guide
 
-The cordova command-line utility is a high-level tool that allows
-you to build applications across several platforms at once. An older
-version of the Cordova framework provides sets of command-line tools
-specific to each platform. To use them as an alternative to the CLI,
-you need to download this version of Cordova from
+
This guide shows how to use Cordova's set of platform-centered shell
+tools to develop iOS apps. This development path, discussed in the
+Overview, may offer you a greater range of development options for iOS
+than the cross-platform CLI tool described in The Command-Line
+Interface.  For example, you need to use shell tools when deploying a
+custom Cordova WebView alongside native components. Before using
+either development path, you must first configure the SDK environment
+as described in the iOS Platform Guide.  These tools rely upon
+Xcode's command-line tools such as xcode-select and xcodebuild.
+
+To enable shell tools for iOS, download Cordova from
 cordova.apache.org. The download contains
-separate archives for each platform. Expand the platform you wish to
-target. The tools described here are typically available in the
+separate archives for each platform. Expand each you wish to target,
+ios in this case. The relevant tools are typically available in the
 top-level bin directory, otherwise consult the README file for
 more detailed directions.
 
-The iOS command-line tools are built upon shell scripts and rely on
-Xcode command-line tools such as xcode-select and xcodebuild.
-
-For information on the low-level command-line interface that enables
-plugins, see Using Plugman to Manage Plugins. See Application Plugins
-for an overview.
+These tools allow you to create, build, and run iOS apps.  For
+information on the additional command-line interface that enables
+plugin features across all platforms, see Using Plugman to Manage
+Plugins. See Application Plugins for details on how to develop
+plugins.
 
-Create a Project
+Create a Project
 
 Run the create command, specifying the existing path to the project,
 the reverse-domain-style package identifier, and the app's display
 name.
 
-$ ./path/to/cordova-ios/bin/create /path/to/my_new_project com.example.project_name ProjectName
+    $ ./path/to/cordova-ios/bin/create /path/to/my_new_project com.example.project_name ProjectName
 
 
-Build a Project
+Build a Project
 
-$ /path/to/my_new_project/cordova/build
+    $ /path/to/my_new_project/cordova/build
 
 
-Run App on an Emulator
+Run App on an Emulator
 
-$ /path/to/my_new_project/cordova/run
+    $ /path/to/my_new_project/cordova/run
 
 
-Releasing
+Releasing
 
-$ /path/to/my_new_project/cordova/release
+    $ /path/to/my_new_project/cordova/release
 
 
-Logging
+Logging
 
-$ /path/to/my_new_project/cordova/log
+    $ /path/to/my_new_project/cordova/log
 
 
             


Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html Mon Apr 28 19:25:02 2014
@@ -147,7 +147,7 @@
             
                 iOS WebViews
 
-This section shows how to embed a Cordova-enabled WebView component
+
This guide shows how to embed a Cordova-enabled WebView component
 within a larger iOS application. For details on how these components
 can communicate with each other, see Application Plugins.
 

Modified: cordova/site/public/docs/en/edge/guide_platforms_tizen_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_tizen_index.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_tizen_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_tizen_index.md.html Mon Apr 28 19:25:02 2014
@@ -244,7 +244,7 @@ Explorer.
 
 
 Right-click the project in the Project Explorer view, then
-select Run As & rarr; Tizen Web Application:
+select Run As â Tizen Web Application:
 
 
 

Modified: cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html Mon Apr 28 19:25:02 2014
@@ -159,7 +159,7 @@ section also shows how to modify Cordova
 Regardless of which approach you take, you need to install the Visual
 Studio SDK, as described below.
 
-See Upgrading Windows 8 for information on how to upgrade existing
+
See Upgrading Windows 8 for information on how to upgrade existing
 Windows 8 Cordova projects.
 
 Cordova WebViews running on Windows 8 rely on Internet Explorer 10 as
@@ -171,21 +171,29 @@ on how to support IE10 along with compar
 
 
Requirements and Support
 
-You need the following:
+You need one of the following OS/SDK combinations, either from an
+installation disk or an ISO disk image file:
 
 
-A 64-bit version of Windows 8 Pro, either an installation disk or an
-ISO disk image file. An evaluation version is available on the
-Microsoft Developer Network.
+Windows 8.0 or 8.1, 32 or 64-bit Home, Pro, or Enterprise
+editions, along with
+Visual Studio 2012 Express.
+Windows 8.1, 32 or 64-bit Home, Pro, or Enterprise editions,
+along with 
+Visual Studio 2013 Pro
+or higher. An evaluation version of Windows 8.1 Enterprise is
+available from the
+Microsoft Developer Network.
 
 
+Apps compiled under Windows 8.1 do not run under Windows 8.0. Apps
+compiled under Windows 8.0 are forward-compatible with 8.1.
+
   
 
-
-
-Visual Studio, either the
-Ultimate, Premium, or Professional 2013 editions.
-
+Follow the instructions at
+windowsstore.com
+to submit the app to Windows Store.
 
   
 
@@ -282,8 +290,6 @@ next build:
 
 Open the Project in the SDK and Deploy the App
 
-
-
 Once you build a Cordova app as described above, you can open it with
 Visual Studio. The various build commands generate a Visual Studio
 Solution (.sln) file. Open the file in the File Explorer to modify

Modified: cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html Mon Apr 28 19:25:02 2014
@@ -170,7 +170,7 @@ Phone SDK, as described below.
 
 
 Windows Phone Plugins
-Upgrading Windows Phone
+Upgrading Windows Phone
 
 
 For the Windows Phone 8 platform, the Cordova WebView relies on
@@ -189,7 +189,7 @@ on how to support IE10 along with compar
 
A 64-bit version of Windows 8 Pro, either an installation disk or an
 ISO disk image file. An evaluation version is available on the
 Microsoft Developer Network.
-The Pro version is necessary to run the device emulator,
+The Pro version is necessary to run the device emulator.
 The Windows Phone SDK.
 
 
@@ -414,8 +414,8 @@ location or to simulate sequences of mov
 Deploy to Device
 
 Before testing your application on a device, the device must be
-registered. Consult Microsoft's
-documentation.aspx)
+registered. Consult Microsoft's
+documentation
 for details on how to deploy and test on Windows Phone 8. Also, make
 sure the phone is connected to the computer, and the screen is
 unlocked.

Modified: cordova/site/public/docs/en/edge/guide_platforms_wp8_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_wp8_plugin.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_wp8_plugin.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_wp8_plugin.md.html Mon Apr 28 19:25:02 2014
@@ -118,6 +118,7 @@
 
 
 
+
 
 
 
@@ -334,6 +335,18 @@ bad input. This pattern appears througho
     }
 
 
+Plugin Lifetime
+
+Plugins with long-running requests, background activity such as media
+playback, listeners, or that maintain internal state should implement
+the onReset method to clean up those activities. The method runs
+when the CordovaView WebBrowser navigates to a new page or refreshes, which
+reloads the JavaScript.
+
+    // defined in WPCordovaClassLib.Cordova.Commands.BaseCommand
+    public virtual void OnReset() { }
+
+
 Plugin XML
 
 The following shows how to use the plugin.xml file to specify a

Modified: cordova/site/public/docs/en/edge/guide_support_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_support_index.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_support_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_support_index.md.html Mon Apr 28 19:25:02 2014
@@ -223,7 +223,7 @@ CLI's shorthand stubs.)
     
 
     
-        Accelerometer
+        Accelerometer
         
         
         
@@ -237,7 +237,7 @@ CLI's shorthand stubs.)
     
 
     
-        Camera
+        Camera
         
         
         
@@ -251,7 +251,7 @@ CLI's shorthand stubs.)
     
 
     
-        Capture
+        Capture
         
         
         
@@ -265,7 +265,7 @@ CLI's shorthand stubs.)
     
 
     
-        Compass
+        Compass
         
         
         
@@ -279,7 +279,7 @@ CLI's shorthand stubs.)
     
 
     
-        Connection
+        Connection
         
         
         
@@ -293,7 +293,7 @@ CLI's shorthand stubs.)
     
 
     
-        Contacts
+        Contacts
         
         
         
@@ -307,7 +307,7 @@ CLI's shorthand stubs.)
     
 
     
-        Device
+        Device
         
         
         
@@ -335,7 +335,7 @@ CLI's shorthand stubs.)
     
 
     
-        File
+        File
         
         
         
@@ -349,7 +349,7 @@ CLI's shorthand stubs.)
     
 
     
-        Geolocation
+        Geolocation
         
         
         
@@ -363,7 +363,7 @@ CLI's shorthand stubs.)
     
 
     
-        Globalization
+        Globalization
         
         
         
@@ -377,7 +377,7 @@ CLI's shorthand stubs.)
     
 
     
-        InAppBrowser
+        InAppBrowser
         
         
         
@@ -391,7 +391,7 @@ CLI's shorthand stubs.)
     
 
     
-        Media
+        Media
         
         
         
@@ -405,7 +405,7 @@ CLI's shorthand stubs.)
     
 
     
-        Notification
+        Notification
         
         
         
@@ -419,7 +419,7 @@ CLI's shorthand stubs.)
     
 
     
-        Splashscreen
+        Splashscreen
         
         
         

Modified: cordova/site/public/docs/en/edge/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/index.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/index.html (original)
+++ cordova/site/public/docs/en/edge/index.html Mon Apr 28 19:25:02 2014
@@ -168,7 +168,7 @@
         
         
             The config.xml File
-            Customize the features of your app.
+            Customize the app's features.
         
         
             Icons and Splash Screens

Modified: cordova/site/public/docs/en/edge/plugin_ref_plugman.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/plugin_ref_plugman.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/plugin_ref_plugman.md.html (original)
+++ cordova/site/public/docs/en/edge/plugin_ref_plugman.md.html Mon Apr 28 19:25:02 2014
@@ -227,7 +227,7 @@ listed on the plugin specification for more information.
+--variable allows to specify certain variables at install time, necessary for certain plugins requiring API keys or other custom, user-defined parameters. Please see the plugin specification for more information.
 
 
 Remove a Plugin

Modified: cordova/site/public/docs/en/edge/plugin_ref_spec.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/plugin_ref_spec.md.html?rev=1590759&r1=1590758&r2=1590759&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/plugin_ref_spec.md.html (original)
+++ cordova/site/public/docs/en/edge/plugin_ref_spec.md.html Mon Apr 28 19:25:02 2014
@@ -386,7 +386,8 @@ exits with a non-zero code.
 relative to the www directory.
 Assets can be targeted to subdirectories, for example:
 
-
+<asset src="www/new-foo.js" target="js/experimental/foo.js" />
+
 
 creates the js/experimental directory within the www directory,
 unless already present, then copies the new-foo.js file and
@@ -751,7 +752,7 @@ plugman's scope.  Examples:
 <info>
 You need to install __Google Play Services__ from the `Android Extras` section using the Android SDK manager (run `android`).
 
-You need to add the following line to your `local.properties`
+You need to add the following line to the `local.properties`:
 
 android.library.reference.1=PATH_TO_ANDROID_SDK/sdk/extras/google/google_play_services/libproject/google-play-services_lib
 </info>