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/06/12 19:51:13 UTC
[38/46] docs commit: incorporate feedback on tech queries
incorporate feedback on tech queries
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/cf1dce9b
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/cf1dce9b
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/cf1dce9b
Branch: refs/heads/master
Commit: cf1dce9bce921546f3ec97cccfb146244839cb86
Parents: fbc5e1d
Author: Mike Sierra <le...@gmail.com>
Authored: Wed May 22 13:28:17 2013 -0400
Committer: Mike Sierra <le...@gmail.com>
Committed: Wed May 22 13:28:17 2013 -0400
----------------------------------------------------------------------
docs/en/edge/cordova/events/events.offline.md | 6 +++++-
docs/en/edge/cordova/events/events.online.md | 11 ++++++++---
docs/en/edge/cordova/events/events.pause.md | 15 +++++++--------
docs/en/edge/cordova/events/events.resume.md | 5 ++---
.../globalization/globalization.getNumberPattern.md | 1 -
5 files changed, 22 insertions(+), 16 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/cf1dce9b/docs/en/edge/cordova/events/events.offline.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/events/events.offline.md b/docs/en/edge/cordova/events/events.offline.md
index 0a4864a..0f2abe6 100644
--- a/docs/en/edge/cordova/events/events.offline.md
+++ b/docs/en/edge/cordova/events/events.offline.md
@@ -28,7 +28,11 @@ not connected to the Internet.
Details
-------
-The event fires when the network connection is lost.
+The `offline` event fires when a previously connected device loses a
+network connection so that an application can no longer access the
+Internet. It relies on the same information as the Connection API,
+and fires when the `connection.type` changes from `NONE` to any other
+value.
Applications typically should use `document.addEventListener` to
attach an event listener once the Cordova `deviceready` event fires.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/cf1dce9b/docs/en/edge/cordova/events/events.online.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/events/events.online.md b/docs/en/edge/cordova/events/events.online.md
index 549359b..6230f95 100644
--- a/docs/en/edge/cordova/events/events.online.md
+++ b/docs/en/edge/cordova/events/events.online.md
@@ -28,8 +28,10 @@ device becomes connected to the Internet.
Details
-------
-When the application's network connection changes to being online, the
-online event is fired.
+The `online` event fires when a previously unconnected device receives
+a network connection to allow an application access to the Internet.
+It relies on the same information as the Connection API, and fires
+when the value of `connection.type` becomes `NONE`.
Applications typically should use `document.addEventListener` to
attach an event listener once the Cordova `deviceready` event fires.
@@ -93,7 +95,10 @@ Full Example
iOS Quirks
--------------------------
-During initial startup, the first `online` event (if applicable) takes at least a second to fire.
+
+During initial startup, the first `online` event (if applicable) takes
+at least a second to fire, prior to which `connection.type` is
+`UNKNOWN`.
Windows Phone 7 Quirks
--------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/cf1dce9b/docs/en/edge/cordova/events/events.pause.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/events/events.pause.md b/docs/en/edge/cordova/events/events.pause.md
index 6615369..3dc7a33 100644
--- a/docs/en/edge/cordova/events/events.pause.md
+++ b/docs/en/edge/cordova/events/events.pause.md
@@ -27,9 +27,9 @@ The event fires when a Cordova application is put into the background.
Details
-------
-Cordova consists of two code bases: native and JavaScript. When the
-native code puts the application into the background, the `pause` event
-fires.
+The `pause` event fires when the native platform puts the application
+into the background, typically when the user switches to a different
+application.
Applications typically should use `document.addEventListener` to
attach an event listener once the Cordova `deviceready` event fires.
@@ -93,11 +93,10 @@ Full Example
iOS Quirks
--------------------------
-In the `pause` handler, any calls that go through Objective-C do not
-work, nor do any calls that are interactive, such as alerts. You
-can't make calls with `console.log()`, or any calls from plugins or
-the Cordova API. They are only processed when the app resumes, on the
-next run-loop.
+In the `pause` handler, any calls to the Cordova API or to native
+plug-ins that go through Objective-C do not work, along with any
+interactive calls, such as alerts or `console.log()`. They are only
+processed when the app resumes, on the next run loop.
The iOS-specific `resign` event is available as an alternative to
`pause`, and detects when users enable the __Lock__ button to lock the
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/cf1dce9b/docs/en/edge/cordova/events/events.resume.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/events/events.resume.md b/docs/en/edge/cordova/events/events.resume.md
index 2bded1c..d9c99d9 100644
--- a/docs/en/edge/cordova/events/events.resume.md
+++ b/docs/en/edge/cordova/events/events.resume.md
@@ -27,9 +27,8 @@ The event fires when a Cordova application is retrieved from the background.
Details
-------
-Cordova consists of two code bases: native and JavaScript. The
-`resume` event fires when the native code pulls the application from
-the background.
+The `resume` event fires when the native platform pulls the
+application out from the background.
Applications typically should use `document.addEventListener` to
attach an event listener once the Cordova `deviceready` event fires.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/cf1dce9b/docs/en/edge/cordova/globalization/globalization.getNumberPattern.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/globalization/globalization.getNumberPattern.md b/docs/en/edge/cordova/globalization/globalization.getNumberPattern.md
index 8d81f57..f2d1031 100644
--- a/docs/en/edge/cordova/globalization/globalization.getNumberPattern.md
+++ b/docs/en/edge/cordova/globalization/globalization.getNumberPattern.md
@@ -49,7 +49,6 @@ The `options` parameter is optional, and default values are:
The `options.type` can be `decimal`, `percent`, or `currency`.
-
Supported Platforms
-------------------