Return-Path: X-Original-To: apmail-cordova-commits-archive@www.apache.org Delivered-To: apmail-cordova-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 7C9CF10A8C for ; Tue, 17 Dec 2013 20:32:32 +0000 (UTC) Received: (qmail 92646 invoked by uid 500); 17 Dec 2013 20:32:32 -0000 Delivered-To: apmail-cordova-commits-archive@cordova.apache.org Received: (qmail 92623 invoked by uid 500); 17 Dec 2013 20:32:32 -0000 Mailing-List: contact commits-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cordova.apache.org Delivered-To: mailing list commits@cordova.apache.org Received: (qmail 92616 invoked by uid 99); 17 Dec 2013 20:32:32 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 17 Dec 2013 20:32:32 +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; Tue, 17 Dec 2013 20:32:26 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 4FEEF2388C38; Tue, 17 Dec 2013 20:31:43 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1551686 [6/19] - in /cordova/site/public/docs/en: 3.3.0/ edge/ Date: Tue, 17 Dec 2013 20:31:37 -0000 To: commits@cordova.apache.org From: mwbrooks@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20131217203143.4FEEF2388C38@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Modified: cordova/site/public/docs/en/3.3.0/cordova_media_media.md.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.3.0/cordova_media_media.md.html?rev=1551686&r1=1551685&r2=1551686&view=diff ============================================================================== --- cordova/site/public/docs/en/3.3.0/cordova_media_media.md.html (original) +++ cordova/site/public/docs/en/3.3.0/cordova_media_media.md.html Tue Dec 17 20:31:35 2013 @@ -17,16 +17,18 @@ specific language governing permissions and limitations under the License. --> - - - - -Apache Cordova API Documentation - - - - - + + + + + + Apache Cordova API Documentation + + + + + +

Media

@@ -225,9 +228,7 @@ specification for media capture, and is A future implementation will adhere to the latest W3C specification and may deprecate the current APIs.

-

-Parameters -

+

Parameters

  • src: A URI containing the audio content. (DOMString)

    • @@ -235,9 +236,8 @@ and may deprecate the current APIs.

  • mediaError: (Optional) The callback that executes if an error occurs. (Function)

  • mediaStatus: (Optional) The callback that executes to indicate status changes. (Function)

-

-Constants -

+ +

Constants

The following constants are reported as the only parameter to the mediaStatus callback:

@@ -254,9 +254,8 @@ and may deprecate the current APIs.

  • Media.MEDIA_STOPPED = 4;
    • -

    -Methods -

    + +

    Methods

    -

    -Additional ReadOnly Parameters -

    + +

    Additional ReadOnly Parameters

    • @@ -284,9 +282,8 @@ and may deprecate the current APIs.

    • duration: The duration of the media, in seconds.

    -

    -Supported Platforms -

    + +

    Supported Platforms

    • Amazon Fire OS
      • @@ -297,9 +294,8 @@ and may deprecate the current APIs.

    • Tizen
    • Windows 8
    -

    -Accessing the Feature -

    + +

    Accessing the Feature

    As of version 3.0, Cordova implements device-level APIs as plugins. Use the CLI's plugin command, described in The Command-Line @@ -375,18 +371,19 @@ platform-specific configuration settings

    Reference: Application Manifest for Windows Phone

    +

    Some platforms may support this feature without requiring any special configuration. See Platform Support for an overview.

    -

    -Windows Phone Quirks -

    +

    Windows Phone Quirks

    • Only one media file can be played back at a time.

    • There are strict restrictions on how your application interacts with other media. See the Microsoft documentation for details.

    +
    +

    media.getCurrentPosition

    Returns the current position within an audio file.

    @@ -394,25 +391,20 @@ configuration. See media.getCurrentPosition(mediaSuccess, [mediaError]); -

    -Parameters -

    +

    Parameters

    • mediaSuccess: The callback that is passed the current position in seconds.

    • mediaError: (Optional) The callback to execute if an error occurs.

    -

    -Description -

    + +

    Description

    An asynchronous function that returns the current position of the underlying audio file of a Media object. Also updates the Media object's position parameter.

    -

    -Supported Platforms -

    +

    Supported Platforms

    • Android

      • @@ -422,9 +414,8 @@ object's position parameter

    • Tizen

    • Windows 8

    -

    -Quick Example -

    + +

    Quick Example

    // Audio player
 //
@@ -448,9 +439,7 @@ var mediaTimer = setInterval(function ()
 }, 1000);
    -

    -Full Example -

    +

    Full Example

        <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
                   "http://www.w3.org/TR/html4/strict.dtd">
@@ -555,6 +544,7 @@ var mediaTimer = setInterval(function ()
    +

    media.getDuration

    Returns the duration of an audio file.

    @@ -562,17 +552,13 @@ var mediaTimer = setInterval(function () 
    media.getDuration();
    -

    -Description -

    +

    Description

    The media.getDuration method executes synchronously, returning the duration of the audio file in seconds, if known. If the duration is unknown, it returns a value of -1.

    -

    -Supported Platforms -

    +

    Supported Platforms

    • Android
      • @@ -582,9 +568,8 @@ unknown, it returns a value of -1.

    • Tizen
    • Windows 8
    -

    -Quick Example -

    + +

    Quick Example

    // Audio player
 //
@@ -605,9 +590,7 @@ var timerDur = setInterval(function() {
 }, 100);
    -

    -Full Example -

    +

    Full Example

        <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
                           "http://www.w3.org/TR/html4/strict.dtd">
@@ -712,6 +695,7 @@ var timerDur = setInterval(function() {
    +

    media.pause

    Pauses playing an audio file.

    @@ -719,15 +703,11 @@ var timerDur = setInterval(function() { 
    media.pause();
    -

    -Description -

    +

    Description

    The media.pause method executes synchronously, and pauses playing an audio file.

    -

    -Supported Platforms -

    +

    Supported Platforms

    • Android
      • @@ -737,9 +717,8 @@ var timerDur = setInterval(function() {
    • Tizen
    • Windows 8
    -

    -Quick Example -

    + +

    Quick Example

    // Play audio
 //
@@ -762,9 +741,7 @@ function playAudio(url) {
 }
    -

    -Full Example -

    +

    Full Example

        <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
                           "http://www.w3.org/TR/html4/strict.dtd">
@@ -869,6 +846,7 @@ function playAudio(url) {
    +

    media.play

    Starts or resumes playing an audio file.

    @@ -876,16 +854,12 @@ function playAudio(url) { 
    media.play();
    -

    -Description -

    +

    Description

    The media.play method executes synchronously, and starts or resumes playing an audio file.

    -

    -Supported Platforms -

    +

    Supported Platforms

    • Android
      • @@ -895,9 +869,8 @@ playing an audio file.

    • Tizen
    • Windows 8
    -

    -Quick Example -

    + +

    Quick Example

    // Play audio
 //
@@ -918,9 +891,7 @@ function playAudio(url) {
 }
    -

    -Full Example -

    +

    Full Example

        <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
                           "http://www.w3.org/TR/html4/strict.dtd">
@@ -1025,9 +996,7 @@ function playAudio(url) {
     </html>
    -

    -iOS Quirks -

    +

    iOS Quirks

    • @@ -1058,7 +1027,9 @@ myMedia.play() // first looks for file
    +
    +

    media.release

    Releases the underlying operating system's audio resources.

    @@ -1066,9 +1037,7 @@ myMedia.play() // first looks for file 
    media.release();
    -

    -Description -

    +

    Description

    The media.release method executes synchronously, releasing the underlying operating system's audio resources. This is particularly @@ -1076,9 +1045,7 @@ important for Android, since there are a instances for media playback. Applications should call the release function for any Media resource that is no longer needed.

    -

    -Supported Platforms -

    +

    Supported Platforms

    + + - - + + + Modified: cordova/site/public/docs/en/3.3.0/cordova_notification_notification.md.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.3.0/cordova_notification_notification.md.html?rev=1551686&r1=1551685&r2=1551686&view=diff ============================================================================== --- cordova/site/public/docs/en/3.3.0/cordova_notification_notification.md.html (original) +++ cordova/site/public/docs/en/3.3.0/cordova_notification_notification.md.html Tue Dec 17 20:31:35 2013 @@ -17,16 +17,18 @@ specific language governing permissions and limitations under the License. --> - - - - -Apache Cordova API Documentation - - - - - + + + + + + Apache Cordova API Documentation + + + + + +

    Notification

    @@ -180,9 +183,7 @@

    Visual, audible, and tactile device notifications.

    -

    -Methods -

    +

    Methods

    -

    -Accessing the Feature -

    + +

    Accessing the Feature

    As of version 3.0, Cordova implements device-level APIs as plugins. Use the CLI's plugin command, described in The Command-Line @@ -260,10 +260,12 @@ platform-specific configuration settings +

    Some platforms may support this feature without requiring any special configuration. See Platform Support for an overview.

    +

    notification.alert

    Shows a custom alert or dialog box.

    @@ -277,17 +279,14 @@ configuration. See Description - + +

    Description

    Most Cordova implementations use a native dialog box for this feature, but some platforms use the browser's alert function, which is typically less customizable.

    -

    -Supported Platforms -

    +

    Supported Platforms

    • Amazon Fire OS
      • @@ -298,9 +297,8 @@ typically less customizable.

    • Windows Phone 7 and 8
    • Windows 8
    -

    -Quick Example -

    + +

    Quick Example

    // Amazon Fire OS / Android / BlackBerry 10 (OS 5.0 and higher) / iOS / Tizen
 //
@@ -316,9 +314,7 @@ navigator.Full Example
-
+
    Full Example
    
 
 
    <!DOCTYPE html>
 <html>
@@ -362,9 +358,7 @@ navigator.Windows Phone 7 and 8 Quirks
-
+
    Windows Phone 7 and 8 Quirks
    
 
 
      
 
    • 
@@ -375,7 +369,9 @@ navigator.notification.confirm
 
 
      Displays a customizable confirmation dialog box.
      
@@ -389,16 +385,13 @@ navigator.Description
-
+
+
      Description
      
 
 
      The notification.confirm method displays a native dialog box that is
 more customizable than the browser's confirm function.
      
 
-
      
-confirmCallback
-
      
+
      confirmCallback
      
 
 
      The confirmCallback executes when the user presses one of the
 buttons in the confirmation dialog box.
      
@@ -407,9 +400,7 @@ buttons in the confirmation dialog box.<
 index of the pressed button. Note that the index uses one-based
 indexing, so the value is 1, 2, 3, etc.
      
 
-
      
-Supported Platforms
-
      
+
      Supported Platforms
      
 
 
        
 
      • Amazon Fire OS
        • 
@@ -420,9 +411,8 @@ indexing, so the value is 1
 
      • Windows Phone 7 and 8
        • 
 
      • Windows 8
        • 
 
      
-
      
-Quick Example
-
      
+
+
      Quick Example
      
 
 
      // process the confirmation dialog result
 function onConfirm(buttonIndex) {
@@ -441,9 +431,7 @@ function showConfirm() {
 }
 
      
 
-
      
-Full Example
-
      
+
      Full Example
      
 
 
      <!DOCTYPE html>
 <html>
@@ -487,9 +475,7 @@ function showConfirm() {
 </html>
 
      
 
-
      
-Windows Phone 7 and 8 Quirks
-
      
+
      Windows Phone 7 and 8 Quirks
      
 
 
        
 
      • 
@@ -500,7 +486,9 @@ function showConfirm() {
 
        • 
 
      • Calls to alert and confirm are non-blocking, so the result is only available asynchronously.
        • 
 
      
+
 
      
+
 
      notification.prompt
      
 
 
      Shows a customizable prompt dialog box.
      
@@ -515,16 +503,13 @@ function showConfirm() {
 
    • buttonLabels: Array of strings specifying button labels (Array) (Optional, defaults to ["OK","Cancel"])
      • 
 
    • defaultText: Default textbox input value (String) (Optional, Default: empty string)
      • 
 
    
-
    
-Description
-
    
+
+
    Description
    
 
 
    The notification.prompt method displays a native dialog box that is
 more customizable than the browser's prompt function.
    
 
-
    
-promptCallback
-
    
+
    promptCallback
    
 
 
    The promptCallback executes when the user presses one of the buttons
 in the prompt dialog box. The results object passed to the callback
@@ -534,18 +519,16 @@ contains the following properties:
    
 
  • buttonIndex: The index of the pressed button. (Number) Note that the index uses one-based indexing, so the value is 1, 2, 3, etc.
    • 
 
  • input1: The text entered in the prompt dialog box. (String)
    • 
 
-
    
-Supported Platforms
-
    
+
+
    Supported Platforms
    
 
 
      
 
    • Amazon Fire OS
      • 
 
    • Android
      • 
 
    • iOS
      • 
 
    
-
    
-Quick Example
-
    
+
+
    Quick Example
    
 
 
    // process the promp dialog results
 function onPrompt(results) {
@@ -565,9 +548,7 @@ function showPrompt() {
 }
 
    
 
-
    
-Full Example
-
    
+
    Full Example
    
 
 
    <!DOCTYPE html>
 <html>
@@ -612,15 +593,15 @@ function showPrompt() {
 </html>
 
    
 
-
    
-Android Quirks
-
    
+
    Android Quirks
    
 
 
      
 
    • Android supports a maximum of three buttons, and ignores any more than that.
      • 
 
    • On Android 3.0 and later, buttons are displayed in reverse order for devices that use the Holo theme.
      • 
 
    
+
 
    
+
 
    notification.beep
    
 
 
    The device plays a beep sound.
    
@@ -633,9 +614,8 @@ function showPrompt() {
 times: The number of times to repeat the beep. (Number)
 
 
-
    
-Supported Platforms
-
    
+
+
    Supported Platforms
    
 
 
      
 
    • Amazon Fire OS
      • 
@@ -646,17 +626,14 @@ function showPrompt() {
 
    • Windows Phone 7 and 8
      • 
 
    • Windows 8
      • 
 
    
-
    
-Quick Example
-
    
+
+
    Quick Example
    
 
 
    // Beep twice!
 navigator.notification.beep(2);
 
    
 
-
    
-Full Example
-
    
+
    Full Example
    
 
 
    <!DOCTYPE html>
 <html>
@@ -708,36 +685,33 @@ navigator.Amazon Fire OS Quirks
-
+
    Amazon Fire OS Quirks
    
 
 
      
 
    • Amazon Fire OS plays the default Notification Sound specified under the Settings/Display & Sound panel.
      • 
 
    
-
    
-Android Quirks
-
    
+
+
    Android Quirks
    
 
 
      
 
    • Android plays the default Notification ringtone specified under the Settings/Sound & Display panel.
      • 
 
    
-
    
-Windows Phone 7 and 8 Quirks
-
    
+
+
    Windows Phone 7 and 8 Quirks
    
 
 
      
 
    • Relies on a generic beep file from the Cordova distribution.
      • 
 
    
-
    
-Tizen Quirks
-
    
+
+
    Tizen Quirks
    
 
 
      
 
    • Tizen implements beeps by playing an audio file via the media API.
      • 
 
    • The beep file must be short, must be located in a sounds subdirectory of the application's root directory, and must be named beep.wav.
      • 
 
    
+
 
    
+
 
    notification.vibrate
    
 
 
    Vibrates the device for the specified amount of time.
    
@@ -750,9 +724,8 @@ navigator.Supported Platforms
-
+
+
    Supported Platforms
    
 
 
+
 
    Some platforms may support this feature without requiring any special
 configuration.  See Platform Support for an overview.
    
 
 
    See Icons and Splash Screens for information on how to configures these images.
    
 
 
    
+
 
    splashscreen.show
    
 
 
    Displays the splash screen.
    
@@ -229,15 +231,11 @@ configuration.  See navigator.splashscreen.show();
 
    
 
-
    
-Description
-
    
+
    Description
    
 
 
    This method displays the application's splash screen.
    
 
-
    
-Supported Platforms
-
    
+
    Supported Platforms
    
 
 
      
 
    • Amazon Fire OS
      • 
@@ -246,16 +244,13 @@ configuration.  See Quick Example
-
+
+
      Quick Example
      
 
 
      navigator.splashscreen.show();
 
      
 
-
      
-Full Example
-
      
+
      Full Example
      
 
 
      <!DOCTYPE html>
 <html>
@@ -296,6 +291,7 @@ unlikely you need to call navigato
 splash screen visible for app startup.
      
 
 
      
+
 
      splashscreen.hide
      
 
 
      Dismiss the splash screen.
      
@@ -303,15 +299,11 @@ splash screen visible for app startup.navigator.splashscreen.hide();
 
      
 
-
      
-Description
-
      
+
      Description
      
 
 
      This method dismisses the application's splash screen.
      
 
-
      
-Supported Platforms
-
      
+
      Supported Platforms
      
 
 
        
 
      • Amazon Fire OS
        • 
@@ -321,16 +313,13 @@ splash screen visible for app startup.Windows Phone 7 and 8
 
      • Windows 8
        • 
 
      
-
      
-Quick Example
-
      
+
+
      Quick Example
      
 
 
      navigator.splashscreen.hide();
 
      
 
-
      
-Full Example
-
      
+
      Full Example
      
 
 
      <!DOCTYPE html>
 <html>
@@ -358,16 +347,12 @@ splash screen visible for app startup.
      
 
-
      
-BlackBerry 10 Quirk
-
      
+
      BlackBerry 10 Quirk
      
 
 
      The config.xml file's AutoHideSplashScreen setting must be
 false. 
      
 
-
      
-iOS Quirk
-
      
+
      iOS Quirk
      
 
 
      The config.xml file's AutoHideSplashScreen setting must be
 false. To delay hiding the splash screen for two seconds, add a
@@ -382,6 +367,7 @@ timer such as the following in the 
 
         
-        
-
+        
+        
+    
 

Modified: cordova/site/public/docs/en/3.3.0/cordova_storage_storage.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.3.0/cordova_storage_storage.md.html?rev=1551686&r1=1551685&r2=1551686&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.3.0/cordova_storage_storage.md.html (original)
+++ cordova/site/public/docs/en/3.3.0/cordova_storage_storage.md.html Tue Dec 17 20:31:35 2013
@@ -17,16 +17,18 @@
     specific language governing permissions and limitations
     under the License.
 -->
-
-
-
-
-Apache Cordova API Documentation
-
-
-
-
-
+    
+        
+        
+        
+
+        Apache Cordova API Documentation
+
+        
+        
+        
+    
+    
         
      
         
      
             
      Storage
      
@@ -154,9 +157,7 @@ See
 html5rocks.
 for a more complete overview and examples.
      
 
-
      
-LocalStorage
-
      
+
      LocalStorage
      
 
 
      Also known as web storage, simple storage, or by its alternate
 session storage interface, this API provides synchronous key/value
@@ -167,9 +168,7 @@ Refer to WebSQL
-
+
      WebSQL
      
 
 
      This API is available in the underlying WebView.
 The Web SQL Database Specification
@@ -183,9 +182,8 @@ offers more full-featured database table
 
    • iOS
      • 
 
    • Tizen
      • 
 
    
-
    
-IndexedDB
-
    
+
+
    IndexedDB
    
 
 
    This API is available in the underlying WebView.
 Indexed DB offers more features
@@ -197,9 +195,8 @@ than LocalStorage but fewer than WebSQL.
 
  • Windows Phone 8
    • 
 
  • BlackBerry 10
    • 
 
-
    
-Plugin-Based Options
-
    
+
+
    Plugin-Based Options
    
 
 
    In addition to the storage APIs listed above, the File API allows you
 to cache data on the local file system.  Other
@@ -210,6 +207,7 @@ options.
    - - + + + Modified: cordova/site/public/docs/en/3.3.0/guide_appdev_privacy_index.md.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.3.0/guide_appdev_privacy_index.md.html?rev=1551686&r1=1551685&r2=1551686&view=diff ============================================================================== --- cordova/site/public/docs/en/3.3.0/guide_appdev_privacy_index.md.html (original) +++ cordova/site/public/docs/en/3.3.0/guide_appdev_privacy_index.md.html Tue Dec 17 20:31:35 2013 @@ -17,16 +17,18 @@ specific language governing permissions and limitations under the License. --> - - - - -Apache Cordova API Documentation - - - - - + + + + + + Apache Cordova API Documentation + + + + + +

    Privacy Guide

    @@ -217,6 +220,7 @@ it is stored on the device or on your ba also develop an appropriate data retention policy that is implemented within the app and on your backend servers.

    +

    Following are some additional helpful mobile privacy guides for developers:

    -
    + + - - + + + Modified: cordova/site/public/docs/en/3.3.0/guide_appdev_whitelist_index.md.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.3.0/guide_appdev_whitelist_index.md.html?rev=1551686&r1=1551685&r2=1551686&view=diff ============================================================================== --- cordova/site/public/docs/en/3.3.0/guide_appdev_whitelist_index.md.html (original) +++ cordova/site/public/docs/en/3.3.0/guide_appdev_whitelist_index.md.html Tue Dec 17 20:31:35 2013 @@ -17,16 +17,18 @@ specific language governing permissions and limitations under the License. --> - - - - -Apache Cordova API Documentation - - - - - + + + + + + Apache Cordova API Documentation + + + + + +

    Whitelist Guide

    @@ -201,16 +204,13 @@ on each platform.)

    This is the default value for newly created CLI projects.

    -

    -Amazon Fire OS Whitelisting -

    + +

    Amazon Fire OS Whitelisting

    Platform-specific whitelisting rules are found in res/xml/config.xml.

    -

    -Android Whitelisting -

    +

    Android Whitelisting

    Platform-specific whitelisting rules are found in res/xml/config.xml.

    @@ -224,9 +224,7 @@ application.

    page to open in the default browser rather than within the application. (Compare this to iOS's behavior noted below.)

    -

    -iOS Whitelisting -

    +

    iOS Whitelisting

    The platform's whitelisting rules are found in the named application directory's config.xml file.

    @@ -246,9 +244,7 @@ all subdomains and top-level domains suc domains via href hyperlink on iOS prevents the page from opening at all.

    -

    -BlackBerry 10 Whitelisting -

    +

    BlackBerry 10 Whitelisting

    The whitelisting rules are found in www/config.xml.

    @@ -285,12 +281,11 @@ protocol:

    +

    (For more information on support, see BlackBerry's documentation on the access element.)

    -

    -iOS Changes in 3.1.0 -

    +

    iOS Changes in 3.1.0

    Prior to version 3.1.0, Cordova-iOS included some non-standard extensions to the domain whilelisting scheme supported by other Cordova platforms. As of 3.1.0, the iOS whitelist now conforms to the resource whitelist syntax described at the top of this document. If you upgrade from pre-3.1.0, and you were using these extensions, you may have to change your config.xml file in order to continue whitelisting the same set of resources as before.

    @@ -301,16 +296,13 @@ protocol:

  • http://apache.* (wildcard at end of domain): This would previously match all top-level-domains, including all possible two-letter TLDs (but not useful domains like .co.uk). Include a line for each TLD which you actually control, and need to whitelist.

  • h*t*://ap*he.o*g (wildcards for random missing letters): These are no longer supported; change to include a line for each domain and protocol that you actually need to whitelist.

    • -

    -Windows Phone Whitelisting -

    + +

    Windows Phone Whitelisting

    The whitelisting rules for Windows Phone 7 and 8 are found in the app's config.xml file.

    -

    -Tizen Whitelisting -

    +

    Tizen Whitelisting

    Whitelisting rules are found in the app's config.xml file. The platform relies on the same subdomains attribute as the BlackBerry @@ -322,6 +314,7 @@ platform.

    - - + + + Modified: cordova/site/public/docs/en/3.3.0/guide_cli_index.md.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.3.0/guide_cli_index.md.html?rev=1551686&r1=1551685&r2=1551686&view=diff ============================================================================== --- cordova/site/public/docs/en/3.3.0/guide_cli_index.md.html (original) +++ cordova/site/public/docs/en/3.3.0/guide_cli_index.md.html Tue Dec 17 20:31:35 2013 @@ -17,16 +17,18 @@ specific language governing permissions and limitations under the License. --> - - - - -Apache Cordova API Documentation - - - - - + + + + + + Apache Cordova API Documentation + + + + + +

    The Command-Line Interface

    @@ -160,9 +163,7 @@ is the main tool to use for the cross-pl of the various workflows.) However, you can also use the CLI to initialize project code, after which you use various platforms' SDKs and shell tools for continued development.

    -

    -Prerequisites -

    +

    Prerequisites

    Before running any command-line tools, you need to install SDKs for each platform you wish to target. @@ -182,6 +183,7 @@ platform's SDK. The CLI supports the fol

  • Windows 8 (Windows)
  • Firefox OS (Mac, Linux, Windows)
    • +

    On the Mac, the command-line is available via the Terminal application. On the PC, it's available as Command Prompt under Accessories.

    @@ -215,9 +217,8 @@ globally installed npm modules. On Windo /usr/local/share/npm.

    -

    -Create the App -

    + +

    Create the App

    Go to the directory where you maintain your source code, and run a command such as the following:

    @@ -240,9 +241,7 @@ provides your project with a reverse dom HelloWorld provides the application's display text. You can edit both of these values later in the config.xml file.

    -

    -Add Platforms -

    +

    Add Platforms

    All subsequent commands need to be run within the project's directory, or any subdirectories within its scope:

    @@ -315,9 +314,7 @@ then switch to an SDK for native work.Read on if you wish to use the cross-platform workflow approach (the CLI) for the entire development cycle.

    -

    -Build the App -

    +

    Build the App

    By default, the cordova create script generates a skeletal web-based application whose home page is the project's www/index.html file. @@ -349,10 +346,8 @@ an alternative to modify and compile the Cordova generates within platforms/ios. You can use the same approach with other platforms' SDKs.

    -

    -Test the App on an Emulator or Device - -

    +

    Test the App on an Emulator or Device +

    SDKs for mobile platforms often come bundled with emulators that execute a device image, so that you can launch the app from the home @@ -395,9 +390,7 @@ the device, and perhaps add a USB driver environmnent. See Platform Guides for details on each platform's requirements.

    -

    -Add Plugin Features -

    +

    Add Plugin Features

    When you build and view a new project, the default application that appears doesn't do very much. You can modify the app in many ways to @@ -512,6 +505,7 @@ $ cordova plugin add org.apache.cordova. +

    Use plugin ls (or plugin list, or plugin by itself) to view currently installed plugins. Each displays by its identifier:

    @@ -533,9 +527,7 @@ argument for each command:

        $ cordova plugin add org.apache.cordova.console org.apache.cordova.device
    -

    -Advanced Plugin Options -

    +

    Advanced Plugin Options

    When adding a plugin, several options allow you to specify from where to fetch the plugin. The examples above use a well-known @@ -584,9 +576,7 @@ contains the plugin.xml fil 

        $ cordova plugin add ../my_plugin_dir
    -

    -Using merges to Customize Each Platform -

    +

    Using merges to Customize Each Platform

    While Cordova allows you to easily deploy an app for many different platforms, sometimes you need to add customizations. In that case, @@ -621,6 +611,7 @@ example:

     +

    When you rebuild the project, the Android version features the custom font size, while others remain unchanged.

    @@ -631,9 +622,7 @@ graphic into the iOS interface, stored i instead capture backbutton events from the corresponding hardware button.

    -

    -Help Commands -

    +

    Help Commands

    Cordova features a couple of global commands, which may help you if you get stuck or experience a problem. The help command displays @@ -656,9 +645,7 @@ a local info.txt file.

    NOTE: Currently, only details on iOS and Android platforms are available.

    -

    -Updating Cordova and Your Project -

    +

    Updating Cordova and Your Project

    After installing the cordova utility, you can always update it to the latest version by running the following command:

    @@ -703,6 +690,7 @@ you're building:

    - - + + + Modified: cordova/site/public/docs/en/3.3.0/guide_hybrid_plugins_index.md.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.3.0/guide_hybrid_plugins_index.md.html?rev=1551686&r1=1551685&r2=1551686&view=diff ============================================================================== --- cordova/site/public/docs/en/3.3.0/guide_hybrid_plugins_index.md.html (original) +++ cordova/site/public/docs/en/3.3.0/guide_hybrid_plugins_index.md.html Tue Dec 17 20:31:35 2013 @@ -17,16 +17,18 @@ specific language governing permissions and limitations under the License. --> - - - - -Apache Cordova API Documentation - - - - - + + + + + + Apache Cordova API Documentation + + + + + +

    Plugin Development Guide

    @@ -169,9 +172,7 @@ is best to look over existing plugins for guidance.

    -

    -Building a Plugin -

    +

    Building a Plugin

    Application developers use the CLI's plugin add command (discussed in The Command-Line Interface) to apply a plugin to a project. The @@ -218,9 +219,7 @@ the platform-specific config.xmlheader-file and source-file tags specify the path to the library's component files.

    -

    -Validating a Plugin -

    +

    Validating a Plugin

    You can use the plugman utility to check whether the plugin installs correctly for each platform. Install plugman with the following @@ -248,9 +247,7 @@ dependencies load properly:

    For information on how to actually debug plugins, see each platform's native interface listed at the bottom of this page.

    -

    -The JavaScript Interface -

    +

    The JavaScript Interface

    The JavaScript provides the front-facing interface, making it perhaps the most important part of the plugin. You can structure your @@ -283,9 +280,8 @@ guides listed below.

  • [/* arguments */]: An array of arguments to pass into the native environment.

    • -

    -Sample JavaScript -

    + +

    Sample JavaScript

    This example shows one way to implement the plugin's JavaScript interface:

    @@ -316,9 +312,7 @@ callback function window.echo -

    -Native Interfaces -

    +

    Native Interfaces

    Once you define JavaScript for your plugin, you need to complement it with at least one native implementation. Details for each platform are @@ -331,11 +325,10 @@ listed below, and each builds on the sim

  • BlackBerry 10 Plugins
  • Windows Phone Plugins
    • +

    The Tizen platform does not support plugins.

    -

    -Publishing Plugins -

    +

    Publishing Plugins

    Once you develop your plugin, you may want to publish and share it with the community. You can publish your plugin to the cordova @@ -361,6 +354,7 @@ commands.

    - - + + + Modified: cordova/site/public/docs/en/3.3.0/guide_hybrid_webviews_index.md.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.3.0/guide_hybrid_webviews_index.md.html?rev=1551686&r1=1551685&r2=1551686&view=diff ============================================================================== --- cordova/site/public/docs/en/3.3.0/guide_hybrid_webviews_index.md.html (original) +++ cordova/site/public/docs/en/3.3.0/guide_hybrid_webviews_index.md.html Tue Dec 17 20:31:35 2013 @@ -17,16 +17,18 @@ specific language governing permissions and limitations under the License. --> - - - - -Apache Cordova API Documentation - - - - - + + + + + + Apache Cordova API Documentation + + + + + +

    Embedding WebViews

    @@ -157,10 +160,12 @@ supported platforms:

  • Android WebViews
  • iOS WebViews
    • -
    + + - - + + + Modified: cordova/site/public/docs/en/3.3.0/guide_overview_index.md.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.3.0/guide_overview_index.md.html?rev=1551686&r1=1551685&r2=1551686&view=diff ============================================================================== --- cordova/site/public/docs/en/3.3.0/guide_overview_index.md.html (original) +++ cordova/site/public/docs/en/3.3.0/guide_overview_index.md.html Tue Dec 17 20:31:35 2013 @@ -17,16 +17,18 @@ specific language governing permissions and limitations under the License. --> - - - - -Apache Cordova API Documentation - - - - - + + + + + + Apache Cordova API Documentation + + + + + +

    Overview

    @@ -163,9 +166,8 @@ components with a WebView (brow device-level APIs, or if you want to develop a plugin interface between native and WebView components.

    -

    -Basic Components -

    + +

    Basic Components

    Cordova applications rely on a common config.xml file that provides information about the app and specifies parameters affecting how it @@ -188,9 +190,7 @@ hybrid application that mixes the WebVie components. Cordova provides a plugin interface for these components to communicate with each other.

    -

    -Development Paths -

    +

    Development Paths

    As of version 3.0, you can use two basic workflows to create a mobile application. While you can accomplish the same @@ -251,6 +251,7 @@ applications and run them in an SDK-base For comprehensive testing, you can also generate application files and install them directly on a device.

    +

    At any point in the development cycle, you can switch to using more of the Native Platform Dev workflow. The platform-specific SDK tools provided may provide a richer set of options. (See the Platform Guides for details about each platform's SDK tool set.)

    @@ -266,6 +267,7 @@ also build the app's configuration file
    - - + + + Modified: cordova/site/public/docs/en/3.3.0/guide_platforms_amazonfireos_config.md.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.3.0/guide_platforms_amazonfireos_config.md.html?rev=1551686&r1=1551685&r2=1551686&view=diff ============================================================================== --- cordova/site/public/docs/en/3.3.0/guide_platforms_amazonfireos_config.md.html (original) +++ cordova/site/public/docs/en/3.3.0/guide_platforms_amazonfireos_config.md.html Tue Dec 17 20:31:35 2013 @@ -17,16 +17,18 @@ specific language governing permissions and limitations under the License. --> - - - - -Apache Cordova API Documentation - - - - - + + + + + + Apache Cordova API Documentation + + + + + +

    Amazon Fire OS Configuration

    @@ -202,10 +205,12 @@ time the splash screen image displays. -
    + + - - + + +