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/09/21 14:06:32 UTC
[01/50] docs commit: [CB-3820] resolve discrepancy in BB's
orientation values
Updated Branches:
refs/heads/master bfe137067 -> 70a427009
[CB-3820] resolve discrepancy in BB's orientation values
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/cb969a39
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/cb969a39
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/cb969a39
Branch: refs/heads/master
Commit: cb969a397c80928d26291a3cfd782f0554b10969
Parents: d4adac5
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 13 15:20:10 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 13:58:24 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/cb969a39/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 7ed9ae6..fd353b8 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -110,18 +110,10 @@ The following global preferences apply to all platforms:
__NOTE:__ The `default` value means _both_ landscape and portrait
orientations are enabled. If you want to use each platform's
- default settings (usually portrait-only), leave this tag out of
- the `config.xml` file.
-
-<!-- QUERY: BB doc specifies its own "orientation" pref; Does it not recognize "default" as a value? Do no other platforms recognize "auto"?
-
-* `orientation`: (`auto`, `portrait`, or `landscape`) Specifies the
- persistent orientation for screens in your app. By default, if you
- do not specify a screen orientation, the orientation is set to auto.
-
- <preference name="orientation" value="landscape"/>
-
--->
+ default settings (usually portrait-only), leave this tag out of the
+ `config.xml` file. Also, BlackBerry uses `auto` instead of `default`
+ in its `config.xml` file. If you specify `default` in the global
+ `config.xml`, it translates to `auto` in the BlackBerry build.
- `fullscreen` allows you to hide the status bar at the top of the
screen. The default value is `false`. Example:
[39/50] docs commit: [CB-3820] assume exit-on-suspend ios pref is
PGB-only
Posted by mw...@apache.org.
[CB-3820] assume exit-on-suspend ios pref is PGB-only
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/1ea2cb47
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/1ea2cb47
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/1ea2cb47
Branch: refs/heads/master
Commit: 1ea2cb4746799726fff4ba9556a6800e540d580d
Parents: 3b415ec
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:15:41 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:05:05 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 15 ---------------
1 file changed, 15 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/1ea2cb47/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 18c4990..0e7e305 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -102,21 +102,6 @@ File for information on global configuration options.
<preference name="KeyboardShrinksView" value="true"/>
-<!-- QUERY I: Is exit-on-suspend OK?
-
- #### Exit On Suspend
-
-* `exit-on-suspend` with values `true` or `false`
-
- * example: `<preference name="exit-on-suspend" value="true" />`
-
- * if set to true, app will terminate when suspended, for example
- when home button is pressed
-
- * default is _false_
-
--->
-
<!-- QUERY I: Is show-splash-screen-spinner OK?
#### Show Splash Screen Spinner
[35/50] docs commit: [CB-3820] assume prerendered-icon pref is
PGB-only
Posted by mw...@apache.org.
[CB-3820] assume prerendered-icon pref is PGB-only
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/2b97ba36
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/2b97ba36
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/2b97ba36
Branch: refs/heads/master
Commit: 2b97ba36ecf59dee4a9f497ef9323efdeb9ba8bf
Parents: 5ce04a3
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:11:30 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:04:37 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 15 ---------------
1 file changed, 15 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b97ba36/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index d92142c..4e9a44e 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -102,21 +102,6 @@ File for information on global configuration options.
<preference name="KeyboardShrinksView" value="true"/>
-<!-- QUERY I: Is prerendered-icon OK?
-
- #### Prerendered Icon
-
-* `prerendered-icon` with values `true` or `false`
-
- * example: `<preference name="prerendered-icon" value="true" />`
-
- * if icon is prerendered, iOS will not apply it's gloss to the app's
- icon on the user's home screen
-
- * default is _false_
-
--->
-
<!-- QUERY I: Is deprecated stay-in-webview still enabled?
#### Open all links in WebView
[30/50] docs commit: [CB-3820] rm deprecated EnableLocation;
no way to use CLI for workaround
Posted by mw...@apache.org.
[CB-3820] rm deprecated EnableLocation; no way to use CLI for workaround
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/b734df73
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/b734df73
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/b734df73
Branch: refs/heads/master
Commit: b734df736607dafe4322b11c59edd884d41dad91
Parents: 2e51e2a
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:06:15 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:04:02 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 10 ----------
1 file changed, 10 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b734df73/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index f70092d..0aaf71d 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -31,16 +31,6 @@ File for information on global configuration options.
<preference name="TopActivityIndicator" value="white"/>
-* `EnableLocation` (boolean, defaults to `false`): set to `true`, to
- initialize the Geolocation plugin at start-up (so the fix on your
- location can be more accurate) __DEPRECATED__: please set the
- `onload` attribute of the `Geolocation` plugin to `true`
- instead.
-
- <preference name="EnableLocation" value="true"/>
-
-<!-- QUERY I: is deprecated EnableLocation still functional? -->
-
* `EnableViewportScale` (boolean, defaults to `false`): set to `true` to
prevent viewport scaling through a meta tag.
[22/50] docs commit: [CB-3820] tighten up childBrowser text
Posted by mw...@apache.org.
[CB-3820] tighten up childBrowser text
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/3b2600a3
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/3b2600a3
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/3b2600a3
Branch: refs/heads/master
Commit: 3b2600a3b8552b0d7aa34307711981f8af821667
Parents: ef59b1c
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 15:21:00 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:02:59 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/blackberry10/config.md | 10 ++++------
1 file changed, 4 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3b2600a3/docs/en/edge/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/blackberry10/config.md b/docs/en/edge/guide/platforms/blackberry10/config.md
index 295231d..f1b5c0f 100644
--- a/docs/en/edge/guide/platforms/blackberry10/config.md
+++ b/docs/en/edge/guide/platforms/blackberry10/config.md
@@ -24,12 +24,10 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to BlackBerry 10 builds. See The
config.xml File for information on global configuration options.
-* `ChildBrowser`: Disables child browser windows. By default, when the
- content attempts to open a resource in a new window or tab (by using
- window.open(), or by specifying `_blank` as the target of an
- anchor), the WebWorks app will open a secondary browser window to
- display the resource. This feature is enabled by default. The value
- must specify `disable` to prevent the above actions from occuring.
+* `ChildBrowser`: Disables child browser windows. By default, apps
+ launch a secondary browser window to display resources accessed via
+ `window.open()` or by specifying a `_blank` anchor target. Specify
+ `disable` to override this default behavior.
<preference name="childBrowser" value="disable"/>
[04/50] docs commit: strip potentially buggy nested XML comments
Posted by mw...@apache.org.
strip potentially buggy nested XML comments
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/11627d85
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/11627d85
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/11627d85
Branch: refs/heads/master
Commit: 11627d85dc08576f78d4687f1677ba9a90591e2a
Parents: d151efa
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 13 15:37:20 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 13:59:50 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/11627d85/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index b7f099d..70375e3 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -308,12 +308,12 @@ Currently supported through this interface are the following feature names:
#### Usage
- <!-- If you do not want any permissions to be added to your app, add the
+ If you do not want any permissions to be added to your app, add the
following tag to your config.xml; you will still have the INTERNET
- permission on your app, which PhoneGap requires. -->
+ permission on your app, which PhoneGap requires.
<preference name="permissions" value="none"/>
- <!-- to enable individual permissions use the following examples -->
+ to enable individual permissions use the following examples
<feature name="http://api.phonegap.com/1.0/battery"/>
<feature name="http://api.phonegap.com/1.0/camera"/>
<feature name="http://api.phonegap.com/1.0/contacts"/>
[49/50] docs commit: [CB-3820] tighten up text for iOS prefs
Posted by mw...@apache.org.
[CB-3820] tighten up text for iOS prefs
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/0c22d9b0
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/0c22d9b0
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/0c22d9b0
Branch: refs/heads/master
Commit: 0c22d9b0bd919a07ddddbc79d29bcbeb38b6d6b6
Parents: 7a976bd
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 12:32:56 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:06:13 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 58 ++++++++++++-------------
1 file changed, 28 insertions(+), 30 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/0c22d9b0/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index ff94995..c0197a3 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -37,62 +37,60 @@ File for information on global configuration options.
<preference name="EnableViewportScale" value="true"/>
-* `FadeSplashScreen` (boolean, defaults to `true`): set to `false` to
- prevent the splash-screen to fade in and out when showing or hiding
- it.
+* `FadeSplashScreen` (boolean, defaults to `true`): Set to `false` to
+ prevent the splash screen from fading in and out when its display
+ state changes.
<preference name="FadeSplashScreen" value="false"/>
-* `FadeSplashScreenDuration` (float, defaults to 2): The splash-screen
- Fade duration in seconds.
+* `FadeSplashScreenDuration` (float, defaults to `2`): Specifies the
+ number of seconds for the splash screen fade effect to execute.
<preference name="FadeSplashScreenDuration" value="4"/>
-* `ShowSplashScreenSpinner` (boolean, defaults to `true`): set to `false`
+* `ShowSplashScreenSpinner` (boolean, defaults to `true`): Set to `false`
to hide the splash-screen spinner.
<preference name="ShowSplashScreenSpinner" value="false"/>
-* `MediaPlaybackRequiresUserAction` (boolean, defaults to `false`): set
- to `true` to not allow autoplayed HTML5 video.
+* `MediaPlaybackRequiresUserAction` (boolean, defaults to `false`):
+ Set to `true` to prevent HTML5 videos from playing automatically
+ with the `autoplay` attribute. Does not apply when calling `play()`
+ on a video object.
<preference name="MediaPlaybackRequiresUserAction" value="true"/>
-* `AllowInlineMediaPlayback` (boolean, defaults to `false`): set to
- `true` to allow inline HTML5 media playback, also, the video element
- in the HTML document must also include the webkit-playsinline
- attribute.
+* `AllowInlineMediaPlayback` (boolean, defaults to `false`): Set to
+ `true` to allow HTML5 media playback to appear _inline_ within the
+ screen layout, using browser-supplied controls rather than native
+ controls. For this to work, add the `webkit-playsinline` attribute
+ to any `<video>` elements.
<preference name="AllowInlineMediaPlayback" value="true"/>
-* `BackupWebStorage` (string, defaults to `cloud`): valid values are
- `none`, `cloud` and `local`. Set to `cloud` to allow the web
- storage data to be backed up to iCloud, and set to `local` to only
- allow local backups (iTunes sync). Set to `none` to not allow any
- backups of web storage.
+* `BackupWebStorage` (string, either `none`, `local`, or the default
+ `cloud`): Set to `cloud` to allow web storage data to backup via
+ iCloud. Set to `local` to allow only local backups via iTunes
+ sync. Set to `none` prevent web storage backups.
<preference name="BackupWebStorage" value="local"/>
* `KeyboardDisplayRequiresUserAction` (boolean, defaults to `true`):
- set to `false` to open the keyboard when form elements get focus via
- the JavaScript focus() call.
+ Set to `false` to allow the keyboard to appear when calling
+ `focus()` on form inputs.
<preference name="KeyboardDisplayRequiresUserAction" value="false"/>
-* `SuppressesIncrementalRendering` (boolean, defaults to `false`): set
- to `true` to wait until all new view content has been received
- before it is rendered.
+* `SuppressesIncrementalRendering` (boolean, defaults to `false`): Set
+ to `true` to wait until all content has been received before it
+ renders to the screen.
<preference name="SuppressesIncrementalRendering" value="true"/>
-* `KeyboardShrinksView` (boolean, defaults to `false`): set to `true` to
- shrink the WebView when the keyboard comes up. The WebView shrinks
- instead of the viewport shrinking and the page scrollable. This
- applies to apps that position their elements relative to the bottom
- of the WebView. This is the default behaviour on Android, and makes
- a lot of sense when building apps as opposed to webpages.
+* `KeyboardShrinksView` (boolean, defaults to `false`): Set to `true`
+ to scale down the webview when the keyboard appears, overriding the
+ default beavior that shrinks the viewport vertically. This matches
+ the default behaviour for Android apps.
<preference name="KeyboardShrinksView" value="true"/>
-
-
[50/50] docs commit: [CB-3820] sort pref listings by importance
Posted by mw...@apache.org.
[CB-3820] sort pref listings by importance
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/70a42700
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/70a42700
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/70a42700
Branch: refs/heads/master
Commit: 70a4270093d64c7897a9ba2499ca96306c356a4f
Parents: 0c22d9b
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 12:37:10 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:06:19 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 16 +++---
docs/en/edge/guide/platforms/android/config.md | 36 ++++++------
.../edge/guide/platforms/blackberry10/config.md | 6 +-
docs/en/edge/guide/platforms/ios/config.md | 60 ++++++++++----------
4 files changed, 59 insertions(+), 59 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/70a42700/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 99f1c4a..eab4545 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -95,6 +95,11 @@ platforms:
The following global preferences apply to all platforms:
+- `Fullscreen` allows you to hide the status bar at the top of the
+ screen. The default value is `false`. Example:
+
+ <preference name="Fullscreen" value="true" />
+
- `Orientation` allows you to lock orientation and prevent the
interface from rotating in response to changes in orientation.
Possible values are `default`, `landscape`, or `portrait`. Example:
@@ -108,17 +113,12 @@ The following global preferences apply to all platforms:
in its `config.xml` file. If you specify `default` in the global
`config.xml`, it translates to `auto` in the BlackBerry build.
-- `Fullscreen` allows you to hide the status bar at the top of the
- screen. The default value is `false`. Example:
-
- <preference name="Fullscreen" value="true" />
-
## Multi-platform Preferences
The following preferences apply to more than one platform, but not to
all of them:
-* `DisallowOverscroll` (boolean, defaults to `false`): set to `true`
+- `DisallowOverscroll` (boolean, defaults to `false`): set to `true`
if you don't want the interface to display any feedback when users
scroll past the beginning or end of content.
@@ -129,7 +129,7 @@ all of them:
produce a more subtle glowing effect along the top or bottom edge of
the content.
-* `BackgroundColor`: Set the app's background color. Supports a
+- `BackgroundColor`: Set the app's background color. Supports a
four-byte hex value, with the first byte representing the alpha
channel, and standard RGB values for the following three bytes. This
example specifies blue:
@@ -139,7 +139,7 @@ all of them:
Applies to Android and BlackBerry. Overrides CSS otherwise available
across _all_ platforms, for example: `body{background-color:blue}`.
-* `HideKeyboardFormAccessoryBar` (boolean, defaults to `false`): set
+- `HideKeyboardFormAccessoryBar` (boolean, defaults to `false`): set
to `true` to hide the additional toolbar that appears above the
keyboard, helping users navigate from one form input to another.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/70a42700/docs/en/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/config.md b/docs/en/edge/guide/platforms/android/config.md
index 61ae1a6..f30886c 100644
--- a/docs/en/edge/guide/platforms/android/config.md
+++ b/docs/en/edge/guide/platforms/android/config.md
@@ -24,42 +24,42 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to Android builds. See The
config.xml File for information on global configuration options.
-* `LoadingDialog`: Display a native dialog when loading the app. The
- value's format is _Title, Message_
-
- <preference name="LoadingDialog" value="Please wait, the app is loading"/>
-
-* `LoadingPageDialog`: Display a native dialog when loading sub-pages
- within an app. The value's format is _Title, Message_
+- `KeepRunning` (boolean, defaults to `true`): Determines whether the
+ application stays running in the background even after a `pause`
+ event fires.
- <preference name="LoadingPageDialog" value="Please wait, the data is loading"/>
+ <preference name="KeepRunning" value="false"/>
-* `ErrorUrl`: Specifies an error page that displays in response to
+- `ErrorUrl`: Specifies an error page that displays in response to
standard HTTP errors in the 400-500 range. Place the specified file
in the top-level directory containing the home page and other web
assets.
<preference name="ErrorUrl" value="error.html"/>
-* `LoadUrlTimeoutValue` (number, default is `20000`): When loading a
+- `LoadingDialog`: Display a native dialog when loading the app. The
+ value's format is _Title, Message_
+
+ <preference name="LoadingDialog" value="Please wait, the app is loading"/>
+
+- `LoadingPageDialog`: Display a native dialog when loading sub-pages
+ within an app. The value's format is _Title, Message_
+
+ <preference name="LoadingPageDialog" value="Please wait, the data is loading"/>
+
+- `LoadUrlTimeoutValue` (number, default is `20000`): When loading a
page, the amount of time to wait before throwing a timeout error.
This example specifies 10 seconds rather than 20:
<preference name="LoadUrlTimeoutValue" value="10000"/>
-* `KeepRunning` (boolean, defaults to `true`): Determines whether the
- application stays running in the background even after a `pause`
- event fires.
-
- <preference name="KeepRunning" value="false"/>
-
-* `SplashScreen`: The name of the file minus its extension in the
+- `SplashScreen`: The name of the file minus its extension in the
`res/drawable` directory. Various assets must share this common
name in various subdirectories.
<preference name="SplashScreen" value="splash"/>
-* `SplashScreenDelay` (number, defaults to `5000`): The amount of
+- `SplashScreenDelay` (number, defaults to `5000`): The amount of
time the splash screen image displays.
<preference name="SplashScreenDelay" value="10000"/>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/70a42700/docs/en/edge/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/blackberry10/config.md b/docs/en/edge/guide/platforms/blackberry10/config.md
index 8abaffe..61b1a09 100644
--- a/docs/en/edge/guide/platforms/blackberry10/config.md
+++ b/docs/en/edge/guide/platforms/blackberry10/config.md
@@ -24,7 +24,7 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to BlackBerry 10 builds. See The
config.xml File for information on global configuration options.
-* `ChildBrowser` (`disable` or the default `enable`): Disables child
+- `ChildBrowser` (`disable` or the default `enable`): Disables child
browser windows. By default, apps launch a secondary browser window
to display resources accessed via `window.open()` or by specifying a
`_blank` anchor target. Specify `disable` to override this default
@@ -32,14 +32,14 @@ config.xml File for information on global configuration options.
<preference name="ChildBrowser" value="disable"/>
-* `PopupBlocker` (`enable` or the default `disable`): Enables the
+- `PopupBlocker` (`enable` or the default `disable`): Enables the
popup blocker, which prevents calls to `window.open()`. By default,
popups display in a child browser window. Setting the preference to
`enable` prevents it from displaying at all.
<preference name="PopupBlocker" value="enable"/>
-* `WebSecurity` (`disable` or the default `enable`): Set to `disable`
+- `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
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/70a42700/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index c0197a3..8b70c75 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -24,43 +24,20 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to iOS builds. See The config.xml
File for information on global configuration options.
-* `TopActivityIndicator` (string, defaults to `gray`): Controls the
- appearance of the small spinning icon in the status bar that
- indicates significant processor activity. Valid values are
- `whiteLarge`, `white`, and `gray`.
-
- <preference name="TopActivityIndicator" value="white"/>
-
-* `EnableViewportScale` (boolean, defaults to `false`): Set to `true`
+- `EnableViewportScale` (boolean, defaults to `false`): Set to `true`
to use a viewport meta tag to either disable or restrict the range
of user scaling.
<preference name="EnableViewportScale" value="true"/>
-* `FadeSplashScreen` (boolean, defaults to `true`): Set to `false` to
- prevent the splash screen from fading in and out when its display
- state changes.
-
- <preference name="FadeSplashScreen" value="false"/>
-
-* `FadeSplashScreenDuration` (float, defaults to `2`): Specifies the
- number of seconds for the splash screen fade effect to execute.
-
- <preference name="FadeSplashScreenDuration" value="4"/>
-
-* `ShowSplashScreenSpinner` (boolean, defaults to `true`): Set to `false`
- to hide the splash-screen spinner.
-
- <preference name="ShowSplashScreenSpinner" value="false"/>
-
-* `MediaPlaybackRequiresUserAction` (boolean, defaults to `false`):
+- `MediaPlaybackRequiresUserAction` (boolean, defaults to `false`):
Set to `true` to prevent HTML5 videos from playing automatically
with the `autoplay` attribute. Does not apply when calling `play()`
on a video object.
<preference name="MediaPlaybackRequiresUserAction" value="true"/>
-* `AllowInlineMediaPlayback` (boolean, defaults to `false`): Set to
+- `AllowInlineMediaPlayback` (boolean, defaults to `false`): Set to
`true` to allow HTML5 media playback to appear _inline_ within the
screen layout, using browser-supplied controls rather than native
controls. For this to work, add the `webkit-playsinline` attribute
@@ -68,26 +45,49 @@ File for information on global configuration options.
<preference name="AllowInlineMediaPlayback" value="true"/>
-* `BackupWebStorage` (string, either `none`, `local`, or the default
+- `BackupWebStorage` (string, either `none`, `local`, or the default
`cloud`): Set to `cloud` to allow web storage data to backup via
iCloud. Set to `local` to allow only local backups via iTunes
sync. Set to `none` prevent web storage backups.
<preference name="BackupWebStorage" value="local"/>
-* `KeyboardDisplayRequiresUserAction` (boolean, defaults to `true`):
+- `TopActivityIndicator` (string, defaults to `gray`): Controls the
+ appearance of the small spinning icon in the status bar that
+ indicates significant processor activity. Valid values are
+ `whiteLarge`, `white`, and `gray`.
+
+ <preference name="TopActivityIndicator" value="white"/>
+
+- `FadeSplashScreen` (boolean, defaults to `true`): Set to `false` to
+ prevent the splash screen from fading in and out when its display
+ state changes.
+
+ <preference name="FadeSplashScreen" value="false"/>
+
+- `FadeSplashScreenDuration` (float, defaults to `2`): Specifies the
+ number of seconds for the splash screen fade effect to execute.
+
+ <preference name="FadeSplashScreenDuration" value="4"/>
+
+- `ShowSplashScreenSpinner` (boolean, defaults to `true`): Set to `false`
+ to hide the splash-screen spinner.
+
+ <preference name="ShowSplashScreenSpinner" value="false"/>
+
+- `KeyboardDisplayRequiresUserAction` (boolean, defaults to `true`):
Set to `false` to allow the keyboard to appear when calling
`focus()` on form inputs.
<preference name="KeyboardDisplayRequiresUserAction" value="false"/>
-* `SuppressesIncrementalRendering` (boolean, defaults to `false`): Set
+- `SuppressesIncrementalRendering` (boolean, defaults to `false`): Set
to `true` to wait until all content has been received before it
renders to the screen.
<preference name="SuppressesIncrementalRendering" value="true"/>
-* `KeyboardShrinksView` (boolean, defaults to `false`): Set to `true`
+- `KeyboardShrinksView` (boolean, defaults to `false`): Set to `true`
to scale down the webview when the keyboard appears, overriding the
default beavior that shrinks the viewport vertically. This matches
the default behaviour for Android apps.
[19/50] docs commit: [CB-3820] describe effect DisallowOverscroll
prevents
Posted by mw...@apache.org.
[CB-3820] describe effect DisallowOverscroll prevents
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/087cabc4
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/087cabc4
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/087cabc4
Branch: refs/heads/master
Commit: 087cabc44a8ab0abaf0d81a261b46b0082e32d82
Parents: d23e039
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 13:19:05 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:02:35 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 9 ++++++---
1 file changed, 6 insertions(+), 3 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/087cabc4/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 98c71e4..fb6dc19 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -115,12 +115,15 @@ The following preferences apply to more than one platform, but not to
all of them:
* `DisallowOverscroll` (boolean, defaults to `false`): set to `true`
- if you don't want the WebView to bounce and snap back when scrolling
- past the beginning or end of the content.
+ if you don't want the interface to display any feedback when users
+ scroll past the beginning or end of content.
<preference name="DisallowOverscroll" value="true"/>
- Applies to Android and iOS.
+ Applies to Android and iOS. On iOS, overscroll gestures cause
+ content to bounce back to its original position. On Android, they
+ produce a more subtle glowing effect along the top or bottom edge of
+ the content.
* `BackgroundColor`: Set the app's background color. Supports a
four-byte hex value, with the first byte representing an alpha
[25/50] docs commit: [CB-3820] different set of
HideKeyboardFormAccessoryBar values for BB
Posted by mw...@apache.org.
[CB-3820] different set of HideKeyboardFormAccessoryBar values for BB
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/ac9f67d5
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/ac9f67d5
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/ac9f67d5
Branch: refs/heads/master
Commit: ac9f67d50346dc43ca93ae3cb0d3bc3aab6d3b3a
Parents: 914ea8f
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 15:30:27 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:03:24 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 8 ++------
1 file changed, 2 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ac9f67d5/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index fdd0739..2a47b43 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -140,13 +140,9 @@ all of them:
<preference name="HideKeyboardFormAccessoryBar" value="true"/>
- Applies to iOS and BlackBerry.
+ Applies to iOS and BlackBerry.
-<!-- BB version:
-
-* `HideKeyboardFormAccessoryBar`: (`enable` or `disable`)
-
--->
+ __NOTE:__ For BlackBerry, valid values are `enable` or `disable`.
## The `<feature>` Element
[16/50] docs commit: [CB-3820] clarify when ErrorUrl applies
Posted by mw...@apache.org.
[CB-3820] clarify when ErrorUrl applies
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/71d49e67
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/71d49e67
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/71d49e67
Branch: refs/heads/master
Commit: 71d49e67a3e37efb6dd6ab853546a5309e9525ae
Parents: 46c6deb
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 13:04:36 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:02:12 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/config.md | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/71d49e67/docs/en/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/config.md b/docs/en/edge/guide/platforms/android/config.md
index 91e3aea..8663ed8 100644
--- a/docs/en/edge/guide/platforms/android/config.md
+++ b/docs/en/edge/guide/platforms/android/config.md
@@ -34,13 +34,13 @@ config.xml File for information on global configuration options.
<preference name="LoadingPageDialog" value="Please wait, the data is loading"/>
-* `ErrorUrl`: Set the error page for your application. Should be
- located in your Android project in `file://android_asset/www/`
+* `ErrorUrl`: Specifies an error page that displays in response to
+ standard HTTP errors in the 400-500 range. The specified file needs
+ to be placed in the top-level directory containing the home page and
+ other web assets.
<preference name="ErrorUrl" value="error.html"/>
-<!-- QUERY A: under what conditions does the errorUrl page display? -->
-
* `LoadUrlTimeoutValue`: How much time Cordova should wait before
throwing a timeout error on the application.
[08/50] docs commit: [CB-3820] function of TopActivityIndicator is
now clear
Posted by mw...@apache.org.
[CB-3820] function of TopActivityIndicator is now clear
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/26e0f82a
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/26e0f82a
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/26e0f82a
Branch: refs/heads/master
Commit: 26e0f82a81ffde6e870b916803203af1a6f99ce4
Parents: 2d8e805
Author: Mike Sierra <ms...@adobe.com>
Authored: Wed Sep 18 12:32:08 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:00:24 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 9 ++++-----
1 file changed, 4 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/26e0f82a/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 58797a2..1858833 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -53,14 +53,13 @@ following defines splash screens for each type of screen:
## iOS Preferences
-* `TopActivityIndicator` (string, defaults to `gray`): this is the top
- spinning throbber in the status/battery bar, valid values are
- `whiteLarge`, `white`, and `gray`.
+* `TopActivityIndicator` (string, defaults to `gray`): controls the
+ appearance of the small spinning icon that appears in the
+ status/battery bar to indicate a demanding process is executing.
+ Valid values are `whiteLarge`, `white`, and `gray`.
<preference name="TopActivityIndicator" value="white"/>
-<!-- QUERY I: describe TopActivityIndicator top spinning throbber -->
-
* `EnableLocation` (boolean, defaults to `false`): set to `true`, to
initialize the Geolocation plugin at start-up (so the fix on your
location can be more accurate) __DEPRECATED__: please set the
[09/50] docs commit: [CB-3820] clarify
MediaPlaybackRequiresUserAction's effective scope
Posted by mw...@apache.org.
[CB-3820] clarify MediaPlaybackRequiresUserAction's effective scope
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/ab7ecda7
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/ab7ecda7
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/ab7ecda7
Branch: refs/heads/master
Commit: ab7ecda7919538307d06c9df09fd4ec20e924ba6
Parents: 26e0f82
Author: Mike Sierra <ms...@adobe.com>
Authored: Wed Sep 18 12:37:07 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:00:34 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ab7ecda7/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 1858833..3f6ac4b 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -102,8 +102,9 @@ following defines splash screens for each type of screen:
<!-- QUERY I: for ShowSplashScreenSpinner describe spinner -->
-* `MediaPlaybackRequiresUserAction` (boolean, defaults to `false`): set
- to `true` to not allow autoplayed HTML5 video.
+* `MediaPlaybackRequiresUserAction` (boolean, defaults to `false`):
+ set to `true` to prevent HTML5 video from playing automatically with
+ the `autoplay` attribute.
<preference name="MediaPlaybackRequiresUserAction" value="true"/>
[34/50] docs commit: [CB-3820] assume webviewbounce pref is PGB-only;
superseded in CV by DisallowOverscroll
Posted by mw...@apache.org.
[CB-3820] assume webviewbounce pref is PGB-only; superseded in CV by DisallowOverscroll
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/5ce04a3e
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/5ce04a3e
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/5ce04a3e
Branch: refs/heads/master
Commit: 5ce04a3e63bb60e6c2ca45bd7b1bed710b11af9b
Parents: 3b97a02
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:11:00 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:04:30 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 15 ---------------
1 file changed, 15 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5ce04a3e/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index b610c9f..d92142c 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -102,21 +102,6 @@ File for information on global configuration options.
<preference name="KeyboardShrinksView" value="true"/>
-<!-- QUERY I: Is webviewbounce OK?
-
- #### WebView Bounce
-
-* `webviewbounce` with values `true` or `false`
-
- <preference name="webviewbounce" value="fubar"/>
-
- * example: `<preference name="webviewbounce" value="false" />`
-
- * controls whether the screen "bounces" when scrolled beyond the top
- or bottom on iOS. By default, the bounce is _on_
-
--->
-
<!-- QUERY I: Is prerendered-icon OK?
#### Prerendered Icon
[27/50] docs commit: [CB-3820] minor config.xml edits
Posted by mw...@apache.org.
[CB-3820] minor config.xml edits
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/dd96e2b6
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/dd96e2b6
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/dd96e2b6
Branch: refs/heads/master
Commit: dd96e2b65e1495987a480a3034cad8362576236a
Parents: 14db3bf
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 15:45:02 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:03:38 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 19 ++++++++++---------
1 file changed, 10 insertions(+), 9 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/dd96e2b6/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 38b3751..194a409 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -50,18 +50,19 @@ File for information on global configuration options.
<!-- QUERY: Do viewport meta tags work as expected in other environments? -->
-* `AutoHideSplashScreen` (boolean, defaults to `true`): set to `false` to
- control when the splashscreen is hidden through a JavaScript API.
+* `AutoHideSplashScreen` (boolean, defaults to `true`): set to `false`
+ to use the SplashScreen API to control when the opening image stops
+ displaying.
<preference name="AutoHideSplashScreen" value="false"/>
* `FadeSplashScreen` (boolean, defaults to `true`): set to `false` to
- prevent the splash-screen to fade in and out when showing or hiding
- it.
+ prevent the splash-screen from fading in or out when showing or
+ hiding it.
<preference name="FadeSplashScreen" value="false"/>
-* `FadeSplashScreenDuration` (float, defaults to 2): The splash-screen
+* `FadeSplashScreenDuration` (float, defaults to `2`): The splash-screen
Fade duration in seconds.
<preference name="FadeSplashScreenDuration" value="4"/>
@@ -98,21 +99,21 @@ File for information on global configuration options.
* `KeyboardDisplayRequiresUserAction` (boolean, defaults to `true`):
set to `false` to open the keyboard when form elements get focus via
- the JavaScript focus() call.
+ the JavaScript `focus()` call.
<preference name="KeyboardDisplayRequiresUserAction" value="false"/>
* `SuppressesIncrementalRendering` (boolean, defaults to `false`): set
to `true` to wait until all new view content has been received
- before it is rendered.
+ before it renders.
<preference name="SuppressesIncrementalRendering" value="true"/>
* `KeyboardShrinksView` (boolean, defaults to `false`): set to `true` to
- shrink the WebView when the keyboard comes up. The WebView shrinks
+ shrink the webview when the keyboard comes up. The webview shrinks
instead of the viewport shrinking and the page scrollable. This
applies to apps that position their elements relative to the bottom
- of the WebView. This is the default behaviour on Android, and makes
+ of the webview. This is the default behaviour on Android, and makes
a lot of sense when building apps as opposed to webpages.
<preference name="KeyboardShrinksView" value="true"/>
[29/50] docs commit: [CB-3820] clarify KeyboardShrinksView;
autoplay no longer an issue
Posted by mw...@apache.org.
[CB-3820] clarify KeyboardShrinksView; autoplay no longer an issue
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/2e51e2a4
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/2e51e2a4
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/2e51e2a4
Branch: refs/heads/master
Commit: 2e51e2a490d4656c6909710e12d2b7ad5fa11320
Parents: 6682f62
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:05:03 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:03:55 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 15 +++++----------
1 file changed, 5 insertions(+), 10 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2e51e2a4/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 194a409..f70092d 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -80,8 +80,6 @@ File for information on global configuration options.
<preference name="MediaPlaybackRequiresUserAction" value="true"/>
-<!-- QUERY I: does MediaPlaybackRequiresUserAction also apply to audio? -->
-
* `AllowInlineMediaPlayback` (boolean, defaults to `false`): set to
`true` to allow inline HTML5 media playback, also, the video element
in the HTML document must also include the webkit-playsinline
@@ -109,17 +107,14 @@ File for information on global configuration options.
<preference name="SuppressesIncrementalRendering" value="true"/>
-* `KeyboardShrinksView` (boolean, defaults to `false`): set to `true` to
- shrink the webview when the keyboard comes up. The webview shrinks
- instead of the viewport shrinking and the page scrollable. This
- applies to apps that position their elements relative to the bottom
- of the webview. This is the default behaviour on Android, and makes
- a lot of sense when building apps as opposed to webpages.
+* `KeyboardShrinksView` (boolean, defaults to `false`): set to `true`
+ to scale down the webview when the keyboard appears rather than
+ shrinking the viewport, matching the default behaviour for Android.
+ This applies to apps that position their elements relative to the
+ bottom of the webview.
<preference name="KeyboardShrinksView" value="true"/>
-<!-- QUERY I: describe KeyboardShrinksView; shrink webview when keyboard appears -->
-
<!-- QUERY I: is target-device OK?
#### Target a Specific Device
[17/50] docs commit: [CB-3820] clarify defaults for
LoadUrlTimeoutValue
Posted by mw...@apache.org.
[CB-3820] clarify defaults for LoadUrlTimeoutValue
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/7ba945e4
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/7ba945e4
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/7ba945e4
Branch: refs/heads/master
Commit: 7ba945e4cd09180c8f453227b730d2a87b323a78
Parents: 71d49e6
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 13:08:37 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:02:20 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/config.md | 20 +++-----------------
1 file changed, 3 insertions(+), 17 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7ba945e4/docs/en/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/config.md b/docs/en/edge/guide/platforms/android/config.md
index 8663ed8..2b420e7 100644
--- a/docs/en/edge/guide/platforms/android/config.md
+++ b/docs/en/edge/guide/platforms/android/config.md
@@ -41,24 +41,10 @@ config.xml File for information on global configuration options.
<preference name="ErrorUrl" value="error.html"/>
-* `LoadUrlTimeoutValue`: How much time Cordova should wait before
- throwing a timeout error on the application.
+* `LoadUrlTimeoutValue` (number, default is `20000`): When loading a
+ page, the amount of time to wait before throwing a timeout error.
- <preference name="LoadUrlTimeoutValue" value="20000"/>
-
-<!-- QUERY A: is loadUrlTimeoutValue expressed in milliseconds? is 20000 the default?-->
-
-<!-- QUERY A: confirm loadUrlTimeoutValue replaces PGB's load-url-timeout
-
- #### Load URL timeout
-
- * `load-url-timeout` with a value in milliseconds
-
- * defaults to 20000 (20 seconds)
-
- * example: `<preference name="load-url-timeout" value="15000" />`
-
--->
+ <preference name="LoadUrlTimeoutValue" value="10000"/>
* `KeepRunning` (boolean, defaults to `true`): Determines whether
Cordova stays running in the background.
[03/50] docs commit: [CB-3820] DisallowOverscroll concerns
rubber-band, not glow
Posted by mw...@apache.org.
[CB-3820] DisallowOverscroll concerns rubber-band, not glow
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/d151efa2
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/d151efa2
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/d151efa2
Branch: refs/heads/master
Commit: d151efa2e79fa19cf849d1a3319d34941bc8aea9
Parents: bc91e00
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 13 15:35:32 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 13:59:42 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 14 +++-----------
1 file changed, 3 insertions(+), 11 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/d151efa2/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 1650b73..b7f099d 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -140,22 +140,14 @@ The following global preferences apply to all platforms:
The following preferences apply to more than one platform, but not to
all of them:
-* `DisallowOverscroll` (boolean, defaults to `false`):
- set to `true` if you don't want the WebView to rubber-band.
+* `DisallowOverscroll` (boolean, defaults to `false`): set to `true`
+ if you don't want the WebView to bounce and snap back when scrolling
+ past the beginning or end of the content.
<preference name="DisallowOverscroll" value="true"/>
Applies to Android and iOS.
-<!-- QUERY A: describe the disallowOverscroll glow effect, or provide example
-
-* `DisallowOverscroll` (boolean, defaults to `false`): set to `true` to
- disable the glow when a user scrolls beyond the edge of the webview.
-
- <preference name="disallowOverscroll" value="true"/>
-
--->
-
* `BackgroundColor`: Set the app's background color. Supports a
four-byte hex value, with the first byte representing an alpha
channel, and standard RGB values for the following three bytes. This
[36/50] docs commit: [CB-3820] stay-in-webview is deprecated &
PGB-only
Posted by mw...@apache.org.
[CB-3820] stay-in-webview is deprecated & PGB-only
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/2d08362b
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/2d08362b
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/2d08362b
Branch: refs/heads/master
Commit: 2d08362b286143992518525040492c818c21c3b2
Parents: 2b97ba3
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:12:49 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:04:44 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 23 -----------------------
1 file changed, 23 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2d08362b/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 4e9a44e..6fcb08c 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -102,29 +102,6 @@ File for information on global configuration options.
<preference name="KeyboardShrinksView" value="true"/>
-<!-- QUERY I: Is deprecated stay-in-webview still enabled?
-
- #### Open all links in WebView
-
-* __Deprecated__ -- use <a
- href="http://docs.phonegap.com/en/2.9.0/cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a>
- with target equal to '_self' (webview), '_blank' (InAppBrowser),
- '_system' (system web browser)
-
-* `stay-in-webview` with values `true` or `false`
-
- * example: `<preference name="stay-in-webview" value="true" />`
-
- * if set to true, all links (even with target set to blank) will
- open in the app's webview
-
- * only use this preference if you want pages from your server to
- take over your entire app
-
- * default is _false_
-
--->
-
<!-- QUERY I: Is ios-statusbarstyle OK?
#### Status Bar Style
[45/50] docs commit: [CB-3820] is WebViewBounce superseded by
DisallowOverscroll in cordova?
Posted by mw...@apache.org.
[CB-3820] is WebViewBounce superseded by DisallowOverscroll in cordova?
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/83c7f91e
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/83c7f91e
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/83c7f91e
Branch: refs/heads/master
Commit: 83c7f91e85ab75ee76aa24eed156931c0f398a83
Parents: 61a4b97
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:53:03 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:05:47 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 2 ++
1 file changed, 2 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/83c7f91e/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 56fac38..99f1c4a 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -60,6 +60,8 @@ This example shows the default `config.xml` generated by the CLI's
<preference name="WebViewBounce" value="true" />
</widget>
+<!-- QUERY: is WebViewBounce superseded by DisallowOverscroll? -->
+
The following configuration elements appear in the top-level
`config.xml` file, and are supported across all supported Cordova
platforms:
[37/50] docs commit: [CB-3820] assume ios-statusbarstyle pref is
PGB-only
Posted by mw...@apache.org.
[CB-3820] assume ios-statusbarstyle pref is PGB-only
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/13d93516
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/13d93516
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/13d93516
Branch: refs/heads/master
Commit: 13d93516cfc47b95ade53daaa4550b94dc5923ee
Parents: 2d08362
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:13:38 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:04:51 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 17 -----------------
1 file changed, 17 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/13d93516/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 6fcb08c..429ca6e 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -102,23 +102,6 @@ File for information on global configuration options.
<preference name="KeyboardShrinksView" value="true"/>
-<!-- QUERY I: Is ios-statusbarstyle OK?
-
- #### Status Bar Style
-
-* `ios-statusbarstyle` with values `default`, `black-opaque` or
- `black-translucent`
-
- * example: `<preference name="ios-statusbarstyle" value="black-opaque" />`
-
- * default is a grey status bar, `black-opaque` will appear black
-
- * although `black-translucent` is supported, the PhoneGap webview
- does not extend beneath the status bar, so it will appear
- identical to `black-opaque` once your app is running
-
--->
-
<!-- QUERY I: Is detect-data-types OK?
#### Detect Data Types
[07/50] docs commit: [CB-3820] whether HideKeyboardFormAccessoryBar
applies to >1 input matters little
Posted by mw...@apache.org.
[CB-3820] whether HideKeyboardFormAccessoryBar applies to >1 input matters little
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/2d8e805a
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/2d8e805a
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/2d8e805a
Branch: refs/heads/master
Commit: 2d8e805a593a729628d67f31e802a6a788dbd2ca
Parents: 5f988bd
Author: Mike Sierra <ms...@adobe.com>
Authored: Wed Sep 18 12:16:20 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:00:14 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 18 +++---------------
1 file changed, 3 insertions(+), 15 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2d8e805a/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 69704d6..c8aafa1 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -158,28 +158,16 @@ all of them:
Applies to Android and BlackBerry.
* `HideKeyboardFormAccessoryBar` (boolean, defaults to `false`): set
- to `true` to hide the additional toolbar that is on top of the
- keyboard. This toolbar features the __Prev__, __Next__, and
- __Done__ buttons.
+ to `true` to hide the additional toolbar that appears above the
+ keyboard and helps users navigate from one form input to the next.
<preference name="HideKeyboardFormAccessoryBar" value="true"/>
Applies to iOS and BlackBerry.
-<!-- QUERY: for HideKeyboardFormAccessoryBar, does form-helper UI only appear when there's >1 input? -->
-
<!-- BB version:
-* `HideKeyboardFormAccessoryBar`: (`enable` or `disable`) Disables the
- keyboard form accessory bar in an HTML form. The keyboard form
- accessory bar is a row of buttons (__Previous__, __Next__, and
- __Submit__) that the user can use to navigate through a form. By
- default, when a WebWorks app contains an HTML form and an `<input>`
- element gets focus, WebWorks displays this form accessory bar. This
- feature allows you to prevent your app from displaying the form
- accessory bar by specifying value as `enable`.
-
- <preference name="hideKeyboardFormAccessoryBar" value="enable"/>
+* `HideKeyboardFormAccessoryBar`: (`enable` or `disable`)
-->
[02/50] docs commit: [CB-3820] AutoHideSplashScreen is iOS only
Posted by mw...@apache.org.
[CB-3820] AutoHideSplashScreen is iOS only
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/bc91e00a
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/bc91e00a
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/bc91e00a
Branch: refs/heads/master
Commit: bc91e00ab5ba8141e79a36a4e81429c0944b70c3
Parents: cb969a3
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 13 15:32:43 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 13:59:28 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 22 +++-------------------
docs/en/edge/guide/platforms/ios/config.md | 5 +++++
2 files changed, 8 insertions(+), 19 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bc91e00a/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index fd353b8..1650b73 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -140,11 +140,13 @@ The following global preferences apply to all platforms:
The following preferences apply to more than one platform, but not to
all of them:
-* `DisallowOverscroll` (boolean, defaults to `false`; Android, iOS):
+* `DisallowOverscroll` (boolean, defaults to `false`):
set to `true` if you don't want the WebView to rubber-band.
<preference name="DisallowOverscroll" value="true"/>
+ Applies to Android and iOS.
+
<!-- QUERY A: describe the disallowOverscroll glow effect, or provide example
* `DisallowOverscroll` (boolean, defaults to `false`): set to `true` to
@@ -163,22 +165,6 @@ all of them:
Applies to Android and BlackBerry.
-* `AutoHideSplashScreen` (boolean, defaults to `true`): set to `false`
- to control when the splash screen image is hidden through a
- JavaScript API.
-
- <preference name="AutoHideSplashScreen" value="false"/>
-
-<!-- autoHideSplashScreen vs iOS AutoHideSplashScreen:
-
-* `AutoHideSplashScreen`: (`true` or `false`): Set to `false` to
- control when the splash screen image is hidden through a JavaScript
- API. This preference defaults to true.
-
- <preference name="autoHideSplashScreen" value="false"/>
-
--->
-
* `HideKeyboardFormAccessoryBar` (boolean, defaults to `false`): set
to `true` to hide the additional toolbar that is on top of the
keyboard. This toolbar features the __Prev__, __Next__, and
@@ -203,8 +189,6 @@ all of them:
-->
-<!-- @@@ -->
-
## The `<feature>` Element
If you use the CLI to build applications, you use the `plugin` command
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bc91e00a/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 5a7ac61..58797a2 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -80,6 +80,11 @@ following defines splash screens for each type of screen:
<!-- QUERY: Do viewport meta tags work as expected in other environments? -->
+* `AutoHideSplashScreen` (boolean, defaults to `true`): set to `false` to
+ control when the splashscreen is hidden through a JavaScript API.
+
+ <preference name="AutoHideSplashScreen" value="false"/>
+
* `FadeSplashScreen` (boolean, defaults to `true`): set to `false` to
prevent the splash-screen to fade in and out when showing or hiding
it.
[21/50] docs commit: [CB-3820] no disable-cursor pref in BB10
Posted by mw...@apache.org.
[CB-3820] no disable-cursor pref in BB10
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/ef59b1ca
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/ef59b1ca
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/ef59b1ca
Branch: refs/heads/master
Commit: ef59b1ca07f7c84da22f4676fedf7479c611b412
Parents: 474286f
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 15:13:12 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:02:52 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/blackberry10/config.md | 16 ----------------
1 file changed, 16 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ef59b1ca/docs/en/edge/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/blackberry10/config.md b/docs/en/edge/guide/platforms/blackberry10/config.md
index 7126428..295231d 100644
--- a/docs/en/edge/guide/platforms/blackberry10/config.md
+++ b/docs/en/edge/guide/platforms/blackberry10/config.md
@@ -53,19 +53,3 @@ config.xml File for information on global configuration options.
<preference name="webSecurity" value="disable"/>
-<!-- QUERY BB: does disable-cursor work?
-
- #### Disable Cursor
-
-* `disable-cursor` with values `true` or `false`
-
- * example: `<preference name="disable-cursor" value="true" />`
-
- * prevents a mouse-icon/cursor from being displayed on the app -
- desugars to `<rim:navigation />`. See [the BlackBerry
- documentation](https://bdsc.webapps.blackberry.com/html5/documentation/ww_developing/rim_navigation_element_1582456_11.html)
- for more details
-
- * default is _false_
-
--->
[38/50] docs commit: [CB-3820] assume detect-data-types pref is
PGB-only
Posted by mw...@apache.org.
[CB-3820] assume detect-data-types pref is PGB-only
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/3b415ecd
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/3b415ecd
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/3b415ecd
Branch: refs/heads/master
Commit: 3b415ecd9c289820c80149cdcf005b4588b2a1fd
Parents: 13d9351
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:14:21 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:04:58 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 16 ----------------
1 file changed, 16 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3b415ecd/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 429ca6e..18c4990 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -102,22 +102,6 @@ File for information on global configuration options.
<preference name="KeyboardShrinksView" value="true"/>
-<!-- QUERY I: Is detect-data-types OK?
-
- #### Detect Data Types
-
-* `detect-data-types` with values `true` or `false`
-
- * example: `<preference name="detect-data-types" value="false" />`
-
- * controls whether certain data types (such as phone numbers and
- dates) are automatically turned into links by the system. Defaults
- to "true" (as does the system web view)
-
- * supported on PhoneGap 2.0.0 and above
-
--->
-
<!-- QUERY I: Is exit-on-suspend OK?
#### Exit On Suspend
[41/50] docs commit: [CB-3820] assume auto-hide-splash-screen ios
pref is PGB-only; superseded in CV by CamelCase variant
Posted by mw...@apache.org.
[CB-3820] assume auto-hide-splash-screen ios pref is PGB-only; superseded in CV by CamelCase variant
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/3f9c2de2
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/3f9c2de2
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/3f9c2de2
Branch: refs/heads/master
Commit: 3f9c2de2134db073b4187591ccb50aae35ef92f4
Parents: 15183ff
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:18:02 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:05:19 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 17 -----------------
1 file changed, 17 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3f9c2de2/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 0ccff17..6919970 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -101,20 +101,3 @@ File for information on global configuration options.
<preference name="KeyboardShrinksView" value="true"/>
-
-<!-- QUERY I: Is auto-hide-splash-screen OK?
-
- #### Auto-Hide Splash Screen
-
-* `auto-hide-splash-screen` with values `true` or `false`
-
- * example: `<preference name="auto-hide-splash-screen" value="false"
- />`
-
- * if set to false, the splash screen must be hidden using a
- JavaScript API
-
- * default is _true_
-
--->
-
[33/50] docs commit: [CB-3820] assume target-device pref is PGB-only
Posted by mw...@apache.org.
[CB-3820] assume target-device pref is PGB-only
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/3b97a02c
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/3b97a02c
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/3b97a02c
Branch: refs/heads/master
Commit: 3b97a02c0c51180b801d915ecbfdfe5bfaee1a5c
Parents: 113fe1f
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:09:44 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:04:22 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 13 -------------
1 file changed, 13 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3b97a02c/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 894f45a..b610c9f 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -101,19 +101,6 @@ File for information on global configuration options.
<preference name="KeyboardShrinksView" value="true"/>
-<!-- QUERY I: is target-device OK?
-
- #### Target a Specific Device
-
-* `target-device` with possible values `handset`, `tablet`, or
- `universal`
-
- * example: `<preference name="target-device" value="universal" />`
-
- * please note that this currently only applies to iOS builds; by
- default all builds are universal
-
--->
<!-- QUERY I: Is webviewbounce OK?
[06/50] docs commit: [CB-3820] clarify scaope of current page:
non-platform-unique content
Posted by mw...@apache.org.
[CB-3820] clarify scaope of current page: non-platform-unique content
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/5f988bd7
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/5f988bd7
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/5f988bd7
Branch: refs/heads/master
Commit: 5f988bd75b8af0adf81c9a5baac2226dd6055019
Parents: 5b9579c
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 13 15:43:22 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:00:06 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5f988bd7/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index bcb8227..69704d6 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -34,8 +34,8 @@ this file in various subdirectories within `platforms`. If you use the
CLI to create a project, but then shift your workflow to an SDK, the
platform-specific file serves as a source.
-This section details global configuration options. See the following
-sections for platform-specific options:
+This section details global and cross-platform configuration options.
+See the following sections for platform-specific options:
- iOS Configuration
- Android Configuration
[23/50] docs commit: [CB-3820] tighten up PopupBlocker
Posted by mw...@apache.org.
[CB-3820] tighten up PopupBlocker
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/7243e185
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/7243e185
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/7243e185
Branch: refs/heads/master
Commit: 7243e1853d6a288066edeac711654db83af9b8b5
Parents: 3b2600a
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 15:25:30 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:03:06 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/blackberry10/config.md | 11 ++++-------
1 file changed, 4 insertions(+), 7 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7243e185/docs/en/edge/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/blackberry10/config.md b/docs/en/edge/guide/platforms/blackberry10/config.md
index f1b5c0f..d1d82c8 100644
--- a/docs/en/edge/guide/platforms/blackberry10/config.md
+++ b/docs/en/edge/guide/platforms/blackberry10/config.md
@@ -31,16 +31,13 @@ config.xml File for information on global configuration options.
<preference name="childBrowser" value="disable"/>
-* `PopupBlocker`: Enables the popup blocker. By default, all popups
- are displayed by BlackBerry WebWorks apps in a child browser
- window. You can prevent popups from displaying without user
- intervention by enabling the popup blocker. This is done by
- specifying value as `enable`.
+* `PopupBlocker`: Enables the popup blocker, which prevents calls to
+ `window.open()`. By default, popups display in a child browser
+ window. Setting the preference to `enable` prevents it from
+ displaying at all.
<preference name="popupBlocker" value="enable"/>
-<!-- QUERY BB: for popupBlocker, clarify "popup" -->
-
* `WebSecurity`: Disables web security. Disabling web security allows
you to access remote content from unknown sources during
development. Before packaging your app for distribution, you should
[46/50] docs commit: [CB-3820] tighten up text for Android prefs
Posted by mw...@apache.org.
[CB-3820] tighten up text for Android prefs
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/2fb247f8
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/2fb247f8
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/2fb247f8
Branch: refs/heads/master
Commit: 2fb247f86c44fe189503926bcb2f815d6fe8637a
Parents: 83c7f91
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:57:14 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:05:53 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/config.md | 18 +++++++++---------
1 file changed, 9 insertions(+), 9 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2fb247f8/docs/en/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/config.md b/docs/en/edge/guide/platforms/android/config.md
index 668e134..61ae1a6 100644
--- a/docs/en/edge/guide/platforms/android/config.md
+++ b/docs/en/edge/guide/platforms/android/config.md
@@ -24,25 +24,26 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to Android builds. See The
config.xml File for information on global configuration options.
-* `LoadingDialog`: Display a native loading dialog when loading the
- app. The value's format is _Title, Message_
+* `LoadingDialog`: Display a native dialog when loading the app. The
+ value's format is _Title, Message_
<preference name="LoadingDialog" value="Please wait, the app is loading"/>
-* `LoadingPageDialog`: Display a native loading dialog when loading
- sub-pages. The value's format is _Title, Message_
+* `LoadingPageDialog`: Display a native dialog when loading sub-pages
+ within an app. The value's format is _Title, Message_
<preference name="LoadingPageDialog" value="Please wait, the data is loading"/>
* `ErrorUrl`: Specifies an error page that displays in response to
- standard HTTP errors in the 400-500 range. The specified file needs
- to be placed in the top-level directory containing the home page and
- other web assets.
+ standard HTTP errors in the 400-500 range. Place the specified file
+ in the top-level directory containing the home page and other web
+ assets.
<preference name="ErrorUrl" value="error.html"/>
* `LoadUrlTimeoutValue` (number, default is `20000`): When loading a
page, the amount of time to wait before throwing a timeout error.
+ This example specifies 10 seconds rather than 20:
<preference name="LoadUrlTimeoutValue" value="10000"/>
@@ -54,8 +55,7 @@ config.xml File for information on global configuration options.
* `SplashScreen`: The name of the file minus its extension in the
`res/drawable` directory. Various assets must share this common
- name in various subdirectories. For details, see the _Icons and
- Splash Screens_ section in The config.xml File.
+ name in various subdirectories.
<preference name="SplashScreen" value="splash"/>
[32/50] docs commit: [CB-3820] not sure what ShowSplashScreenSpinner
refers to, but not important
Posted by mw...@apache.org.
[CB-3820] not sure what ShowSplashScreenSpinner refers to, but not important
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/113fe1fc
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/113fe1fc
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/113fe1fc
Branch: refs/heads/master
Commit: 113fe1fc428d3e6ba28d7cabfebf3a95a0ad9860
Parents: d967edc
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:08:39 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:04:16 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/113fe1fc/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 00d2e9b..894f45a 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -56,12 +56,10 @@ File for information on global configuration options.
<preference name="FadeSplashScreenDuration" value="4"/>
* `ShowSplashScreenSpinner` (boolean, defaults to `true`): set to `false`
- to hide the splash-screen spinner.
+ to hide the splash screen spinner element.
<preference name="ShowSplashScreenSpinner" value="false"/>
-<!-- QUERY I: for ShowSplashScreenSpinner describe spinner -->
-
* `MediaPlaybackRequiresUserAction` (boolean, defaults to `false`):
set to `true` to prevent HTML5 video from playing automatically with
the `autoplay` attribute.
[11/50] docs commit: [CB-3820] correction: icon/splash mechanism is
PGB-only
Posted by mw...@apache.org.
[CB-3820] correction: icon/splash mechanism is PGB-only
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/9df47dc1
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/9df47dc1
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/9df47dc1
Branch: refs/heads/master
Commit: 9df47dc19f34c86e881c131545076cb184682031
Parents: f885c0c
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 11:39:04 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:01:30 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 141 +---------------------------------
1 file changed, 1 insertion(+), 140 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/9df47dc1/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index c8aafa1..1381146 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -45,8 +45,7 @@ See the following sections for platform-specific options:
## Core Configuration Elements
This example shows the default `config.xml` generated by the CLI's
-`create` command, described in The Command-line Interface, along with
-a custom icon file:
+`create` command, described in The Command-line Interface:
<widget id="com.example.hello" version="0.0.1">
<name>HelloWorld</name>
@@ -60,7 +59,6 @@ a custom icon file:
<access origin="*" />
<preference name="fullscreen" value="true" />
<preference name="webviewbounce" value="true" />
- <icon src="app_icon.png" />
</widget>
The following configuration elements appear in the top-level
@@ -199,140 +197,3 @@ Here is how the element appears for iOS projects:
See the API Reference for details on how to specify each feature. See
the Plugin Development Guide for more information on plugins.
-
-## Icons and Splash Screens
-
-By default, Cordova generates icons based on the root application
-directory's `icon.png` file. Otherwise, adding `<icon>` elements to
-the `config.xml` file allows you to specify a different default
-filename, or platform-specific icons. The `width` and `height`
-attributes are optional:
-
- <icon src="app.png" width="128" height="128"/>
-
-Likewise, the default splash screen must be named `splash.png` and
-must reside in the root of your application directory in _png_
-format. Otherwise, use the `gap:splash` tag to specify a different
-filename:
-
- <gap:splash src="app_splash.png" />
-
-The `gap:platform` attribute specifies custom splash screens for
-target platforms. For example:
-
- <gap:splash src="splash/ios/Default-568h@2x~iphone.png"
- gap:platform="ios" width="320" height="480" />
-
-If the `gap:platform` attribute is not specified, the referenced file
-is copied to _all_ platforms, unnecessarily increasing the size of the
-application package.
-
-<!-- QUERY: confirm default icon.png, splash.png; or is cordova icon the default? -->
-
-To define platform-specific icons and splash screens, consult each
-platform's configuration options listed at the top of this section.
-
-<!-- remaining PGB doc for config.xml:
-
- #### Custom Debug Server
-
-The `debug-server` feature allows you to use a custom Weinre instance
-for your application. By default PhoneGap Build uses
-`http://debug.build.phonegap.com` however this can be changed by
-adding the following to your `config.xml`.
-
- <feature name="debug-server" required="true">
- <param name="domain" value="http://debug.example.com"/>
- <param name="key" value="some_unique_key"/>
- </feature>
-
-Don't forget to change the domain and key to the appropriate values.
-
- #### API Features
-
-Currently supported through this interface are the following feature names:
-
-* `http://api.phonegap.com/1.0/battery`
-
- * maps to `android:BROADCAST_STICKY` permission
-
-* `http://api.phonegap.com/1.0/camera`
-
- * maps to `android:CAMERA`, `winphone:ID_CAP_ISV_CAMERA`, and
- `winphone:ID_HW_FRONTCAMERA` permissions
-
-* `http://api.phonegap.com/1.0/contacts`
-
- * maps to `android:READ_CONTACTS`, `android:WRITE_CONTACTS`,
- `android:GET_ACCOUNTS`, and `winphone:ID_CAP_CONTACTS` permissions
-
-* `http://api.phonegap.com/1.0/file`
-
- * maps to `WRITE_EXTERNAL_STORAGE` permission
-
-* `http://api.phonegap.com/1.0/geolocation`
-
- * maps to `android:ACCESS_COARSE_LOCATION`,
- `android:ACCESS_FINE_LOCATION`,
- `android:ACCESS_LOCATION_EXTRA_COMMANDS`, and
- `winphone:ID_CAP_LOCATION` permissions
-
-* `http://api.phonegap.com/1.0/media`
-
- * maps to `android:RECORD_AUDIO`, `android:RECORD_VIDEO`,
- `android:MODIFY_AUDIO_SETTINGS`, and `winphone:ID_CAP_MICROPHONE`
- permissions
-
-* `http://api.phonegap.com/1.0/network`
-
- * maps to `android:ACCESS_NETWORK_STATE`, and
- `winphone:ID_CAP_NETWORKING` permissions
-
-* `http://api.phonegap.com/1.0/notification`
-
- * maps to `VIBRATE` permission
-
-* `http://api.phonegap.com/1.0/device`
-
- * maps to `winphone:ID_CAP_IDENTITY_DEVICE` permission
-
- #### Usage
-
- If you do not want any permissions to be added to your app, add the
- following tag to your config.xml; you will still have the INTERNET
- permission on your app, which PhoneGap requires.
- <preference name="permissions" value="none"/>
-
- to enable individual permissions use the following examples
- <feature name="http://api.phonegap.com/1.0/battery"/>
- <feature name="http://api.phonegap.com/1.0/camera"/>
- <feature name="http://api.phonegap.com/1.0/contacts"/>
- <feature name="http://api.phonegap.com/1.0/file"/>
- <feature name="http://api.phonegap.com/1.0/geolocation"/>
- <feature name="http://api.phonegap.com/1.0/media"/>
- <feature name="http://api.phonegap.com/1.0/network"/>
- <feature name="http://api.phonegap.com/1.0/notification"/>
-
- ### Plugins
-
-* `<gap:plugin>`: specifies a PhoneGap plugin for PhoneGap Build to
- include in your generated apps.
-
-At present, to include a plugin, you will to ensure:
-
-* the plugin is supported by PhoneGap Build; and
-
-* any JavaScript script tags are present in your `index.html` file.
-
-More details, including a list of available plugins, are in our
-[plugins documentation](/docs/plugins).
-
- #### WebOS
-
-WebOS supports a default icon and a mini icon which can be used for
-notifications.
-
- <icon src="icons/webos/icon.png" gap:platform="webos" />
- <icon src="icons/webos/miniicon.png" gap:platform="webos" gap:role="mini" />
-
--->
[48/50] docs commit: [CB-3820] assume you use EnableViewportScale to
disable scaling, oddly enough
Posted by mw...@apache.org.
[CB-3820] assume you use EnableViewportScale to disable scaling, oddly enough
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/7a976bd0
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/7a976bd0
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/7a976bd0
Branch: refs/heads/master
Commit: 7a976bd0f6bc6dd73f051e85e54005b7d10f34fd
Parents: 1a18b54
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 12:13:24 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:06:05 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7a976bd0/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index f81b6b1..ff94995 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -24,19 +24,19 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to iOS builds. See The config.xml
File for information on global configuration options.
-* `TopActivityIndicator` (string, defaults to `gray`): this is the top
- spinning throbber in the status/battery bar, valid values are
+* `TopActivityIndicator` (string, defaults to `gray`): Controls the
+ appearance of the small spinning icon in the status bar that
+ indicates significant processor activity. Valid values are
`whiteLarge`, `white`, and `gray`.
<preference name="TopActivityIndicator" value="white"/>
-* `EnableViewportScale` (boolean, defaults to `false`): set to `true` to
- prevent viewport scaling through a meta tag.
+* `EnableViewportScale` (boolean, defaults to `false`): Set to `true`
+ to use a viewport meta tag to either disable or restrict the range
+ of user scaling.
<preference name="EnableViewportScale" value="true"/>
-<!-- QUERY I: confirm EnableViewportScale allows viewport metatag to control range of scale, including disabling? -->
-
* `FadeSplashScreen` (boolean, defaults to `true`): set to `false` to
prevent the splash-screen to fade in and out when showing or hiding
it.
[15/50] docs commit: [CB-3820] removed deprecated UseBrowserHistory
pref
Posted by mw...@apache.org.
[CB-3820] removed deprecated UseBrowserHistory pref
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/46c6deb9
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/46c6deb9
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/46c6deb9
Branch: refs/heads/master
Commit: 46c6deb9596d6b9333934f11676317e2110b3518
Parents: 26615ea
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 12:59:48 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:02:05 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/config.md | 11 -----------
1 file changed, 11 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/46c6deb9/docs/en/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/config.md b/docs/en/edge/guide/platforms/android/config.md
index 9e43ad9..91e3aea 100644
--- a/docs/en/edge/guide/platforms/android/config.md
+++ b/docs/en/edge/guide/platforms/android/config.md
@@ -24,17 +24,6 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to Android builds. See The
config.xml File for information on global configuration options.
-<!-- QUERY A: is useBrowserHistory deprecated?
-
-* `UseBrowserHistory` (boolean, defaults to `true`): set to `false` if
- you want to use the history shim that was used to work around the
- hashtag error present in Android 3.x prior to the history fix.
- (Note: This setting will be deprecated in April 2013)
-
- <preference name="UseBrowserHistory" value="false"/>
-
--->
-
* `LoadingDialog`: Display a native loading dialog when loading the
app. The value's format is _Title, Message_
[42/50] docs commit: [CB-3820] query re scope of backgroundColor pref
Posted by mw...@apache.org.
[CB-3820] query re scope of backgroundColor pref
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/5b2beeb0
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/5b2beeb0
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/5b2beeb0
Branch: refs/heads/master
Commit: 5b2beeb0a10562f91094f955df38901aac06ed66
Parents: 3f9c2de
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:34:55 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:05:26 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 2 +
docs/en/edge/guide/platforms/ios/config.md | 250 +++++++++++++++++++++---
2 files changed, 229 insertions(+), 23 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5b2beeb0/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 2a47b43..b7eeeed 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -134,6 +134,8 @@ all of them:
Applies to Android and BlackBerry.
+<!-- QUERY: does this override CSS such as "body {background-color:black}"? -->
+
* `HideKeyboardFormAccessoryBar` (boolean, defaults to `false`): set
to `true` to hide the additional toolbar that appears above the
keyboard, helping users navigate from one form input to another.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5b2beeb0/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 6919970..5a7ac61 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -24,13 +24,53 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to iOS builds. See The config.xml
File for information on global configuration options.
-* `TopActivityIndicator` (string, defaults to `gray`): controls the
- appearance of the small spinning icon that appears in the
- status/battery bar to indicate a demanding process is executing.
- Valid values are `whiteLarge`, `white`, and `gray`.
+## Icons and Splash Screens
+
+Cordova supports icons for _classic_, _retina_, _iPad_, and _retina
+iPad_ displays (the latter as of Cordova 2.5). The following defines
+icons for each type of screen:
+
+ <icon src="icons/ios/icon.png" gap:platform="ios" width="57" height="57" />
+ <icon src="icons/ios/icon-72.png" gap:platform="ios" width="72" height="72" />
+ <icon src="icons/ios/icon_at_2x.png" gap:platform="ios" width="114" height="114" />
+ <!-- retina iPad -->
+ <icon src="icons/ios/icon-72_at_2x.png" gap:platform="ios" width="144" height="144" />
+
+Cordova supports splash screens for _classic_, _retina_, _iPhone 5_,
+and _iPad_ displays. Standard iPads have two different splash screens
+for portrait and landscape orientation. Retina iPads have two
+additional splash screens: retina portrait and retina landscape. The
+following defines splash screens for each type of screen:
+
+ <gap:splash src="splash/ios/Default.png" gap:platform="ios" width="320" height="480" />
+ <gap:splash src="splash/ios/Default_at_2x.png" gap:platform="ios" width="640" height="960" />
+ <gap:splash src="splash/ios/Default_iphone5.png" gap:platform="ios" width="640" height="1136" />
+ <gap:splash src="splash/ios/Default-Landscape.png" gap:platform="ios" width="1024" height="748" />
+ <gap:splash src="splash/ios/Default-Portrait.png" gap:platform="ios" width="768" height="1004" />
+ <!-- retina iPad -->
+ <gap:splash src="splash/ios/Default-Landscape_at_2x.png" gap:platform="ios" width="2048" height="1496" />
+ <gap:splash src="splash/ios/Default-Portrait_at_2x.png" gap:platform="ios" width="1536" height="2008" />
+
+## iOS Preferences
+
+* `TopActivityIndicator` (string, defaults to `gray`): this is the top
+ spinning throbber in the status/battery bar, valid values are
+ `whiteLarge`, `white`, and `gray`.
<preference name="TopActivityIndicator" value="white"/>
+<!-- QUERY I: describe TopActivityIndicator top spinning throbber -->
+
+* `EnableLocation` (boolean, defaults to `false`): set to `true`, to
+ initialize the Geolocation plugin at start-up (so the fix on your
+ location can be more accurate) __DEPRECATED__: please set the
+ `onload` attribute of the `Geolocation` plugin to `true`
+ instead.
+
+ <preference name="EnableLocation" value="true"/>
+
+<!-- QUERY I: is deprecated EnableLocation still functional? -->
+
* `EnableViewportScale` (boolean, defaults to `false`): set to `true` to
prevent viewport scaling through a meta tag.
@@ -38,34 +78,33 @@ File for information on global configuration options.
<!-- QUERY I: confirm EnableViewportScale allows viewport metatag to control range of scale, including disabling? -->
-* `AutoHideSplashScreen` (boolean, defaults to `true`): set to `false`
- to use the SplashScreen API to control when the opening image stops
- displaying.
-
- <preference name="AutoHideSplashScreen" value="false"/>
+<!-- QUERY: Do viewport meta tags work as expected in other environments? -->
* `FadeSplashScreen` (boolean, defaults to `true`): set to `false` to
- prevent the splash-screen from fading in or out when showing or
- hiding it.
+ prevent the splash-screen to fade in and out when showing or hiding
+ it.
<preference name="FadeSplashScreen" value="false"/>
-* `FadeSplashScreenDuration` (float, defaults to `2`): The splash-screen
+* `FadeSplashScreenDuration` (float, defaults to 2): The splash-screen
Fade duration in seconds.
<preference name="FadeSplashScreenDuration" value="4"/>
* `ShowSplashScreenSpinner` (boolean, defaults to `true`): set to `false`
- to hide the splash screen spinner element.
+ to hide the splash-screen spinner.
<preference name="ShowSplashScreenSpinner" value="false"/>
-* `MediaPlaybackRequiresUserAction` (boolean, defaults to `false`):
- set to `true` to prevent HTML5 video from playing automatically with
- the `autoplay` attribute.
+<!-- QUERY I: for ShowSplashScreenSpinner describe spinner -->
+
+* `MediaPlaybackRequiresUserAction` (boolean, defaults to `false`): set
+ to `true` to not allow autoplayed HTML5 video.
<preference name="MediaPlaybackRequiresUserAction" value="true"/>
+<!-- QUERY I: does MediaPlaybackRequiresUserAction also apply to audio? -->
+
* `AllowInlineMediaPlayback` (boolean, defaults to `false`): set to
`true` to allow inline HTML5 media playback, also, the video element
in the HTML document must also include the webkit-playsinline
@@ -83,21 +122,186 @@ File for information on global configuration options.
* `KeyboardDisplayRequiresUserAction` (boolean, defaults to `true`):
set to `false` to open the keyboard when form elements get focus via
- the JavaScript `focus()` call.
+ the JavaScript focus() call.
<preference name="KeyboardDisplayRequiresUserAction" value="false"/>
* `SuppressesIncrementalRendering` (boolean, defaults to `false`): set
to `true` to wait until all new view content has been received
- before it renders.
+ before it is rendered.
<preference name="SuppressesIncrementalRendering" value="true"/>
-* `KeyboardShrinksView` (boolean, defaults to `false`): set to `true`
- to scale down the webview when the keyboard appears rather than
- shrinking the viewport, matching the default behaviour for Android.
- This applies to apps that position their elements relative to the
- bottom of the webview.
+* `KeyboardShrinksView` (boolean, defaults to `false`): set to `true` to
+ shrink the WebView when the keyboard comes up. The WebView shrinks
+ instead of the viewport shrinking and the page scrollable. This
+ applies to apps that position their elements relative to the bottom
+ of the WebView. This is the default behaviour on Android, and makes
+ a lot of sense when building apps as opposed to webpages.
<preference name="KeyboardShrinksView" value="true"/>
+<!-- QUERY I: describe KeyboardShrinksView; shrink webview when keyboard appears -->
+
+<!-- QUERY I: is target-device OK?
+
+ #### Target a Specific Device
+
+* `target-device` with possible values `handset`, `tablet`, or
+ `universal`
+
+ * example: `<preference name="target-device" value="universal" />`
+
+ * please note that this currently only applies to iOS builds; by
+ default all builds are universal
+
+-->
+
+<!-- QUERY I: Is webviewbounce OK?
+
+ #### WebView Bounce
+
+* `webviewbounce` with values `true` or `false`
+
+ <preference name="webviewbounce" value="fubar"/>
+
+ * example: `<preference name="webviewbounce" value="false" />`
+
+ * controls whether the screen "bounces" when scrolled beyond the top
+ or bottom on iOS. By default, the bounce is _on_
+
+-->
+
+<!-- QUERY I: Is prerendered-icon OK?
+
+ #### Prerendered Icon
+
+* `prerendered-icon` with values `true` or `false`
+
+ * example: `<preference name="prerendered-icon" value="true" />`
+
+ * if icon is prerendered, iOS will not apply it's gloss to the app's
+ icon on the user's home screen
+
+ * default is _false_
+
+-->
+
+<!-- QUERY I: Is deprecated stay-in-webview still enabled?
+
+ #### Open all links in WebView
+
+* __Deprecated__ -- use <a
+ href="http://docs.phonegap.com/en/2.9.0/cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a>
+ with target equal to '_self' (webview), '_blank' (InAppBrowser),
+ '_system' (system web browser)
+
+* `stay-in-webview` with values `true` or `false`
+
+ * example: `<preference name="stay-in-webview" value="true" />`
+
+ * if set to true, all links (even with target set to blank) will
+ open in the app's webview
+
+ * only use this preference if you want pages from your server to
+ take over your entire app
+
+ * default is _false_
+
+-->
+
+<!-- QUERY I: Is ios-statusbarstyle OK?
+
+ #### Status Bar Style
+
+* `ios-statusbarstyle` with values `default`, `black-opaque` or
+ `black-translucent`
+
+ * example: `<preference name="ios-statusbarstyle" value="black-opaque" />`
+
+ * default is a grey status bar, `black-opaque` will appear black
+
+ * although `black-translucent` is supported, the PhoneGap webview
+ does not extend beneath the status bar, so it will appear
+ identical to `black-opaque` once your app is running
+
+-->
+
+<!-- QUERY I: Is detect-data-types OK?
+
+ #### Detect Data Types
+
+* `detect-data-types` with values `true` or `false`
+
+ * example: `<preference name="detect-data-types" value="false" />`
+
+ * controls whether certain data types (such as phone numbers and
+ dates) are automatically turned into links by the system. Defaults
+ to "true" (as does the system web view)
+
+ * supported on PhoneGap 2.0.0 and above
+
+-->
+
+<!-- QUERY I: Is exit-on-suspend OK?
+
+ #### Exit On Suspend
+
+* `exit-on-suspend` with values `true` or `false`
+
+ * example: `<preference name="exit-on-suspend" value="true" />`
+
+ * if set to true, app will terminate when suspended, for example
+ when home button is pressed
+
+ * default is _false_
+
+-->
+
+<!-- QUERY I: Is show-splash-screen-spinner OK?
+
+ #### Show Splash Screen Spinner
+
+* `show-splash-screen-spinner` with values `true` or `false`
+
+ * example: `<preference name="show-splash-screen-spinner"
+ value="false" />`
+
+ * if set to false, the spinner won't appear on the splash screen
+ during app loading
+
+ * default is _true_
+
+-->
+
+<!-- QUERY I: Is auto-hide-splash-screen OK?
+
+ #### Auto-Hide Splash Screen
+
+* `auto-hide-splash-screen` with values `true` or `false`
+
+ * example: `<preference name="auto-hide-splash-screen" value="false"
+ />`
+
+ * if set to false, the splash screen must be hidden using a
+ JavaScript API
+
+ * default is _true_
+
+-->
+
+## Custom URL Schemes
+
+On iOS, adding a `<gap:url-scheme>` element allows you to register
+[custom URL schemes](https://developer.apple.com/library/ios/documentation/iPhone/Conceptual/iPhoneOSProgrammingGuide/AdvancedAppTricks/AdvancedAppTricks.html#//apple_ref/doc/uid/TP40007072-CH7-SW50), as in the following example:
+
+ <gap:url-scheme name="com.acme.myscheme" role="None">
+ <scheme>pgbr</scheme>
+ <scheme>pgbw</scheme>
+ </gap:url-scheme>
+
+The optional `name` attribute defaults to the app's bundle id. It must
+be unique, otherwise the build fails. The optional `role` must be
+either `Editor`, `Viewer`, `Shell`, or `None`. At least one `scheme`
+must be registered.
+
[13/50] docs commit: [CB-3820] rm PGB-specific icon/splash content
Posted by mw...@apache.org.
[CB-3820] rm PGB-specific icon/splash content
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/fba8aa98
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/fba8aa98
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/fba8aa98
Branch: refs/heads/master
Commit: fba8aa981c023dcc32f5cb62e0eebaeec0e56fc3
Parents: 156d34b
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 12:43:28 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:01:51 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 1 -
docs/en/edge/guide/platforms/android/config.md | 19 ----------
.../edge/guide/platforms/blackberry10/config.md | 16 ---------
docs/en/edge/guide/platforms/ios/config.md | 29 ---------------
docs/en/edge/guide/platforms/wp8/config.md | 38 --------------------
5 files changed, 103 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fba8aa98/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 6ba6eca..98c71e4 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -40,7 +40,6 @@ See the following sections for platform-specific options:
- iOS Configuration
- Android Configuration
- BlackBerry Configuration
-- Windows Phone Configuration
## Core Configuration Elements
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fba8aa98/docs/en/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/config.md b/docs/en/edge/guide/platforms/android/config.md
index e973780..90e44e0 100644
--- a/docs/en/edge/guide/platforms/android/config.md
+++ b/docs/en/edge/guide/platforms/android/config.md
@@ -24,25 +24,6 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to Android builds. See The
config.xml File for information on global configuration options.
-## Icons and Splash Screens
-
-Cordova supports images for _ldpi_, _mdpi_, _hdpi_, and _xhdpi_
-displays. The following defines icons for each type of screen:
-
- <icon src="icons/android/ldpi.png" gap:platform="android" gap:density="ldpi" />
- <icon src="icons/android/mdpi.png" gap:platform="android" gap:density="mdpi" />
- <icon src="icons/android/hdpi.png" gap:platform="android" gap:density="hdpi" />
- <icon src="icons/android/xhdpi.png" gap:platform="android" gap:density="xhdpi" />
-
-The following defines splash screens for each screen type:
-
- <gap:splash src="splash/android/ldpi.png" gap:platform="android" gap:density="ldpi" />
- <gap:splash src="splash/android/mdpi.png" gap:platform="android" gap:density="mdpi" />
- <gap:splash src="splash/android/hdpi.png" gap:platform="android" gap:density="hdpi" />
- <gap:splash src="splash/android/xhdpi.png" gap:platform="android" gap:density="xhdpi" />
-
-## Android Preferences
-
<!-- QUERY A: is useBrowserHistory deprecated?
* `UseBrowserHistory` (boolean, defaults to `true`): set to `false` if
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fba8aa98/docs/en/edge/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/blackberry10/config.md b/docs/en/edge/guide/platforms/blackberry10/config.md
index f254c88..7126428 100644
--- a/docs/en/edge/guide/platforms/blackberry10/config.md
+++ b/docs/en/edge/guide/platforms/blackberry10/config.md
@@ -24,22 +24,6 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to BlackBerry 10 builds. See The
config.xml File for information on global configuration options.
-## Icons and Splash Screens
-
-BlackBerry icons __must be smaller__ than 16K. BlackBerry also defines
-an optional hover state that allows a separate icon to display when
-users roll a trackpad cursor over the icon image. By default, the
-non-hover icon displays for the hover state. Define icons as follows:
-
- <icon src="icons/bb/icon.png" gap:platform="blackberry" />
- <icon src="icons/bb/icon_hover.png" gap:platform="blackberry" gap:state="hover"/>
-
-BlackBerry supports a single splash screen image:
-
- <gap:splash src="splash/bb/splash.png" gap:platform="blackberry" />
-
-## BlackBerry 10 Preferences
-
* `ChildBrowser`: Disables child browser windows. By default, when the
content attempts to open a resource in a new window or tab (by using
window.open(), or by specifying `_blank` as the target of an
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fba8aa98/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 3f6ac4b..2743e65 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -24,35 +24,6 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to iOS builds. See The config.xml
File for information on global configuration options.
-## Icons and Splash Screens
-
-Cordova supports icons for _classic_, _retina_, _iPad_, and _retina
-iPad_ displays (the latter as of Cordova 2.5). The following defines
-icons for each type of screen:
-
- <icon src="icons/ios/icon.png" gap:platform="ios" width="57" height="57" />
- <icon src="icons/ios/icon-72.png" gap:platform="ios" width="72" height="72" />
- <icon src="icons/ios/icon_at_2x.png" gap:platform="ios" width="114" height="114" />
- <!-- retina iPad -->
- <icon src="icons/ios/icon-72_at_2x.png" gap:platform="ios" width="144" height="144" />
-
-Cordova supports splash screens for _classic_, _retina_, _iPhone 5_,
-and _iPad_ displays. Standard iPads have two different splash screens
-for portrait and landscape orientation. Retina iPads have two
-additional splash screens: retina portrait and retina landscape. The
-following defines splash screens for each type of screen:
-
- <gap:splash src="splash/ios/Default.png" gap:platform="ios" width="320" height="480" />
- <gap:splash src="splash/ios/Default_at_2x.png" gap:platform="ios" width="640" height="960" />
- <gap:splash src="splash/ios/Default_iphone5.png" gap:platform="ios" width="640" height="1136" />
- <gap:splash src="splash/ios/Default-Landscape.png" gap:platform="ios" width="1024" height="748" />
- <gap:splash src="splash/ios/Default-Portrait.png" gap:platform="ios" width="768" height="1004" />
- <!-- retina iPad -->
- <gap:splash src="splash/ios/Default-Landscape_at_2x.png" gap:platform="ios" width="2048" height="1496" />
- <gap:splash src="splash/ios/Default-Portrait_at_2x.png" gap:platform="ios" width="1536" height="2008" />
-
-## iOS Preferences
-
* `TopActivityIndicator` (string, defaults to `gray`): controls the
appearance of the small spinning icon that appears in the
status/battery bar to indicate a demanding process is executing.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fba8aa98/docs/en/edge/guide/platforms/wp8/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/wp8/config.md b/docs/en/edge/guide/platforms/wp8/config.md
deleted file mode 100644
index 6b8fe1b..0000000
--- a/docs/en/edge/guide/platforms/wp8/config.md
+++ /dev/null
@@ -1,38 +0,0 @@
----
-license: Licensed to the Apache Software Foundation (ASF) under one
- or more contributor license agreements. See the NOTICE file
- distributed with this work for additional information
- regarding copyright ownership. The ASF licenses this file
- to you under the Apache License, Version 2.0 (the
- "License"); you may not use this file except in compliance
- with the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing,
- software distributed under the License is distributed on an
- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- KIND, either express or implied. See the License for the
- specific language governing permissions and limitations
- under the License.
----
-
-# Windows Phone Configuration
-
-The `config.xml` file controls an app's basic settings that apply
-across each application and CordovaWebView instance. This section
-lists image-related settings that only apply to Windows Phone builds.
-See The config.xml File for information on global configuration
-options.
-
-Cordova supports two kinds of Windows Phone icons, a regular icon and
-a background tile image:
-
- <icon src="icons/winphone/icon.png" gap:platform="winphone" />
- <icon src="icons/winphone/tileicon.png" gap:platform="winphone" gap:role="background" />
-
-Windows Phone supports a single splash screen image as shown below.
-Unlike other platforms, the image should be in _jpg_ format:
-
- <gap:splash src="splash/winphone/splash.jpg" gap:platform="winphone" />
-
[24/50] docs commit: [CB-3820] minor change to
HideKeyboardFormAccessoryBar
Posted by mw...@apache.org.
[CB-3820] minor change to HideKeyboardFormAccessoryBar
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/914ea8f1
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/914ea8f1
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/914ea8f1
Branch: refs/heads/master
Commit: 914ea8f1e477b7c467d1d052e345b422d1d76077
Parents: 7243e18
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 15:27:58 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:03:17 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/914ea8f1/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index fb6dc19..fdd0739 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -136,7 +136,7 @@ all of them:
* `HideKeyboardFormAccessoryBar` (boolean, defaults to `false`): set
to `true` to hide the additional toolbar that appears above the
- keyboard and helps users navigate from one form input to the next.
+ keyboard, helping users navigate from one form input to another.
<preference name="HideKeyboardFormAccessoryBar" value="true"/>
[26/50] docs commit: [CB-3820] no custom URL schemes iOS pref in
COrdova
Posted by mw...@apache.org.
[CB-3820] no custom URL schemes iOS pref in COrdova
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/14db3bf9
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/14db3bf9
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/14db3bf9
Branch: refs/heads/master
Commit: 14db3bf954bf1e11002c660e070833c406c3d617
Parents: ac9f67d
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 15:33:42 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:03:31 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 15 ---------------
1 file changed, 15 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/14db3bf9/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 2743e65..38b3751 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -266,18 +266,3 @@ File for information on global configuration options.
-->
-## Custom URL Schemes
-
-On iOS, adding a `<gap:url-scheme>` element allows you to register
-[custom URL schemes](https://developer.apple.com/library/ios/documentation/iPhone/Conceptual/iPhoneOSProgrammingGuide/AdvancedAppTricks/AdvancedAppTricks.html#//apple_ref/doc/uid/TP40007072-CH7-SW50), as in the following example:
-
- <gap:url-scheme name="com.acme.myscheme" role="None">
- <scheme>pgbr</scheme>
- <scheme>pgbw</scheme>
- </gap:url-scheme>
-
-The optional `name` attribute defaults to the app's bundle id. It must
-be unique, otherwise the build fails. The optional `role` must be
-either `Editor`, `Viewer`, `Shell`, or `None`. At least one `scheme`
-must be registered.
-
[43/50] docs commit: [CB-3820] backgroundColor overrides page-wide CSS
Posted by mw...@apache.org.
[CB-3820] backgroundColor overrides page-wide CSS
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/fa58d415
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/fa58d415
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/fa58d415
Branch: refs/heads/master
Commit: fa58d415dea105a143bc50f5b11178965c610b29
Parents: 5b2beeb
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:38:53 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:05:33 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 11 +++++------
1 file changed, 5 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fa58d415/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index b7eeeed..71f4647 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -126,15 +126,14 @@ all of them:
the content.
* `BackgroundColor`: Set the app's background color. Supports a
- four-byte hex value, with the first byte representing an alpha
+ four-byte hex value, with the first byte representing the alpha
channel, and standard RGB values for the following three bytes. This
- example specifies red:
+ example specifies blue:
- <preference name="backgroundColor" value="0xffff0000"/>
+ <preference name="backgroundColor" value="0xff0000ff"/>
- Applies to Android and BlackBerry.
-
-<!-- QUERY: does this override CSS such as "body {background-color:black}"? -->
+ Applies to Android and BlackBerry. Overrides CSS otherwise available
+ across _all_ platforms, for example: `body{background-color:blue}`.
* `HideKeyboardFormAccessoryBar` (boolean, defaults to `false`): set
to `true` to hide the additional toolbar that appears above the
[12/50] docs commit: [CB-3820] rm PGB-specific content
Posted by mw...@apache.org.
[CB-3820] rm PGB-specific content
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/156d34b1
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/156d34b1
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/156d34b1
Branch: refs/heads/master
Commit: 156d34b1a409677b56ce41531e3f00cd384b9981
Parents: 9df47dc
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 12:33:48 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:01:43 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 29 +++--------------------------
1 file changed, 3 insertions(+), 26 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/156d34b1/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 1381146..6ba6eca 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -69,20 +69,12 @@ platforms:
reverse-domain identifier, and the `version` its full version number
expressed in major/minor/patch notation.
- For Android builds, an optional `versionCode` attribute allows you
- to express the version number
- [as an integer](http://developer.android.com/guide/publishing/versioning.html).
-
- The `<name>` element specifies the app's formal name, as it appears
on the device's home screen and within app-store interfaces.
- If you are targeting the BlackBerry platform, use only Latin characters.
-
- The `<description>` and `<author>` elements specify metadata and
contact information that may appear within app-store listings.
- If you are targeting the BlackBerry platform, keep the description short.
-
- The optional `<content>` element defines your application's starting
page in the top-level web assets directory. The default value is
`index.html`, which customarily appears in a project's top-level
@@ -100,9 +92,9 @@ platforms:
The following global preferences apply to all platforms:
-- `orientation` allows you to fix orientation and prevent changes
- from rotating the interface. Possible values are `default`,
- `landscape`, or `portrait`. Example:
+- `orientation` allows you to lock orientation and prevent the
+ interface from rotating in response to changes in orientation.
+ Possible values are `default`, `landscape`, or `portrait`. Example:
<preference name="orientation" value="landscape" />
@@ -118,21 +110,6 @@ The following global preferences apply to all platforms:
<preference name="fullscreen" value="true" />
-<!-- PGB
-
-- `phonegap-version` specifies the version of PhoneGap to use when
- building the app using the PhoneGap Build interface, or the CLI's
- `remote` feature described in The Command-line Interface. Example:
-
- <preference name="phonegap-version" value="2.9.0" />
-
- Currently supported versions are __2.0.0__, __2.1.0__, __2.2.0__,
- __2.3.0__, __2.5.0__, __2.7.0__, and __2.9.0__ (the default). all
- versions prior to __2.0.0__ are deprecated. Specifying an
- unsupported version number prevents the project from building.
-
--->
-
## Multi-platform Preferences
The following preferences apply to more than one platform, but not to
[05/50] docs commit: [CB-3820] HideKeyboardFormAccessoryBar is for
iOS & BB
Posted by mw...@apache.org.
[CB-3820] HideKeyboardFormAccessoryBar is for iOS & BB
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/5b9579c1
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/5b9579c1
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/5b9579c1
Branch: refs/heads/master
Commit: 5b9579c119d0122a7615cf129b5e09b36a57aee8
Parents: 11627d8
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 13 15:41:19 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 13:59:58 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 2 ++
1 file changed, 2 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5b9579c1/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 70375e3..bcb8227 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -164,6 +164,8 @@ all of them:
<preference name="HideKeyboardFormAccessoryBar" value="true"/>
+ Applies to iOS and BlackBerry.
+
<!-- QUERY: for HideKeyboardFormAccessoryBar, does form-helper UI only appear when there's >1 input? -->
<!-- BB version:
[10/50] docs commit: [CB-3820] query re loadingDialog &
loadingPageDialog usage not important
Posted by mw...@apache.org.
[CB-3820] query re loadingDialog & loadingPageDialog usage not important
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/f885c0c9
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/f885c0c9
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/f885c0c9
Branch: refs/heads/master
Commit: f885c0c92541a202aa3ba4d54a89e34cdc2d1d4a
Parents: ab7ecda
Author: Mike Sierra <ms...@adobe.com>
Authored: Wed Sep 18 12:58:30 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:00:41 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/config.md | 2 --
1 file changed, 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f885c0c9/docs/en/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/config.md b/docs/en/edge/guide/platforms/android/config.md
index 01ae020..e973780 100644
--- a/docs/en/edge/guide/platforms/android/config.md
+++ b/docs/en/edge/guide/platforms/android/config.md
@@ -64,8 +64,6 @@ The following defines splash screens for each screen type:
<preference name="loadingPageDialog" value="Please wait, the data is loading"/>
-<!-- QUERY A: unclear when loadingDialog & loadingPageDialog would appear. Any examples? -->
-
* `ErrorUrl`: Set the error page for your application. Should be
located in your Android project in `file://android_asset/www/`
[47/50] docs commit: [CB-3820] tighten up text for BB prefs
Posted by mw...@apache.org.
[CB-3820] tighten up text for BB prefs
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/1a18b54c
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/1a18b54c
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/1a18b54c
Branch: refs/heads/master
Commit: 1a18b54c2197610bb4a8c5a82df4719d6956c2f5
Parents: 2fb247f
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 12:06:27 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:05:59 2013 +0200
----------------------------------------------------------------------
.../edge/guide/platforms/blackberry10/config.md | 31 ++++++++++----------
1 file changed, 16 insertions(+), 15 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/1a18b54c/docs/en/edge/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/blackberry10/config.md b/docs/en/edge/guide/platforms/blackberry10/config.md
index 2199f63..8abaffe 100644
--- a/docs/en/edge/guide/platforms/blackberry10/config.md
+++ b/docs/en/edge/guide/platforms/blackberry10/config.md
@@ -24,27 +24,28 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to BlackBerry 10 builds. See The
config.xml File for information on global configuration options.
-* `ChildBrowser`: Disables child browser windows. By default, apps
- launch a secondary browser window to display resources accessed via
- `window.open()` or by specifying a `_blank` anchor target. Specify
- `disable` to override this default behavior.
+* `ChildBrowser` (`disable` or the default `enable`): Disables child
+ browser windows. By default, apps launch a secondary browser window
+ to display resources accessed via `window.open()` or by specifying a
+ `_blank` anchor target. Specify `disable` to override this default
+ behavior.
<preference name="ChildBrowser" value="disable"/>
-* `PopupBlocker`: Enables the popup blocker, which prevents calls to
- `window.open()`. By default, popups display in a child browser
- window. Setting the preference to `enable` prevents it from
- displaying at all.
+* `PopupBlocker` (`enable` or the default `disable`): Enables the
+ popup blocker, which prevents calls to `window.open()`. By default,
+ popups display in a child browser window. Setting the preference to
+ `enable` prevents it from displaying at all.
<preference name="PopupBlocker" value="enable"/>
-* `WebSecurity`: Disables web security. Disabling web security allows
- you to access remote content from unknown sources during
- development. Before packaging your app for distribution, you should
- remove this setting. This feature is intended as a development
- convenience only. In production, all URIs should be known and should
- be whitelisted using the `<access>` element. To disable, specify
- value as `disable`.
+* `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
+ distribution. For the released app, all URIs should be known and
+ whitelisted using the `<access>` element, described in the Domain
+ Whitelist Guide.
<preference name="WebSecurity" value="disable"/>
[40/50] docs commit: [CB-3820] assume show-splash-screen-spinner ios
pref is PGB-only; superseded in CV by CamelCase variant
Posted by mw...@apache.org.
[CB-3820] assume show-splash-screen-spinner ios pref is PGB-only; superseded in CV by CamelCase variant
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/15183ffc
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/15183ffc
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/15183ffc
Branch: refs/heads/master
Commit: 15183ffc6775d9b4dcc757abe0b256fb60b81858
Parents: 1ea2cb4
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:17:01 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:05:12 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 16 ----------------
1 file changed, 16 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/15183ffc/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 0e7e305..0ccff17 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -102,22 +102,6 @@ File for information on global configuration options.
<preference name="KeyboardShrinksView" value="true"/>
-<!-- QUERY I: Is show-splash-screen-spinner OK?
-
- #### Show Splash Screen Spinner
-
-* `show-splash-screen-spinner` with values `true` or `false`
-
- * example: `<preference name="show-splash-screen-spinner"
- value="false" />`
-
- * if set to false, the spinner won't appear on the splash screen
- during app loading
-
- * default is _true_
-
--->
-
<!-- QUERY I: Is auto-hide-splash-screen OK?
#### Auto-Hide Splash Screen
[18/50] docs commit: [CB-3820] KeepRunning keeps app running after
pause event
Posted by mw...@apache.org.
[CB-3820] KeepRunning keeps app running after pause event
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/d23e0391
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/d23e0391
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/d23e0391
Branch: refs/heads/master
Commit: d23e039189798f2ee62a22a7130794bc5c3a0865
Parents: 7ba945e
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 13:11:41 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:02:28 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/config.md | 7 +++----
1 file changed, 3 insertions(+), 4 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/d23e0391/docs/en/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/config.md b/docs/en/edge/guide/platforms/android/config.md
index 2b420e7..02dc6c1 100644
--- a/docs/en/edge/guide/platforms/android/config.md
+++ b/docs/en/edge/guide/platforms/android/config.md
@@ -46,13 +46,12 @@ config.xml File for information on global configuration options.
<preference name="LoadUrlTimeoutValue" value="10000"/>
-* `KeepRunning` (boolean, defaults to `true`): Determines whether
- Cordova stays running in the background.
+* `KeepRunning` (boolean, defaults to `true`): Determines whether the
+ application stays running in the background even after a `pause`
+ event fires.
<preference name="KeepRunning" value="false"/>
-<!-- QUERY A: does keepRunning mean in effect the app continues to execute following pause event? Does event still fire? -->
-
* `SplashScreen`: The name of the file minus its extension in the
`res/drawable` directory. Various assets must share this common
name in various subdirectories. For details, see the _Icons and
[20/50] docs commit: [CB-3820] rm PGB-only Android compile prefs
Posted by mw...@apache.org.
[CB-3820] rm PGB-only Android compile prefs
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/474286ff
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/474286ff
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/474286ff
Branch: refs/heads/master
Commit: 474286ff6bcc5327ad0ca3faf45ef54982d07071
Parents: 087cabc
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 13:20:26 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:02:42 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/config.md | 40 ---------------------
1 file changed, 40 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/474286ff/docs/en/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/config.md b/docs/en/edge/guide/platforms/android/config.md
index 02dc6c1..668e134 100644
--- a/docs/en/edge/guide/platforms/android/config.md
+++ b/docs/en/edge/guide/platforms/android/config.md
@@ -64,43 +64,3 @@ config.xml File for information on global configuration options.
<preference name="SplashScreenDelay" value="10000"/>
-<!-- QUERY PGB A: do android-minSdkVersion, android-maxSdkVersion apply outside PG Build?
-
- #### Minimum and Maximum SDK Version
-
-* `android-minSdkVersion` and/or `android-maxSdkVersion`, with integer
- values
-
- * minSdkVersion example: `<preference name="android-minSdkVersion" value="10" />`
-
- * maxSdkVersion example: `<preference name="android-maxSdkVersion" value="15" />`
-
- * corresponds to the `usesSdk` attributes in the
- `AndroidManifest.xml` file - more details are in [the Android
- documentation](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html)
-
- * minSdkVersion defaults to 7 (Android 2.1); maxSdkVersion is unset
- by default
-
--->
-
-<!-- QUERY A: does android-installLocation apply outside PGB?
-
- #### Install Location
-
-* `android-installLocation` with values `internalOnly`, `auto` or `preferExternal`
-
- * example: `<preference name="android-installLocation" value="auto"
- />`
-
- * where an app can be installed - defaults to `internalOnly` (as the
- Android SDK)
-
- * `auto` or `preferExternal` allow the app to be installed on an SD
- card - this can lead to unexpected behavior
-
- * more details available in [the Android
- documentation](http://developer.android.com/guide/appendix/install-location.html)
-
--->
-
Posted by mw...@apache.org.
assertion: <a target='_blank'> opens inAppBrowser
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/6682f624
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/6682f624
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/6682f624
Branch: refs/heads/master
Commit: 6682f624ae895e84bda21ee9a74f613d72411423
Parents: dd96e2b
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 15:47:49 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:03:48 2013 +0200
----------------------------------------------------------------------
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/6682f624/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 714a43f..8751046 100644
--- a/docs/en/edge/cordova/inappbrowser/inappbrowser.md
+++ b/docs/en/edge/cordova/inappbrowser/inappbrowser.md
@@ -19,7 +19,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one
# InAppBrowser
-> The `InAppBrowser` is a web browser view that displays when calling `window.open`.
+> The `InAppBrowser` is a web browser view that displays when calling `window.open()`, or when opening a link formed as `<a target="_blank">`.
var ref = window.open('http://apache.org', '_blank', 'location=yes');
[31/50] docs commit: [CB-3820] yes,
cordova webviews support the viewport metatag
Posted by mw...@apache.org.
[CB-3820] yes, cordova webviews support the viewport metatag
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/d967edc5
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/d967edc5
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/d967edc5
Branch: refs/heads/master
Commit: d967edc5f6667d3be7c50de51743d91d9ee7cdf8
Parents: b734df7
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:07:37 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:04:09 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/config.md | 2 --
1 file changed, 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/d967edc5/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 0aaf71d..00d2e9b 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -38,8 +38,6 @@ File for information on global configuration options.
<!-- QUERY I: confirm EnableViewportScale allows viewport metatag to control range of scale, including disabling? -->
-<!-- QUERY: Do viewport meta tags work as expected in other environments? -->
-
* `AutoHideSplashScreen` (boolean, defaults to `true`): set to `false`
to use the SplashScreen API to control when the opening image stops
displaying.
[14/50] docs commit: [CB-3820] PGB's splash-screen-duration => CV's
SplashScreenDelay
Posted by mw...@apache.org.
[CB-3820] PGB's splash-screen-duration => CV's SplashScreenDelay
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/26615eae
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/26615eae
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/26615eae
Branch: refs/heads/master
Commit: 26615eaee6d428df01f7366d8c68a9111d76aeb5
Parents: fba8aa9
Author: Mike Sierra <ms...@adobe.com>
Authored: Thu Sep 19 12:57:42 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:01:58 2013 +0200
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/config.md | 36 +++++++--------------
1 file changed, 12 insertions(+), 24 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/26615eae/docs/en/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/config.md b/docs/en/edge/guide/platforms/android/config.md
index 90e44e0..9e43ad9 100644
--- a/docs/en/edge/guide/platforms/android/config.md
+++ b/docs/en/edge/guide/platforms/android/config.md
@@ -31,31 +31,31 @@ config.xml File for information on global configuration options.
hashtag error present in Android 3.x prior to the history fix.
(Note: This setting will be deprecated in April 2013)
- <preference name="useBrowserHistory" value="false"/>
+ <preference name="UseBrowserHistory" value="false"/>
-->
* `LoadingDialog`: Display a native loading dialog when loading the
app. The value's format is _Title, Message_
- <preference name="loadingDialog" value="Please wait, the app is loading"/>
+ <preference name="LoadingDialog" value="Please wait, the app is loading"/>
* `LoadingPageDialog`: Display a native loading dialog when loading
sub-pages. The value's format is _Title, Message_
- <preference name="loadingPageDialog" value="Please wait, the data is loading"/>
+ <preference name="LoadingPageDialog" value="Please wait, the data is loading"/>
* `ErrorUrl`: Set the error page for your application. Should be
located in your Android project in `file://android_asset/www/`
- <preference name="errorUrl" value="error.html"/>
+ <preference name="ErrorUrl" value="error.html"/>
<!-- QUERY A: under what conditions does the errorUrl page display? -->
* `LoadUrlTimeoutValue`: How much time Cordova should wait before
throwing a timeout error on the application.
- <preference name="loadUrlTimeoutValue" value="20000"/>
+ <preference name="LoadUrlTimeoutValue" value="20000"/>
<!-- QUERY A: is loadUrlTimeoutValue expressed in milliseconds? is 20000 the default?-->
@@ -74,7 +74,7 @@ config.xml File for information on global configuration options.
* `KeepRunning` (boolean, defaults to `true`): Determines whether
Cordova stays running in the background.
- <preference name="keepRunning" value="false"/>
+ <preference name="KeepRunning" value="false"/>
<!-- QUERY A: does keepRunning mean in effect the app continues to execute following pause event? Does event still fire? -->
@@ -83,7 +83,12 @@ config.xml File for information on global configuration options.
name in various subdirectories. For details, see the _Icons and
Splash Screens_ section in The config.xml File.
- <preference name="splashscreen" value="splash"/>
+ <preference name="SplashScreen" value="splash"/>
+
+* `SplashScreenDelay` (number, defaults to `5000`): The amount of
+ time the splash screen image displays.
+
+ <preference name="SplashScreenDelay" value="10000"/>
<!-- QUERY PGB A: do android-minSdkVersion, android-maxSdkVersion apply outside PG Build?
@@ -125,20 +130,3 @@ config.xml File for information on global configuration options.
-->
-<!-- QUERY A: does splash-screen-duration apply outside PGB?
-
- #### Splash Screen Duration
-
- * `splash-screen-duration` with a value in milliseconds
-
- * defaults to 5000 (5 seconds)
-
- * example: `<preference name="splash-screen-duration" value="10000"
- />`
-
- * for auto-hide behaviour call `navigator.splashscreen.hide();` in
- the device-ready method
-
- * supported on PhoneGap 2.1.0 and above
-
--->
[44/50] docs commit: [CB-3820] reimplemented changes accidentally
overwritten
Posted by mw...@apache.org.
[CB-3820] reimplemented changes accidentally overwritten
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/61a4b975
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/61a4b975
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/61a4b975
Branch: refs/heads/master
Commit: 61a4b9750b3450bc39186121dfe50140779a75b0
Parents: fa58d41
Author: Mike Sierra <ms...@adobe.com>
Authored: Fri Sep 20 11:50:24 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Sat Sep 21 14:05:40 2013 +0200
----------------------------------------------------------------------
docs/en/edge/config_ref/index.md | 22 +-
.../edge/guide/platforms/blackberry10/config.md | 6 +-
docs/en/edge/guide/platforms/ios/config.md | 209 -------------------
3 files changed, 15 insertions(+), 222 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/61a4b975/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 71f4647..56fac38 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -56,8 +56,8 @@ This example shows the default `config.xml` generated by the CLI's
</author>
<content src="index.html" />
<access origin="*" />
- <preference name="fullscreen" value="true" />
- <preference name="webviewbounce" value="true" />
+ <preference name="Fullscreen" value="true" />
+ <preference name="WebViewBounce" value="true" />
</widget>
The following configuration elements appear in the top-level
@@ -83,19 +83,21 @@ platforms:
allowed to communicate with. The default value shown above allows it
to access any server. See the Domain Whitelist Guide for details.
-- The `<preference>` tag sets various options, many of which are
- unique to specific platforms. The following sections detail
- preferences that apply to more than one platform.
+- The `<preference>` tag sets various options as pairs of
+ `name`/`value` attributes. Each preference's `name` is
+ case-insensitive. Many preferences are unique to specific
+ platforms, as listed at the top of this page. The following sections
+ detail preferences that apply to more than one platform.
## Global Preferences
The following global preferences apply to all platforms:
-- `orientation` allows you to lock orientation and prevent the
+- `Orientation` allows you to lock orientation and prevent the
interface from rotating in response to changes in orientation.
Possible values are `default`, `landscape`, or `portrait`. Example:
- <preference name="orientation" value="landscape" />
+ <preference name="Orientation" value="landscape" />
__NOTE:__ The `default` value means _both_ landscape and portrait
orientations are enabled. If you want to use each platform's
@@ -104,10 +106,10 @@ The following global preferences apply to all platforms:
in its `config.xml` file. If you specify `default` in the global
`config.xml`, it translates to `auto` in the BlackBerry build.
-- `fullscreen` allows you to hide the status bar at the top of the
+- `Fullscreen` allows you to hide the status bar at the top of the
screen. The default value is `false`. Example:
- <preference name="fullscreen" value="true" />
+ <preference name="Fullscreen" value="true" />
## Multi-platform Preferences
@@ -130,7 +132,7 @@ all of them:
channel, and standard RGB values for the following three bytes. This
example specifies blue:
- <preference name="backgroundColor" value="0xff0000ff"/>
+ <preference name="BackgroundColor" value="0xff0000ff"/>
Applies to Android and BlackBerry. Overrides CSS otherwise available
across _all_ platforms, for example: `body{background-color:blue}`.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/61a4b975/docs/en/edge/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/blackberry10/config.md b/docs/en/edge/guide/platforms/blackberry10/config.md
index d1d82c8..2199f63 100644
--- a/docs/en/edge/guide/platforms/blackberry10/config.md
+++ b/docs/en/edge/guide/platforms/blackberry10/config.md
@@ -29,14 +29,14 @@ config.xml File for information on global configuration options.
`window.open()` or by specifying a `_blank` anchor target. Specify
`disable` to override this default behavior.
- <preference name="childBrowser" value="disable"/>
+ <preference name="ChildBrowser" value="disable"/>
* `PopupBlocker`: Enables the popup blocker, which prevents calls to
`window.open()`. By default, popups display in a child browser
window. Setting the preference to `enable` prevents it from
displaying at all.
- <preference name="popupBlocker" value="enable"/>
+ <preference name="PopupBlocker" value="enable"/>
* `WebSecurity`: Disables web security. Disabling web security allows
you to access remote content from unknown sources during
@@ -46,5 +46,5 @@ config.xml File for information on global configuration options.
be whitelisted using the `<access>` element. To disable, specify
value as `disable`.
- <preference name="webSecurity" value="disable"/>
+ <preference name="WebSecurity" value="disable"/>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/61a4b975/docs/en/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/config.md b/docs/en/edge/guide/platforms/ios/config.md
index 5a7ac61..f81b6b1 100644
--- a/docs/en/edge/guide/platforms/ios/config.md
+++ b/docs/en/edge/guide/platforms/ios/config.md
@@ -24,53 +24,12 @@ across each application and CordovaWebView instance. This section
details preferences that only apply to iOS builds. See The config.xml
File for information on global configuration options.
-## Icons and Splash Screens
-
-Cordova supports icons for _classic_, _retina_, _iPad_, and _retina
-iPad_ displays (the latter as of Cordova 2.5). The following defines
-icons for each type of screen:
-
- <icon src="icons/ios/icon.png" gap:platform="ios" width="57" height="57" />
- <icon src="icons/ios/icon-72.png" gap:platform="ios" width="72" height="72" />
- <icon src="icons/ios/icon_at_2x.png" gap:platform="ios" width="114" height="114" />
- <!-- retina iPad -->
- <icon src="icons/ios/icon-72_at_2x.png" gap:platform="ios" width="144" height="144" />
-
-Cordova supports splash screens for _classic_, _retina_, _iPhone 5_,
-and _iPad_ displays. Standard iPads have two different splash screens
-for portrait and landscape orientation. Retina iPads have two
-additional splash screens: retina portrait and retina landscape. The
-following defines splash screens for each type of screen:
-
- <gap:splash src="splash/ios/Default.png" gap:platform="ios" width="320" height="480" />
- <gap:splash src="splash/ios/Default_at_2x.png" gap:platform="ios" width="640" height="960" />
- <gap:splash src="splash/ios/Default_iphone5.png" gap:platform="ios" width="640" height="1136" />
- <gap:splash src="splash/ios/Default-Landscape.png" gap:platform="ios" width="1024" height="748" />
- <gap:splash src="splash/ios/Default-Portrait.png" gap:platform="ios" width="768" height="1004" />
- <!-- retina iPad -->
- <gap:splash src="splash/ios/Default-Landscape_at_2x.png" gap:platform="ios" width="2048" height="1496" />
- <gap:splash src="splash/ios/Default-Portrait_at_2x.png" gap:platform="ios" width="1536" height="2008" />
-
-## iOS Preferences
-
* `TopActivityIndicator` (string, defaults to `gray`): this is the top
spinning throbber in the status/battery bar, valid values are
`whiteLarge`, `white`, and `gray`.
<preference name="TopActivityIndicator" value="white"/>
-<!-- QUERY I: describe TopActivityIndicator top spinning throbber -->
-
-* `EnableLocation` (boolean, defaults to `false`): set to `true`, to
- initialize the Geolocation plugin at start-up (so the fix on your
- location can be more accurate) __DEPRECATED__: please set the
- `onload` attribute of the `Geolocation` plugin to `true`
- instead.
-
- <preference name="EnableLocation" value="true"/>
-
-<!-- QUERY I: is deprecated EnableLocation still functional? -->
-
* `EnableViewportScale` (boolean, defaults to `false`): set to `true` to
prevent viewport scaling through a meta tag.
@@ -78,8 +37,6 @@ following defines splash screens for each type of screen:
<!-- QUERY I: confirm EnableViewportScale allows viewport metatag to control range of scale, including disabling? -->
-<!-- QUERY: Do viewport meta tags work as expected in other environments? -->
-
* `FadeSplashScreen` (boolean, defaults to `true`): set to `false` to
prevent the splash-screen to fade in and out when showing or hiding
it.
@@ -96,15 +53,11 @@ following defines splash screens for each type of screen:
<preference name="ShowSplashScreenSpinner" value="false"/>
-<!-- QUERY I: for ShowSplashScreenSpinner describe spinner -->
-
* `MediaPlaybackRequiresUserAction` (boolean, defaults to `false`): set
to `true` to not allow autoplayed HTML5 video.
<preference name="MediaPlaybackRequiresUserAction" value="true"/>
-<!-- QUERY I: does MediaPlaybackRequiresUserAction also apply to audio? -->
-
* `AllowInlineMediaPlayback` (boolean, defaults to `false`): set to
`true` to allow inline HTML5 media playback, also, the video element
in the HTML document must also include the webkit-playsinline
@@ -141,167 +94,5 @@ following defines splash screens for each type of screen:
<preference name="KeyboardShrinksView" value="true"/>
-<!-- QUERY I: describe KeyboardShrinksView; shrink webview when keyboard appears -->
-
-<!-- QUERY I: is target-device OK?
-
- #### Target a Specific Device
-
-* `target-device` with possible values `handset`, `tablet`, or
- `universal`
-
- * example: `<preference name="target-device" value="universal" />`
-
- * please note that this currently only applies to iOS builds; by
- default all builds are universal
-
--->
-
-<!-- QUERY I: Is webviewbounce OK?
-
- #### WebView Bounce
-
-* `webviewbounce` with values `true` or `false`
-
- <preference name="webviewbounce" value="fubar"/>
-
- * example: `<preference name="webviewbounce" value="false" />`
-
- * controls whether the screen "bounces" when scrolled beyond the top
- or bottom on iOS. By default, the bounce is _on_
-
--->
-
-<!-- QUERY I: Is prerendered-icon OK?
-
- #### Prerendered Icon
-
-* `prerendered-icon` with values `true` or `false`
-
- * example: `<preference name="prerendered-icon" value="true" />`
-
- * if icon is prerendered, iOS will not apply it's gloss to the app's
- icon on the user's home screen
-
- * default is _false_
-
--->
-
-<!-- QUERY I: Is deprecated stay-in-webview still enabled?
-
- #### Open all links in WebView
-
-* __Deprecated__ -- use <a
- href="http://docs.phonegap.com/en/2.9.0/cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a>
- with target equal to '_self' (webview), '_blank' (InAppBrowser),
- '_system' (system web browser)
-
-* `stay-in-webview` with values `true` or `false`
-
- * example: `<preference name="stay-in-webview" value="true" />`
-
- * if set to true, all links (even with target set to blank) will
- open in the app's webview
-
- * only use this preference if you want pages from your server to
- take over your entire app
-
- * default is _false_
-
--->
-
-<!-- QUERY I: Is ios-statusbarstyle OK?
-
- #### Status Bar Style
-
-* `ios-statusbarstyle` with values `default`, `black-opaque` or
- `black-translucent`
-
- * example: `<preference name="ios-statusbarstyle" value="black-opaque" />`
-
- * default is a grey status bar, `black-opaque` will appear black
-
- * although `black-translucent` is supported, the PhoneGap webview
- does not extend beneath the status bar, so it will appear
- identical to `black-opaque` once your app is running
-
--->
-
-<!-- QUERY I: Is detect-data-types OK?
-
- #### Detect Data Types
-
-* `detect-data-types` with values `true` or `false`
-
- * example: `<preference name="detect-data-types" value="false" />`
-
- * controls whether certain data types (such as phone numbers and
- dates) are automatically turned into links by the system. Defaults
- to "true" (as does the system web view)
-
- * supported on PhoneGap 2.0.0 and above
-
--->
-
-<!-- QUERY I: Is exit-on-suspend OK?
-
- #### Exit On Suspend
-
-* `exit-on-suspend` with values `true` or `false`
-
- * example: `<preference name="exit-on-suspend" value="true" />`
-
- * if set to true, app will terminate when suspended, for example
- when home button is pressed
-
- * default is _false_
-
--->
-
-<!-- QUERY I: Is show-splash-screen-spinner OK?
-
- #### Show Splash Screen Spinner
-
-* `show-splash-screen-spinner` with values `true` or `false`
-
- * example: `<preference name="show-splash-screen-spinner"
- value="false" />`
-
- * if set to false, the spinner won't appear on the splash screen
- during app loading
-
- * default is _true_
-
--->
-
-<!-- QUERY I: Is auto-hide-splash-screen OK?
-
- #### Auto-Hide Splash Screen
-
-* `auto-hide-splash-screen` with values `true` or `false`
-
- * example: `<preference name="auto-hide-splash-screen" value="false"
- />`
-
- * if set to false, the splash screen must be hidden using a
- JavaScript API
-
- * default is _true_
-
--->
-
-## Custom URL Schemes
-
-On iOS, adding a `<gap:url-scheme>` element allows you to register
-[custom URL schemes](https://developer.apple.com/library/ios/documentation/iPhone/Conceptual/iPhoneOSProgrammingGuide/AdvancedAppTricks/AdvancedAppTricks.html#//apple_ref/doc/uid/TP40007072-CH7-SW50), as in the following example:
-
- <gap:url-scheme name="com.acme.myscheme" role="None">
- <scheme>pgbr</scheme>
- <scheme>pgbw</scheme>
- </gap:url-scheme>
-The optional `name` attribute defaults to the app's bundle id. It must
-be unique, otherwise the build fails. The optional `role` must be
-either `Editor`, `Viewer`, `Shell`, or `None`. At least one `scheme`
-must be registered.