You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/06/12 19:50:54 UTC
[19/46] docs commit: edits up to menu button event
edits up to menu button 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/6899777b
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/6899777b
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/6899777b
Branch: refs/heads/master
Commit: 6899777bc8c01923b68902d3ffefc8be89cf003a
Parents: 9048602
Author: Mike Sierra <le...@gmail.com>
Authored: Wed May 15 09:52:38 2013 -0400
Committer: Mike Sierra <le...@gmail.com>
Committed: Wed May 15 09:52:38 2013 -0400
----------------------------------------------------------------------
.../accelerometer/acceleration/acceleration.md | 1 -
.../accelerometer/accelerometer.clearWatch.md | 4 +-
.../accelerometer.getCurrentAcceleration.md | 2 +-
.../accelerometer.watchAcceleration.md | 4 +-
docs/en/edge/cordova/camera/camera.cleanup.md | 3 +-
.../en/edge/cordova/camera/camera.getPicture.md | 27 +++----
.../camera/parameter/CameraPopoverOptions.md | 6 +-
.../cordova/camera/parameter/cameraOptions.md | 2 +-
.../edge/cordova/compass/compass.clearWatch.md | 3 +-
.../compass/compass.getCurrentHeading.md | 2 +-
.../cordova/compass/compass.watchHeading.md | 5 +-
.../compass/compassError/compassError.md | 3 +-
.../cordova/compass/parameters/compassError.md | 2 +-
.../compass/parameters/compassSuccess.md | 1 -
.../edge/cordova/connection/connection.type.md | 2 +-
.../en/edge/cordova/contacts/Contact/contact.md | 85 ++++++++++----------
.../contacts/ContactAddress/contactaddress.md | 50 ++++++------
.../contacts/ContactError/contactError.md | 7 +-
.../contacts/ContactField/contactfield.md | 41 +++++++---
.../ContactFindOptions/contactfindoptions.md | 10 +--
.../cordova/contacts/ContactName/contactname.md | 56 ++++++-------
.../ContactOrganization/contactorganization.md | 44 +++++-----
.../en/edge/cordova/contacts/contacts.create.md | 7 +-
docs/en/edge/cordova/contacts/contacts.find.md | 34 +++++---
docs/en/edge/cordova/contacts/contacts.md | 2 +-
.../cordova/contacts/parameters/contactError.md | 4 +-
.../contacts/parameters/contactFields.md | 4 +-
.../contacts/parameters/contactFindOptions.md | 17 ++--
.../contacts/parameters/contactSuccess.md | 9 ++-
docs/en/edge/cordova/device/device.cordova.md | 12 +--
docs/en/edge/cordova/device/device.md | 2 +-
docs/en/edge/cordova/device/device.model.md | 29 ++++---
docs/en/edge/cordova/device/device.name.md | 32 ++++----
docs/en/edge/cordova/device/device.platform.md | 21 ++---
docs/en/edge/cordova/device/device.uuid.md | 30 ++++---
docs/en/edge/cordova/device/device.version.md | 12 +--
.../en/edge/cordova/events/events.backbutton.md | 12 +--
.../cordova/events/events.batterycritical.md | 24 +++---
.../en/edge/cordova/events/events.batterylow.md | 23 +++---
.../edge/cordova/events/events.batterystatus.md | 29 ++++---
.../edge/cordova/events/events.deviceready.md | 21 +++--
.../edge/cordova/events/events.endcallbutton.md | 9 ++-
docs/en/edge/cordova/events/events.md | 2 +-
.../en/edge/cordova/events/events.menubutton.md | 8 +-
docs/en/edge/cordova/events/events.offline.md | 7 +-
docs/en/edge/cordova/events/events.online.md | 7 +-
docs/en/edge/cordova/events/events.pause.md | 13 +--
docs/en/edge/cordova/events/events.resume.md | 19 ++---
.../edge/cordova/events/events.searchbutton.md | 5 +-
.../cordova/events/events.startcallbutton.md | 5 +-
.../cordova/events/events.volumedownbutton.md | 5 +-
.../cordova/events/events.volumeupbutton.md | 5 +-
.../file/directoryentry/directoryentry.md | 16 +---
.../file/directoryreader/directoryreader.md | 3 +-
.../en/edge/cordova/file/fileentry/fileentry.md | 16 +---
.../en/edge/cordova/file/fileerror/fileerror.md | 4 +-
docs/en/edge/cordova/file/fileobj/fileobj.md | 1 -
.../edge/cordova/file/filereader/filereader.md | 8 +-
.../cordova/file/filetransfer/filetransfer.md | 14 ++--
.../file/fileuploadoptions/fileuploadoptions.md | 3 +-
.../file/fileuploadresult/fileuploadresult.md | 2 +-
.../edge/cordova/file/filewriter/filewriter.md | 4 +-
.../file/localfilesystem/localfilesystem.md | 1 -
.../geolocation/Coordinates/coordinates.md | 4 +-
.../cordova/geolocation/Position/position.md | 2 +-
.../geolocation/geolocation.clearWatch.md | 5 +-
.../geolocation.getCurrentPosition.md | 5 +-
docs/en/edge/cordova/geolocation/geolocation.md | 1 -
.../geolocation/geolocation.watchPosition.md | 1 -
.../GlobalizationError/globalizationerror.md | 2 +-
.../globalization/globalization.dateToString.md | 4 +-
.../globalization.getCurrencyPattern.md | 3 +-
.../globalization/globalization.getDateNames.md | 2 -
.../globalization.getFirstDayOfWeek.md | 1 -
.../globalization.getLocaleName.md | 4 +-
.../globalization.getNumberPattern.md | 3 +-
.../globalization.getPreferredLanguage.md | 2 -
.../globalization/globalization.stringToDate.md | 6 +-
.../globalization.stringToNumber.md | 2 -
.../edge/cordova/inappbrowser/inappbrowser.md | 5 +-
.../en/edge/cordova/inappbrowser/window.open.md | 6 +-
.../edge/cordova/media/MediaError/mediaError.md | 1 -
docs/en/edge/cordova/media/capture/CaptureCB.md | 2 +-
.../edge/cordova/media/capture/CaptureError.md | 2 +-
.../cordova/media/capture/ConfigurationData.md | 7 +-
.../media/capture/MediaFile.getFormatData.md | 6 +-
.../edge/cordova/media/capture/MediaFileData.md | 10 +--
docs/en/edge/cordova/media/capture/capture.md | 3 +-
.../edge/cordova/media/capture/captureAudio.md | 10 +--
.../edge/cordova/media/capture/captureImage.md | 13 ++-
.../edge/cordova/media/capture/captureVideo.md | 12 +--
.../cordova/media/media.getCurrentPosition.md | 13 ++-
docs/en/edge/cordova/media/media.getDuration.md | 12 ++-
docs/en/edge/cordova/media/media.md | 4 +-
docs/en/edge/cordova/media/media.pause.md | 14 ++--
docs/en/edge/cordova/media/media.play.md | 13 ++-
docs/en/edge/cordova/media/media.release.md | 11 ++-
docs/en/edge/cordova/media/media.seekTo.md | 12 ++-
docs/en/edge/cordova/media/media.startRecord.md | 12 ++-
docs/en/edge/cordova/media/media.stop.md | 13 ++-
docs/en/edge/cordova/media/media.stopRecord.md | 12 ++-
.../cordova/notification/notification.beep.md | 2 +-
.../notification/notification.confirm.md | 1 -
.../edge/cordova/splashscreen/splashscreen.md | 2 -
.../edge/cordova/storage/database/database.md | 6 +-
.../storage/localstorage/localstorage.md | 3 +-
.../storage/sqlresultset/sqlresultset.md | 6 +-
.../sqlresultsetrowlist/sqlresultsetrowlist.md | 2 +-
.../storage/sqltransaction/sqltransaction.md | 4 +-
109 files changed, 547 insertions(+), 560 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/accelerometer/acceleration/acceleration.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/accelerometer/acceleration/acceleration.md b/docs/en/edge/cordova/accelerometer/acceleration/acceleration.md
index ea72f91..1a2b8e8 100644
--- a/docs/en/edge/cordova/accelerometer/acceleration/acceleration.md
+++ b/docs/en/edge/cordova/accelerometer/acceleration/acceleration.md
@@ -50,7 +50,6 @@ Supported Platforms
- Tizen
- Windows 8
-
Quick Example
-------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/accelerometer/accelerometer.clearWatch.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/accelerometer/accelerometer.clearWatch.md b/docs/en/edge/cordova/accelerometer/accelerometer.clearWatch.md
index e5467f5..148dbce 100644
--- a/docs/en/edge/cordova/accelerometer/accelerometer.clearWatch.md
+++ b/docs/en/edge/cordova/accelerometer/accelerometer.clearWatch.md
@@ -88,14 +88,14 @@ Full Example
watchID = null;
}
}
-
+
// onSuccess: Get a snapshot of the current acceleration
//
function onSuccess(acceleration) {
var element = document.getElementById('accelerometer');
element.innerHTML = 'Acceleration X: ' + acceleration.x + '<br />' +
'Acceleration Y: ' + acceleration.y + '<br />' +
- 'Acceleration Z: ' + acceleration.z + '<br />' +
+ 'Acceleration Z: ' + acceleration.z + '<br />' +
'Timestamp: ' + acceleration.timestamp + '<br />';
}
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/accelerometer/accelerometer.getCurrentAcceleration.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/accelerometer/accelerometer.getCurrentAcceleration.md b/docs/en/edge/cordova/accelerometer/accelerometer.getCurrentAcceleration.md
index 8ff09a6..8f0b0f5 100644
--- a/docs/en/edge/cordova/accelerometer/accelerometer.getCurrentAcceleration.md
+++ b/docs/en/edge/cordova/accelerometer/accelerometer.getCurrentAcceleration.md
@@ -104,7 +104,7 @@ Full Example
<p>getCurrentAcceleration</p>
</body>
</html>
-
+
iPhone Quirks
-------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/accelerometer/accelerometer.watchAcceleration.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/accelerometer/accelerometer.watchAcceleration.md b/docs/en/edge/cordova/accelerometer/accelerometer.watchAcceleration.md
index 25592fc..7f117d6 100644
--- a/docs/en/edge/cordova/accelerometer/accelerometer.watchAcceleration.md
+++ b/docs/en/edge/cordova/accelerometer/accelerometer.watchAcceleration.md
@@ -25,7 +25,7 @@ At a regular interval, get the acceleration along the _x_, _y_, and _z_ axis.
var watchID = navigator.accelerometer.watchAcceleration(accelerometerSuccess,
accelerometerError,
[accelerometerOptions]);
-
+
Description
-----------
@@ -137,7 +137,7 @@ Full Example
<div id="accelerometer">Waiting for accelerometer...</div>
</body>
</html>
-
+
iPhone Quirks
-------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/camera/camera.cleanup.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/camera/camera.cleanup.md b/docs/en/edge/cordova/camera/camera.cleanup.md
index f1e5153..5d5e700 100644
--- a/docs/en/edge/cordova/camera/camera.cleanup.md
+++ b/docs/en/edge/cordova/camera/camera.cleanup.md
@@ -38,11 +38,10 @@ Supported Platforms
- iOS
-
Example
-------------
- navigator.camera.cleanup(onSuccess, onFail);
+ navigator.camera.cleanup(onSuccess, onFail);
function onSuccess() {
console.log("Camera cleanup success.")
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/camera/camera.getPicture.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/camera/camera.getPicture.md b/docs/en/edge/cordova/camera/camera.getPicture.md
index 8f97851..8608caf 100644
--- a/docs/en/edge/cordova/camera/camera.getPicture.md
+++ b/docs/en/edge/cordova/camera/camera.getPicture.md
@@ -48,7 +48,7 @@ The return value is sent to the `cameraSuccess` callback function, in
one of the following formats, depending on the specified
`cameraOptions`:
-- A `String` containing the Base64-encoded photo image (default).
+- A `String` containing the base64-encoded photo image (default).
- A `String` representing the image file location on local storage.
You can do whatever you want with the encoded image or URI, for
@@ -84,7 +84,7 @@ can cause problems. Wrap the alert within a `setTimeout()` to allow
the iOS image picker or popover to fully close before the alert
displays:
- setTimeout(function() {
+ setTimeout(function() {
// do your thing here!
}, 0);
@@ -104,11 +104,11 @@ Tizen only supports a `destinationType` of
Quick Example
-------------
-Take a photo and retrieve it as a Base64-encoded image:
+Take a photo and retrieve it as a base64-encoded image:
navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
destinationType: Camera.DestinationType.DATA_URL
- });
+ });
function onSuccess(imageData) {
var image = document.getElementById('myImage');
@@ -119,10 +119,10 @@ Take a photo and retrieve it as a Base64-encoded image:
alert('Failed because: ' + message);
}
-Take a photo and retrieve the image's file location:
+Take a photo and retrieve the image's file location:
- navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
- destinationType: Camera.DestinationType.FILE_URI });
+ navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
+ destinationType: Camera.DestinationType.FILE_URI });
function onSuccess(imageURI) {
var image = document.getElementById('myImage');
@@ -133,7 +133,6 @@ Take a photo and retrieve the image's file location:
alert('Failed because: ' + message);
}
-
Full Example
------------
@@ -146,7 +145,7 @@ Full Example
<script type="text/javascript" charset="utf-8">
var pictureSource; // picture source
- var destinationType; // sets the format of returned value
+ var destinationType; // sets the format of returned value
// Wait for Cordova to connect with the device
//
@@ -162,7 +161,7 @@ Full Example
// Called when a photo is successfully retrieved
//
function onPhotoDataSuccess(imageData) {
- // Uncomment to view the base64 encoded image data
+ // Uncomment to view the base64-encoded image data
// console.log(imageData);
// Get image handle
@@ -182,7 +181,7 @@ Full Example
// Called when a photo is successfully retrieved
//
function onPhotoURISuccess(imageURI) {
- // Uncomment to view the image file URI
+ // Uncomment to view the image file URI
// console.log(imageURI);
// Get image handle
@@ -210,7 +209,7 @@ Full Example
// A button will call this function
//
function capturePhotoEdit() {
- // Take picture using device camera, allow edit, and retrieve image as base64-encoded string
+ // Take picture using device camera, allow edit, and retrieve image as base64-encoded string
navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 20, allowEdit: true,
destinationType: destinationType.DATA_URL });
}
@@ -219,13 +218,13 @@ Full Example
//
function getPhoto(source) {
// Retrieve image file location from specified source
- navigator.camera.getPicture(onPhotoURISuccess, onFail, { quality: 50,
+ navigator.camera.getPicture(onPhotoURISuccess, onFail, { quality: 50,
destinationType: destinationType.FILE_URI,
sourceType: source });
}
// Called if something bad happens.
- //
+ //
function onFail(message) {
alert('Failed because: ' + message);
}
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/camera/parameter/CameraPopoverOptions.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/camera/parameter/CameraPopoverOptions.md b/docs/en/edge/cordova/camera/parameter/CameraPopoverOptions.md
index 79b755b..25118c2 100644
--- a/docs/en/edge/cordova/camera/parameter/CameraPopoverOptions.md
+++ b/docs/en/edge/cordova/camera/parameter/CameraPopoverOptions.md
@@ -24,7 +24,7 @@ iOS-only parameters that specify the anchor element location and arrow
direction of the popover when selecting images from an iPad's library
or album.
- { x : 0,
+ { x : 0,
y : 32,
width : 320,
height : 480,
@@ -43,7 +43,7 @@ CameraPopoverOptions
- __height:__ height, in pixels, of the screen element onto which to anchor the popover. (`Number`)
- __arrowDir:__ Direction the arrow on the popover should point. Defined in `Camera.PopoverArrowDirection` (`Number`)
-
+
Camera.PopoverArrowDirection = {
ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
ARROW_DOWN : 2,
@@ -51,7 +51,7 @@ CameraPopoverOptions
ARROW_RIGHT : 8,
ARROW_ANY : 15
};
-
+
Note that the size of the popover may change to adjust to the
direction of the arrow and orientation of the screen. Make sure to
account for orientation changes when specifying the anchor element
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/camera/parameter/cameraOptions.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/camera/parameter/cameraOptions.md b/docs/en/edge/cordova/camera/parameter/cameraOptions.md
index 30f8832..0414446 100644
--- a/docs/en/edge/cordova/camera/parameter/cameraOptions.md
+++ b/docs/en/edge/cordova/camera/parameter/cameraOptions.md
@@ -40,7 +40,7 @@ Options
- __destinationType:__ Choose the format of the return value. Defined in `navigator.camera.DestinationType` (`Number`)
Camera.DestinationType = {
- DATA_URL : 0, // Return image as base64 encoded string
+ DATA_URL : 0, // Return image as base64-encoded string
FILE_URI : 1, // Return image file URI
NATIVE_URI : 2 // Return image native URI (e.g. assets-library:// on iOS or content:// on Android)
};
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/compass/compass.clearWatch.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/compass/compass.clearWatch.md b/docs/en/edge/cordova/compass/compass.clearWatch.md
index 120923c..839c0e0 100755
--- a/docs/en/edge/cordova/compass/compass.clearWatch.md
+++ b/docs/en/edge/cordova/compass/compass.clearWatch.md
@@ -45,7 +45,7 @@ Quick Example
// ... later on ...
navigator.compass.clearWatch(watchID);
-
+
Full Example
------------
@@ -102,7 +102,6 @@ Full Example
alert('Compass error: ' + compassError.code);
}
-
</script>
</head>
<body>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/compass/compass.getCurrentHeading.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/compass/compass.getCurrentHeading.md b/docs/en/edge/cordova/compass/compass.getCurrentHeading.md
index 97f42bd..b1c08f5 100755
--- a/docs/en/edge/cordova/compass/compass.getCurrentHeading.md
+++ b/docs/en/edge/cordova/compass/compass.getCurrentHeading.md
@@ -98,4 +98,4 @@ Full Example
<p>getCurrentHeading</p>
</body>
</html>
-
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/compass/compass.watchHeading.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/compass/compass.watchHeading.md b/docs/en/edge/cordova/compass/compass.watchHeading.md
index b6d925e..0f7c0b2 100755
--- a/docs/en/edge/cordova/compass/compass.watchHeading.md
+++ b/docs/en/edge/cordova/compass/compass.watchHeading.md
@@ -23,7 +23,7 @@ compass.watchHeading
At a regular interval, get the compass heading in degrees.
var watchID = navigator.compass.watchHeading(compassSuccess, compassError, [compassOptions]);
-
+
Description
-----------
@@ -51,7 +51,6 @@ Supported Platforms
- Tizen
- Windows 8
-
Quick Example
-------------
@@ -132,7 +131,7 @@ Full Example
<button onclick="stopWatch();">Stop Watching</button>
</body>
</html>
-
+
iOS Quirks
--------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/compass/compassError/compassError.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/compass/compassError/compassError.md b/docs/en/edge/cordova/compass/compassError/compassError.md
index ef594e6..c8850b7 100644
--- a/docs/en/edge/cordova/compass/compassError/compassError.md
+++ b/docs/en/edge/cordova/compass/compassError/compassError.md
@@ -29,7 +29,7 @@ Properties
Constants
---------
-- `CompassError.COMPASS_INTERNAL_ERR`
+- `CompassError.COMPASS_INTERNAL_ERR`
- `CompassError.COMPASS_NOT_SUPPORTED`
Description
@@ -37,4 +37,3 @@ Description
The `CompassError` object is returned to the user through the `compassError` callback function when an error occurs.
-
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/compass/parameters/compassError.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/compass/parameters/compassError.md b/docs/en/edge/cordova/compass/parameters/compassError.md
index 1751d55..7a8fe49 100755
--- a/docs/en/edge/cordova/compass/parameters/compassError.md
+++ b/docs/en/edge/cordova/compass/parameters/compassError.md
@@ -20,7 +20,7 @@
compassError
==========
-onError callback function for compass functions.
+onError callback function for compass functions.
Example
-------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/compass/parameters/compassSuccess.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/compass/parameters/compassSuccess.md b/docs/en/edge/cordova/compass/parameters/compassSuccess.md
index 6822357..9f4daf0 100644
--- a/docs/en/edge/cordova/compass/parameters/compassSuccess.md
+++ b/docs/en/edge/cordova/compass/parameters/compassSuccess.md
@@ -29,7 +29,6 @@ onSuccess callback function that provides the compass heading information via a
Parameters
----------
-
- __heading:__ The heading information. _(compassHeading)_
Example
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/connection/connection.type.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/connection/connection.type.md b/docs/en/edge/cordova/connection/connection.type.md
index c346890..89bffbe 100644
--- a/docs/en/edge/cordova/connection/connection.type.md
+++ b/docs/en/edge/cordova/connection/connection.type.md
@@ -73,7 +73,7 @@ Full Example
<script type="text/javascript" charset="utf-8">
// Wait for Cordova to load
- //
+ //
document.addEventListener("deviceready", onDeviceReady, false);
// Cordova is loaded and it is now safe to make calls Cordova methods
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/Contact/contact.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/Contact/contact.md b/docs/en/edge/cordova/contacts/Contact/contact.md
index 34d96db..3f05775 100644
--- a/docs/en/edge/cordova/contacts/Contact/contact.md
+++ b/docs/en/edge/cordova/contacts/Contact/contact.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -28,7 +28,7 @@ Properties
- __id:__ A globally unique identifier. _(DOMString)_
- __displayName:__ The name of this Contact, suitable for display to end-users. _(DOMString)_
- __name:__ An object containing all components of a persons name. _(ContactName)_
-- __nickname:__ A casual name to address the contact by. _(DOMString)_
+- __nickname:__ A casual name by which to address the contact. _(DOMString)_
- __phoneNumbers:__ An array of all the contact's phone numbers. _(ContactField[])_
- __emails:__ An array of all the contact's email addresses. _(ContactField[])_
- __addresses:__ An array of all the contact's addresses. _(ContactAddress[])_
@@ -37,23 +37,27 @@ Properties
- __birthday:__ The birthday of the contact. _(Date)_
- __note:__ A note about the contact. _(DOMString)_
- __photos:__ An array of the contact's photos. _(ContactField[])_
-- __categories:__ An array of all the contacts user defined categories. _(ContactField[])_
-- __urls:__ An array of web pages associated to the contact. _(ContactField[])_
+- __categories:__ An array of all the contact's user-defined categories. _(ContactField[])_
+- __urls:__ An array of web pages associated with the contact. _(ContactField[])_
Methods
-------
-- __clone__: Returns a new Contact object that is a deep copy of the calling object, with the id property set to `null`.
-- __remove__: Removes the contact from the device contacts database. An error callback is called with a `ContactError` object if the removal is unsuccessful.
+- __clone__: Returns a new `Contact` object that is a deep copy of the calling object, with the `id` property set to `null`.
+- __remove__: Removes the contact from the device contacts database, otherwise executes an error callback with a `ContactError` object.
- __save__: Saves a new contact to the device contacts database, or updates an existing contact if a contact with the same __id__ already exists.
-
Details
-------
-The `Contact` object represents a user contact. Contacts can be created, saved to, or removed from the device contacts database. Contacts can also be retrieved (individually or in bulk) from the database by invoking the `contacts.find` method.
+The `Contact` object represents a user contact. Contacts can be
+created, stored, or removed from the device contacts database.
+Contacts can also be retrieved (individually or in bulk) from the
+database by invoking the `contacts.find` method.
-_Note: Not all of the above contact fields are supported on every device platform. Please check each platform's Quirks section for information about which fields are supported._
+__NOTE:__ Not all of the contact fields listed above are supported on
+every device platform. Please check each platform's _Quirks_ section
+for details.
Supported Platforms
-------------------
@@ -97,7 +101,7 @@ Clone Quick Example
var clone = contact.clone();
clone.name.givenName = "John";
console.log("Original contact name = " + contact.name.givenName);
- console.log("Cloned contact name = " + clone.name.givenName);
+ console.log("Cloned contact name = " + clone.name.givenName);
Remove Quick Example
--------------------
@@ -147,7 +151,7 @@ Full Example
var clone = contact.clone();
clone.name.givenName = "John";
console.log("Original contact name = " + contact.name.givenName);
- console.log("Cloned contact name = " + clone.name.givenName);
+ console.log("Cloned contact name = " + clone.name.givenName);
// remove
contact.remove(onRemoveSuccess,onRemoveError);
@@ -188,51 +192,50 @@ Full Example
Android 2.X Quirks
------------------
-- __categories:__ This property is not support by Android 2.X devices, and will always be returned as `null`.
-
+- __categories:__ Not supported on Android 2.X devices, returning `null`.
BlackBerry WebWorks (OS 5.0 and higher) Quirks
---------------------------------------------
-- __id:__ Supported. Assigned by device when contact is saved.
+- __id:__ Supported. Assigned by the device when saving the contact.
- __displayName:__ Supported. Stored in BlackBerry __user1__ field.
-- __nickname:__ This property is not supported, and will always be returned as `null`.
-- __phoneNumbers:__ Partially supported. Phone numbers will be stored in BlackBerry fields __homePhone1__ and __homePhone2__ if _type_ is 'home', __workPhone1__ and __workPhone2__ if _type_ is 'work', __mobilePhone__ if _type_ is 'mobile', __faxPhone__ if _type_ is 'fax', __pagerPhone__ if _type_ is 'pager', and __otherPhone__ if _type_ is none of the above.
-- __emails:__ Partially supported. The first three email addresses will be stored in the BlackBerry __email1__, __email2__, and __email3__ fields, respectively.
-- __addresses:__ Partially supported. The first and second addresses will be stored in the BlackBerry __homeAddress__ and __workAddress__ fields, respectively.
-- __ims:__ This property is not supported, and will always be returned as `null`.
+- __nickname:__ Not supported, returning `null`.
+- __phoneNumbers:__ Partially supported. Phone numbers are stored in BlackBerry fields __homePhone1__ and __homePhone2__ if _type_ is 'home', __workPhone1__ and __workPhone2__ if _type_ is 'work', __mobilePhone__ if _type_ is 'mobile', __faxPhone__ if _type_ is 'fax', __pagerPhone__ if _type_ is 'pager', and __otherPhone__ if _type_ is none of the above.
+- __emails:__ Partially supported. The first three email addresses are stored in the BlackBerry __email1__, __email2__, and __email3__ fields, respectively.
+- __addresses:__ Partially supported. The first and second addresses are stored in the BlackBerry __homeAddress__ and __workAddress__ fields, respectively.
+- __ims:__ Not supported, returning `null`.
- __organizations:__ Partially supported. The __name__ and __title__ of the first organization are stored in the BlackBerry __company__ and __title__ fields, respectively.
-- __photos:__ - Partially supported. A single thumbnail-sized photo is supported. To set a contact's photo, pass in a either a Base64 encoded image, or a URL pointing to the image. The image will be scaled down before saving to the BlackBerry contacts database. The contact photo is returned as a Base64 encoded image.
-- __categories:__ Partially supported. Only 'Business' and 'Personal' categories are supported.
-- __urls:__ Partially supported. The first url is stored in BlackBerry __webpage__ field.
+- __photos:__ Partially supported. A single thumbnail-sized photo is supported. To set a contact's photo, pass in a either a base64-encoded image, or a URL pointing to the image. The image is scaled down before saving to the BlackBerry contacts database. The contact photo is returned as a base64-encoded image.
+- __categories:__ Partially supported. Only _Business_ and _Personal_ categories are supported.
+- __urls:__ Partially supported. The first URL is stored in BlackBerry __webpage__ field.
iOS Quirks
----------
-- __displayName:__ This property is not supported by iOS and will be returned as `null` unless there is no ContactName specified. If there is no ContactName, then composite name, __nickname__ or "" is returned for __displayName__, respectively.
-- __birthday:__ For input, this property must be provided as a JavaScript Date object. It is returned as a JavaScript Date object.
-- __photos:__ Returned Photo is stored in the application's temporary directory and a File URL to photo is returned. Contents of temporary folder is deleted when application exits.
-- __categories:__ This property is not currently supported and will always be returned as `null`.
+
+- __displayName:__ Not supported on iOS, returning `null` unless there is no `ContactName` specified, in which case it returns the composite name, __nickname__ or `""`, respectively.
+- __birthday:__ Must be input as a JavaScript `Date` object, the same way it is returned.
+- __photos:__ Returns a File URL to the image, which is stored in the application's temporary directory. Contents of the temporary directory are removed when the application exits.
+- __categories:__ This property is currently not supported, returning `null`.
Windows Phone 7 and 8 Quirks
-----------
-- __displayName:__ When creating a contact, the value provided for the display name parameter differs from the display name retrieved when finding the contact.
-- __urls:__ When creating a contact, user inputs multiple web addresses in the url field and saves the contact. While pulling the information during the contact search url field do not show up multiple web addresses
-- __phoneNumbers:__ _pref_ is not supported, _type_ is not supported in a _find_ operation, only supports one phoneNumber of each _type_
-- __emails:__ _pref_ is not supported, home and personal points to same email entry, supports only one entry for each _type_
-- __addresses:__ supports only _type_ of work, home/personal, _type_ home and personal points to same address entry, supports only one entry for each _type_
-- __organizations:__ Multiple _organizations_ are not supported, does not support the attributes: _pref_, _type_, _department_
-- __note:__ This property is not supported, and will always be returned as `null`.
-- __ims:__ This property is not supported, and will always be returned as `null`.
-- __birthdays:__ This property is not supported, and will always be returned as `null`.
-- __categories:__ This property is not supported, and will always be returned as `null`.
-
+- __displayName:__ When creating a contact, the value provided for the display name parameter differs from the display name retrieved when finding the contact.
+- __urls:__ When creating a contact, users can input and save more than one web address, but only one is available is available when searching the contact.
+- __phoneNumbers:__ The _pref_ option is not supported. The _type_ is not supported in a _find_ operation. Only one `phoneNumber` is allowed for each _type_.
+- __emails:__ The _pref_ option is not supported. Home and personal references same email entry. Only one entry is allowed for each _type_.
+- __addresses:__ Supports only work, and home/personal _type_. The home and personal _type_ reference the same address entry. Only one entry is allowed for each _type_.
+- __organizations:__ Only one is allowed, and does not support the _pref_, _type_, and _department_ attributes.
+- __note:__ Not supported, returning `null`.
+- __ims:__ Not supported, returning `null`.
+- __birthdays:__ Not supported, returning `null`.
+- __categories:__ Not supported, returning `null`.
Bada Quirks
-----------
-- __displayName:__ This property is not supported
-- __birthday:__ This property is not supported
+- __displayName:__ Not supported.
+- __birthday:__ Not supported.
- __photos:__ This property should be a list with one URL to a photo
-- __categories:__ This property is not supported
-- __ims:__ This property is not supported
+- __categories:__ Not supported.
+- __ims:__ Not supported.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/ContactAddress/contactaddress.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/ContactAddress/contactaddress.md b/docs/en/edge/cordova/contacts/ContactAddress/contactaddress.md
index 937e9de..8939fe5 100644
--- a/docs/en/edge/cordova/contacts/ContactAddress/contactaddress.md
+++ b/docs/en/edge/cordova/contacts/ContactAddress/contactaddress.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -25,7 +25,7 @@ Contains address properties for a `Contact` object.
Properties
----------
- __pref:__ Set to `true` if this `ContactAddress` contains the user's preferred value. _(boolean)_
-- __type:__ A string that tells you what type of field this is (example: 'home'). _(DOMString)
+- __type:__ A string indicating what type of field this is, _home_ for example. _(DOMString)_
- __formatted:__ The full address formatted for display. _(DOMString)_
- __streetAddress:__ The full street address. _(DOMString)_
- __locality:__ The city or locality. _(DOMString)_
@@ -36,7 +36,9 @@ Properties
Details
-------
-The `ContactAddress` object stores the properties of a single address of a contact. A `Contact` object can have one or more addresses in a `ContactAddress[]` array.
+The `ContactAddress` object stores the properties of a single address
+of a contact. A `Contact` object may include more than one address in
+a `ContactAddress[]` array.
Supported Platforms
-------------------
@@ -57,11 +59,11 @@ Quick Example
for (var j=0; j<contacts[i].addresses.length; j++) {
alert("Pref: " + contacts[i].addresses[j].pref + "\n" +
"Type: " + contacts[i].addresses[j].type + "\n" +
- "Formatted: " + contacts[i].addresses[j].formatted + "\n" +
- "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
- "Locality: " + contacts[i].addresses[j].locality + "\n" +
- "Region: " + contacts[i].addresses[j].region + "\n" +
- "Postal Code: " + contacts[i].addresses[j].postalCode + "\n" +
+ "Formatted: " + contacts[i].addresses[j].formatted + "\n" +
+ "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+ "Locality: " + contacts[i].addresses[j].locality + "\n" +
+ "Region: " + contacts[i].addresses[j].region + "\n" +
+ "Postal Code: " + contacts[i].addresses[j].postalCode + "\n" +
"Country: " + contacts[i].addresses[j].country);
}
}
@@ -73,7 +75,7 @@ Quick Example
// find all contacts
var options = new ContactFindOptions();
- options.filter="";
+ options.filter="";
var filter = ["displayName","addresses"];
navigator.contacts.find(filter, onSuccess, onError, options);
@@ -97,7 +99,7 @@ Full Example
function onDeviceReady() {
// find all contacts
var options = new ContactFindOptions();
- options.filter="";
+ options.filter="";
var filter = ["displayName","addresses"];
navigator.contacts.find(filter, onSuccess, onError, options);
}
@@ -110,11 +112,11 @@ Full Example
for (var j=0; j<contacts[i].addresses.length; j++) {
alert("Pref: " + contacts[i].addresses[j].pref + "\n" +
"Type: " + contacts[i].addresses[j].type + "\n" +
- "Formatted: " + contacts[i].addresses[j].formatted + "\n" +
- "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
- "Locality: " + contacts[i].addresses[j].locality + "\n" +
- "Region: " + contacts[i].addresses[j].region + "\n" +
- "Postal Code: " + contacts[i].addresses[j].postalCode + "\n" +
+ "Formatted: " + contacts[i].addresses[j].formatted + "\n" +
+ "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+ "Locality: " + contacts[i].addresses[j].locality + "\n" +
+ "Region: " + contacts[i].addresses[j].region + "\n" +
+ "Postal Code: " + contacts[i].addresses[j].postalCode + "\n" +
"Country: " + contacts[i].addresses[j].country);
}
}
@@ -137,14 +139,14 @@ Full Example
Android 2.X Quirks
------------------
-- __pref:__ This property is not supported by Android 2.X devices and will always return `false`.
+- __pref:__ Not supported, returning `false` on Android 2.X devices.
BlackBerry WebWorks (OS 5.0 and higher) Quirks
--------------------------------------------
-- __pref:__ This property is not supported on Blackberry devices and will always return `false`.
-- __type:__ Partially supported. Only one each of "Work" and "Home" type addresses can be stored per contact.
-- __formatted:__ Partially supported. Will return concatenation of all BlackBerry address fields.
-- __streetAddress:__ Supported. Will return concatenation of BlackBerry __address1__ and __address2__ address fields.
+- __pref:__ Not supported on Blackberry devices, returning `false`.
+- __type:__ Partially supported. Only one each of _Work_ and _Home_ type addresses can be stored per contact.
+- __formatted:__ Partially supported. Returns a concatenation of all BlackBerry address fields.
+- __streetAddress:__ Supported. Returns a concatenation of BlackBerry __address1__ and __address2__ address fields.
- __locality:__ Supported. Stored in BlackBerry __city__ address field.
- __region:__ Supported. Stored in BlackBerry __stateProvince__ address field.
- __postalCode:__ Supported. Stored in BlackBerry __zipPostal__ address field.
@@ -152,10 +154,10 @@ BlackBerry WebWorks (OS 5.0 and higher) Quirks
iOS Quirks
----------
-- __pref:__ This property is not supported on iOS devices and will always return `false`.
-- __formatted:__ Not currently supported.
+- __pref:__ Not supported on iOS devices, returning `false`.
+- __formatted:__ Currently not supported.
Bada Quirks
-----------
-- __formatted:__ This property is not supported
-- __type:__ Has to be one of the following: WORK, HOME
+- __formatted:__ Not supported.
+- __type:__ Has to be either `WORK` or `HOME`
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/ContactError/contactError.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/ContactError/contactError.md b/docs/en/edge/cordova/contacts/ContactError/contactError.md
index 45b5873..0e67b68 100644
--- a/docs/en/edge/cordova/contacts/ContactError/contactError.md
+++ b/docs/en/edge/cordova/contacts/ContactError/contactError.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -20,7 +20,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one
ContactError
========
-A `ContactError` object is returned to the `contactError` callback when an error occurs.
+A `ContactError` object is passed to the `contactError` callback when an error occurs.
Properties
----------
@@ -41,5 +41,6 @@ Constants
Description
-----------
-The `ContactError` object is returned to the user through the `contactError` callback function when an error occurs.
+The `ContactError` object is returned to the user through the
+`contactError` callback function when an error occurs.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/ContactField/contactfield.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/ContactField/contactfield.md b/docs/en/edge/cordova/contacts/ContactField/contactfield.md
index f85a704..727b184 100644
--- a/docs/en/edge/cordova/contacts/ContactField/contactfield.md
+++ b/docs/en/edge/cordova/contacts/ContactField/contactfield.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -20,21 +20,35 @@ license: Licensed to the Apache Software Foundation (ASF) under one
ContactField
============
-Supports generic fields in a `Contact` object. Some properties that are stored as `ContactField` objects include email addresses, phone numbers, and urls.
+Supports generic fields in a `Contact` object. Some properties stored
+as `ContactField` objects include email addresses, phone numbers, and
+URLs.
Properties
----------
-- __type:__ A string that tells you what type of field this is (example: 'home'). _(DOMString)_
-- __value:__ The value of the field (such as a phone number or email address). _(DOMString)_
+- __type:__ A string that indicates what type of field this is, _home_ for example. _(DOMString)_
+- __value:__ The value of the field, such as a phone number or email address. _(DOMString)_
- __pref:__ Set to `true` if this `ContactField` contains the user's preferred value. _(boolean)_
Details
-------
-The `ContactField` object is a reusable component that is used to support contact fields in a generic fashion. Each `ContactField` object contains a value property, a type property, and a pref property. A `Contact` object stores several properties in `ContactField[]` arrays, such as phone numbers and email addresses.
-
-In most instances, there are no pre-determined values for the __type__ attribute of a `ContactField` object. For example, a phone number can have __type__ values of 'home', 'work', 'mobile', 'iPhone', or any other value that is supported by the contact database on a particular device platform. However, in the case of the `Contact` __photos__ field, Cordova makes use of the __type__ field to indicate the format of the returned image. Cordova will return __type: 'url'__ when the __value__ attribute contains a URL to the photo image, or __type: 'base64'__ when the returned __value__ attribute contains a Base64 encoded image string.
+The `ContactField` object is a reusable component that represents
+contact fields generically. Each `ContactField` object contains a
+`value`, `type`, and `pref` property. A `Contact` object stores
+several properties in `ContactField[]` arrays, such as phone numbers
+and email addresses.
+
+In most instances, there are no pre-determined values for a
+`ContactField` object's __type__ attribute. For example, a phone
+number can specify __type__ values of _home_, _work_, _mobile_,
+_iPhone_, or any other value that is supported by a particular device
+platform's contact database. However, for the `Contact` __photos__
+field, Cordova uses the __type__ field to indicate the format of the
+returned image. Cordova returns a __type__ of __url__ when the
+__value__ attribute contains a URL to the photo image, or _base64_
+when the __value__ contains a base64-encoded image string.
Supported Platforms
-------------------
@@ -106,8 +120,8 @@ Full Example
for (var i=0; i<contacts.length; i++) {
// display phone numbers
for (var j=0; j<contacts[i].phoneNumbers.length; j++) {
- alert("Type: " + contacts[i].phoneNumbers[j].type + "\n" +
- "Value: " + contacts[i].phoneNumbers[j].value + "\n" +
+ alert("Type: " + contacts[i].phoneNumbers[j].type + "\n" +
+ "Value: " + contacts[i].phoneNumbers[j].value + "\n" +
"Preferred: " + contacts[i].phoneNumbers[j].pref);
}
}
@@ -130,19 +144,20 @@ Full Example
Android Quirks
--------------
-- __pref:__ This property is not support by Android devices, and will always return `false`.
+- __pref:__ Not supported, returning `false`.
BlackBerry WebWorks (OS 5.0 and higher) Quirks
--------------------------------------------
- __type:__ Partially supported. Used for phone numbers.
- __value:__ Supported.
-- __pref:__ This property is not supported, and will always return `false`.
+- __pref:__ Not supported, returning `false`.
iOS Quirks
-----------
-- __pref:__ This property is not supported on iOS devices and will always return `false`.
+- __pref:__ Not supported, returning `false`.
Bada Quirks
-----------
-- __type:__ Property has to be one of the following for Email or Address fields: "WORK", "HOME". Property has to be one of the following for Phone fields: "WORK", "HOME", "VOICE", "FAX", "MSG", "CELL", "PAGER","BBS", "MODEM", "CAR", "ISDN","VIDEO", "PCS"
+
+- __type:__ For email or address fields, property must be _WORK_ or _HOME_. For phone fields, must be _WORK_, _HOME_, _VOICE_, _FAX_, _MSG_, _CELL_, _PAGER_, _BBS_, _MODEM_, _CAR_, _ISDN_,_VIDEO_, or _PCS_.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/ContactFindOptions/contactfindoptions.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/ContactFindOptions/contactfindoptions.md b/docs/en/edge/cordova/contacts/ContactFindOptions/contactfindoptions.md
index 4acf254..10ff14a 100644
--- a/docs/en/edge/cordova/contacts/ContactFindOptions/contactfindoptions.md
+++ b/docs/en/edge/cordova/contacts/ContactFindOptions/contactfindoptions.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -25,9 +25,8 @@ Contains properties that can be used to filter the results of a `contacts.find`
Properties
----------
-- __filter:__ The search string used to find contacts. _(DOMString)_ (Default: "")
-- __multiple:__ Determines if the find operation should return multiple contacts. _(Boolean)_ (Default: false)
-
+- __filter:__ The search string used to find contacts. _(DOMString)_ (Default: `""`)
+- __multiple:__ Determines if the find operation returns multiple contacts. _(Boolean)_ (Default: false)
Supported Platforms
-------------------
@@ -115,4 +114,5 @@ Full Example
Bada Quirks
-----------
-__filter:__ Property can only apply to the following: "firstName", "lastName", "nickname", "phoneNumber", "email", "address"
+
+__filter:__ Property can only apply to the following: _firstName_, _lastName_, _nickname_, _phoneNumber_, _email_, and _address_.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/ContactName/contactname.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/ContactName/contactname.md b/docs/en/edge/cordova/contacts/ContactName/contactname.md
index 91915fb..9799472 100644
--- a/docs/en/edge/cordova/contacts/ContactName/contactname.md
+++ b/docs/en/edge/cordova/contacts/ContactName/contactname.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -20,22 +20,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one
ContactName
===========
-Contains name properties of a `Contact` object.
+Contains different kinds of information about a `Contact` object's name.
Properties
----------
- __formatted:__ The complete name of the contact. _(DOMString)_
-- __familyName:__ The contacts family name. _(DOMString)_
-- __givenName:__ The contacts given name. _(DOMString)_
-- __middleName:__ The contacts middle name. _(DOMString)_
-- __honorificPrefix:__ The contacts prefix (example Mr. or Dr.) _(DOMString)_
-- __honorificSuffix:__ The contacts suffix (example Esq.). _(DOMString)_
+- __familyName:__ The contact's family name. _(DOMString)_
+- __givenName:__ The contact's given name. _(DOMString)_
+- __middleName:__ The contact's middle name. _(DOMString)_
+- __honorificPrefix:__ The contact's prefix (example _Mr._ or _Dr._) _(DOMString)_
+- __honorificSuffix:__ The contact's suffix (example _Esq._). _(DOMString)_
Details
-------
-The `ContactName` object stores name properties of a contact.
+The `ContactName` object stores a contact's name properties.
Supported Platforms
-------------------
@@ -52,11 +52,11 @@ Quick Example
function onSuccess(contacts) {
for (var i=0; i<contacts.length; i++) {
- alert("Formatted: " + contacts[i].name.formatted + "\n" +
- "Family Name: " + contacts[i].name.familyName + "\n" +
- "Given Name: " + contacts[i].name.givenName + "\n" +
- "Middle Name: " + contacts[i].name.middleName + "\n" +
- "Suffix: " + contacts[i].name.honorificSuffix + "\n" +
+ alert("Formatted: " + contacts[i].name.formatted + "\n" +
+ "Family Name: " + contacts[i].name.familyName + "\n" +
+ "Given Name: " + contacts[i].name.givenName + "\n" +
+ "Middle Name: " + contacts[i].name.middleName + "\n" +
+ "Suffix: " + contacts[i].name.honorificSuffix + "\n" +
"Prefix: " + contacts[i].name.honorificSuffix);
}
};
@@ -98,11 +98,11 @@ Full Example
//
function onSuccess(contacts) {
for (var i=0; i<contacts.length; i++) {
- alert("Formatted: " + contacts[i].name.formatted + "\n" +
- "Family Name: " + contacts[i].name.familyName + "\n" +
- "Given Name: " + contacts[i].name.givenName + "\n" +
- "Middle Name: " + contacts[i].name.middleName + "\n" +
- "Suffix: " + contacts[i].name.honorificSuffix + "\n" +
+ alert("Formatted: " + contacts[i].name.formatted + "\n" +
+ "Family Name: " + contacts[i].name.familyName + "\n" +
+ "Given Name: " + contacts[i].name.givenName + "\n" +
+ "Middle Name: " + contacts[i].name.middleName + "\n" +
+ "Suffix: " + contacts[i].name.honorificSuffix + "\n" +
"Prefix: " + contacts[i].name.honorificPrefix);
}
};
@@ -123,25 +123,25 @@ Full Example
Android Quirks
------------
-- __formatted:__ Partially supported. Will return the concatenation of honorificPrefix, givenName, middleName, familyName and honorificSuffix but will not store.
+- __formatted:__ Partially supported, and read-only. Returns a concatenation of `honorificPrefix`, `givenName`, `middleName`, `familyName`, and `honorificSuffix`.
BlackBerry WebWorks (OS 5.0 and higher) Quirks
---------------------------------------------
-- __formatted:__ Partially supported. Will return concatenation of BlackBerry __firstName__ and __lastName__ fields.
+- __formatted:__ Partially supported. Returns a concatenation of BlackBerry __firstName__ and __lastName__ fields.
- __familyName:__ Supported. Stored in BlackBerry __lastName__ field.
- __givenName:__ Supported. Stored in BlackBerry __firstName__ field.
-- __middleName:__ This property is not supported, and will always return `null`.
-- __honorificPrefix:__ This property is not supported, and will always return `null`.
-- __honorificSuffix:__ This property is not supported, and will always return `null`.
+- __middleName:__ Not supported, returning `null`.
+- __honorificPrefix:__ Not supported, returning `null`.
+- __honorificSuffix:__ Not supported, returning `null`.
iOS Quirks
------------
-- __formatted:__ Partially supported. Will return iOS Composite Name but will not store.
+- __formatted:__ Partially supported. Returns iOS Composite Name, but is read-only.
Bada Quirks
-----------
-- __formatted:__ Property not supported
-- __middleName:__ Property not supported
-_ __honorificPrefix:__ Property not supported
-- __honorificSuffix:__ Property not supported
+- __formatted:__ Not supported
+- __middleName:__ Not supported
+_ __honorificPrefix:__ Not supported
+- __honorificSuffix:__ Not supported
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/ContactOrganization/contactorganization.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/ContactOrganization/contactorganization.md b/docs/en/edge/cordova/contacts/ContactOrganization/contactorganization.md
index aef1248..7ddbf8e 100644
--- a/docs/en/edge/cordova/contacts/ContactOrganization/contactorganization.md
+++ b/docs/en/edge/cordova/contacts/ContactOrganization/contactorganization.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -20,20 +20,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one
ContactOrganization
===================
-Contains organization properties of a `Contact` object.
+Contains a `Contact` object's organization properties.
Properties
----------
- __pref:__ Set to `true` if this `ContactOrganization` contains the user's preferred value. _(boolean)_
-- __type:__ A string that tells you what type of field this is (example: 'home'). _(DOMString)
+- __type:__ A string that indicates what type of field this is, _home_ for example. _(DOMString)
- __name:__ The name of the organization. _(DOMString)_
- __department:__ The department the contract works for. _(DOMString)_
-- __title:__ The contacts title at the organization. _(DOMString)_
+- __title:__ The contact's title at the organization. _(DOMString)_
Details
-------
-The `ContactOrganization` object stores a contact's organization properties. A `Contact` object stores one or more `ContactOrganization` objects in an array.
+The `ContactOrganization` object stores a contact's organization
+properties. A `Contact` object stores one or more
+`ContactOrganization` objects in an array.
Supported Platforms
-------------------
@@ -53,8 +55,8 @@ Quick Example
for (var j=0; j<contacts[i].organizations.length; j++) {
alert("Pref: " + contacts[i].organizations[j].pref + "\n" +
"Type: " + contacts[i].organizations[j].type + "\n" +
- "Name: " + contacts[i].organizations[j].name + "\n" +
- "Department: " + contacts[i].organizations[j].department + "\n" +
+ "Name: " + contacts[i].organizations[j].name + "\n" +
+ "Department: " + contacts[i].organizations[j].department + "\n" +
"Title: " + contacts[i].organizations[j].title);
}
}
@@ -100,8 +102,8 @@ Full Example
for (var j=0; j<contacts[i].organizations.length; j++) {
alert("Pref: " + contacts[i].organizations[j].pref + "\n" +
"Type: " + contacts[i].organizations[j].type + "\n" +
- "Name: " + contacts[i].organizations[j].name + "\n" +
- "Department: " + contacts[i].organizations[j].department + "\n" +
+ "Name: " + contacts[i].organizations[j].name + "\n" +
+ "Department: " + contacts[i].organizations[j].department + "\n" +
"Title: " + contacts[i].organizations[j].title);
}
}
@@ -125,24 +127,24 @@ Full Example
Android 2.X Quirks
------------------
-- __pref:__ This property is not supported by Android 2.X devices and will always return `false`.
+- __pref:__ Not supported by Android 2.X devices, returning `false`.
BlackBerry WebWorks (OS 5.0 and higher) Quirks
--------------------------------------------
-- __pref:__ This property is not supported by Blackberry devices and will always return `false`.
-- __type:__ This property is not supported by Blackberry devices and will always return `null`.
-- __name:__ Partially supported. The first organization name will be stored in the BlackBerry __company__ field.
-- __department:__ This property is not supported, and will always be returned as `null`.
-- __title:__ Partially supported. The first organization title will be stored in the BlackBerry __jobTitle__ field.
+- __pref:__ Not supported by Blackberry devices, returning `false`.
+- __type:__ Not supported by Blackberry devices, returning `null`.
+- __name:__ Partially supported. The first organization name is stored in the BlackBerry __company__ field.
+- __department:__ Not supported, returning `null`.
+- __title:__ Partially supported. The first organization title is stored in the BlackBerry __jobTitle__ field.
iOS Quirks
-----------
-- __pref:__ This property is not supported on iOS devices and will always return `false`.
-- __type:__ This property is not supported on iOS devices and will always return `null`.
-- __name:__ Partially supported. The first organization name will be stored in the iOS __kABPersonOrganizationProperty__ field.
-- __department__: Partially supported. The first department name will be stored in the iOS __kABPersonDepartmentProperty__ field.
-- __title__: Partially supported. The first title will be stored in the iOS __kABPersonJobTitleProperty__ field.
+- __pref:__ Not supported on iOS devices, returning `false`.
+- __type:__ Not supported on iOS devices, returning `null`.
+- __name:__ Partially supported. The first organization name is stored in the iOS __kABPersonOrganizationProperty__ field.
+- __department__: Partially supported. The first department name is stored in the iOS __kABPersonDepartmentProperty__ field.
+- __title__: Partially supported. The first title is stored in the iOS __kABPersonJobTitleProperty__ field.
Bada 2.0 Quirks
---------------
-- ContactOrganization not supported
+- `ContactOrganization` is not supported.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/contacts.create.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/contacts.create.md b/docs/en/edge/cordova/contacts/contacts.create.md
index 42e8cb3..f3548d3 100644
--- a/docs/en/edge/cordova/contacts/contacts.create.md
+++ b/docs/en/edge/cordova/contacts/contacts.create.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -27,9 +27,10 @@ Returns a new Contact object.
Description
-----------
-contacts.create is a synchronous function that returns a new `Contact` object.
+The `contacts.create` method is synchronous, and returns a new `Contact` object.
-This method does not persist the Contact object to the device contacts database. To persist the Contact object to the device, invoke the `Contact.save` method.
+This method does not retain the Contact object in the device contacts
+database, for which you need to invoke the `Contact.save` method.
Supported Platforms
-------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/contacts.find.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/contacts.find.md b/docs/en/edge/cordova/contacts/contacts.find.md
index ad97108..592c621 100644
--- a/docs/en/edge/cordova/contacts/contacts.find.md
+++ b/docs/en/edge/cordova/contacts/contacts.find.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -20,25 +20,38 @@ license: Licensed to the Apache Software Foundation (ASF) under one
contacts.find
=============
-Queries the device contacts database and returns one or more `Contact` objects, each containing the fields specified.
+Queries the device contacts database and returns one or more `Contact`
+objects, each containing the fields specified.
navigator.contacts.find(contactFields, contactSuccess, contactError, contactFindOptions);
Description
-----------
-contacts.find is an asynchronous function that queries the device contacts database and returns an array of `Contact` objects. The resulting objects are passed to the `contactSuccess` callback function specified by the __contactSuccess__ parameter.
+The `contacts.find` method executes asynchronously, querying the
+device contacts database and returning an array of `Contact` objects.
+The resulting objects are passed to the `contactSuccess` callback
+function specified by the __contactSuccess__ parameter.
-Users must specify the contact fields to be used as a search qualifier in the __contactFields__ parameter. Only the fields specified in the __contactFields__ parameter will be returned as properties of the `Contact` objects that are passed to the __contactSuccess__ callback function. A zero-length __contactFields__ parameter is invalid and will result in a `ContactError.INVALID_ARGUMENT_ERROR` . A __contactFields__ value of ["*"] will return all contact fields.
+The __contactFields__ parameter specifies the fields to be used as a
+search qualifier, and only those results are passed to the
+__contactSuccess__ callback function. A zero-length __contactFields__
+parameter is invalid and results in
+`ContactError.INVALID_ARGUMENT_ERROR`. A __contactFields__ value of
+`"*"` returns all contact fields.
-The __contactFindOptions.filter__ string can be used as a search filter when querying the contacts database. If provided, a case-insensitive, partial value match is applied to each field specified in the __contactFields__ parameter. If a match is found in a comparison with _any_ of the specified fields, the contact is returned.
+The __contactFindOptions.filter__ string can be used as a search
+filter when querying the contacts database. If provided, a
+case-insensitive, partial value match is applied to each field
+specified in the __contactFields__ parameter. If there's a match for
+_any_ of the specified fields, the contact is returned.
Parameters
----------
-- __contactFields:__ Contact fields to be used as search qualifier. Only these fields will have values in the resulting `Contact` objects. _(DOMString[])_ [Required]
-- __contactSuccess:__ Success callback function that is invoked with the contacts returned from the contacts database. [Required]
-- __contactError:__ Error callback function. Invoked when error occurs. [Optional]
+- __contactFields:__ Contact fields to use as a search qualifier. Only these fields will have values in the resulting `Contact` objects. _(DOMString[])_ [Required]
+- __contactSuccess:__ Success callback function invoked with the contacts returned from the database. [Required]
+- __contactError:__ Error callback function, invoked when an error occurs. [Optional]
- __contactFindOptions:__ Search options to filter contacts. [Optional]
Supported Platforms
@@ -65,7 +78,7 @@ Quick Example
// find all contacts with 'Bob' in any name field
var options = new ContactFindOptions();
options.filter="Bob";
- options.multiple=true;
+ options.multiple=true;
var fields = ["displayName", "name"];
navigator.contacts.find(fields, onSuccess, onError, options);
@@ -89,7 +102,7 @@ Full Example
function onDeviceReady() {
// find all contacts with 'Bob' in any name field
var options = new ContactFindOptions();
- options.filter="Bob";
+ options.filter="Bob";
var fields = ["displayName", "name"];
navigator.contacts.find(fields, onSuccess, onError, options);
}
@@ -115,5 +128,4 @@ Full Example
<p>Find Contacts</p>
</body>
</html>
-
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/contacts.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/contacts.md b/docs/en/edge/cordova/contacts/contacts.md
index 28e3e5e..3ed59e5 100644
--- a/docs/en/edge/cordova/contacts/contacts.md
+++ b/docs/en/edge/cordova/contacts/contacts.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/parameters/contactError.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/parameters/contactError.md b/docs/en/edge/cordova/contacts/parameters/contactError.md
index 6b50ddc..5c451b1 100644
--- a/docs/en/edge/cordova/contacts/parameters/contactError.md
+++ b/docs/en/edge/cordova/contacts/parameters/contactError.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -24,4 +24,4 @@ Error callback function for contact functions.
function(error) {
// Handle the error
- }
\ No newline at end of file
+ }
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/parameters/contactFields.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/parameters/contactFields.md b/docs/en/edge/cordova/contacts/parameters/contactFields.md
index 66c9d3d..d3b5988 100644
--- a/docs/en/edge/cordova/contacts/parameters/contactFields.md
+++ b/docs/en/edge/cordova/contacts/parameters/contactFields.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -20,6 +20,6 @@ license: Licensed to the Apache Software Foundation (ASF) under one
contactFields
=============
-Required parameter of the `contacts.find` method. Use this parameter to specify which fields should be included in the `Contact` objects resulting from a find operation.
+Required parameter for the `contacts.find` method, used to specify which fields should be included in the `Contact` objects resulting from a find operation.
["name", "phoneNumbers", "emails"]
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/parameters/contactFindOptions.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/parameters/contactFindOptions.md b/docs/en/edge/cordova/contacts/parameters/contactFindOptions.md
index 2eb9afc..660615b 100644
--- a/docs/en/edge/cordova/contacts/parameters/contactFindOptions.md
+++ b/docs/en/edge/cordova/contacts/parameters/contactFindOptions.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -20,16 +20,17 @@ license: Licensed to the Apache Software Foundation (ASF) under one
contactFindOptions
==================
-Optional parameter of the `contacts.find` method. Use this parameter to filter the contacts returned from the contacts database.
+Optional parameter of the `contacts.find` method, used to filter the
+contacts returned from the contacts database.
- {
- filter: "",
- multiple: true,
- };
+ {
+ filter: "",
+ multiple: true,
+ };
Options
-------
-- __filter:__ The search string used to filter contacts. _(DOMString)_ (Default: "")
-- __multiple:__ Determines if the find operation should return multiple contacts. _(Boolean)_ (Default: false)
+- __filter:__ The search string used to filter contacts. _(DOMString)_ (Default: `""`)
+- __multiple:__ Determines if the find operation returns multiple contacts. _(Boolean)_ (Default: `false`)
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/contacts/parameters/contactSuccess.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/parameters/contactSuccess.md b/docs/en/edge/cordova/contacts/parameters/contactSuccess.md
index 9068218..a8cf4dc 100644
--- a/docs/en/edge/cordova/contacts/parameters/contactSuccess.md
+++ b/docs/en/edge/cordova/contacts/parameters/contactSuccess.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -35,6 +35,7 @@ Example
-------
function contactSuccess(contacts) {
- for (var i=0; i<contacts.length; i++) {
- console.log("Display Name = " + contacts[i].displayName;
- }
\ No newline at end of file
+ for (var i=0; i<contacts.length; i++) {
+ console.log("Display Name = " + contacts[i].displayName);
+ }
+ }
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/device/device.cordova.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/device/device.cordova.md b/docs/en/edge/cordova/device/device.cordova.md
index 451aeb3..c7891ff 100644
--- a/docs/en/edge/cordova/device/device.cordova.md
+++ b/docs/en/edge/cordova/device/device.cordova.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -23,7 +23,7 @@ device.cordova
Get the version of Cordova running on the device.
var string = device.cordova;
-
+
Description
-----------
@@ -65,10 +65,10 @@ Full Example
function onDeviceReady() {
var element = document.getElementById('deviceProperties');
- element.innerHTML = 'Device Name: ' + device.name + '<br />' +
- 'Device Cordova: ' + device.cordova + '<br />' +
- 'Device Platform: ' + device.platform + '<br />' +
- 'Device UUID: ' + device.uuid + '<br />' +
+ element.innerHTML = 'Device Name: ' + device.name + '<br />' +
+ 'Device Cordova: ' + device.cordova + '<br />' +
+ 'Device Platform: ' + device.platform + '<br />' +
+ 'Device UUID: ' + device.uuid + '<br />' +
'Device Version: ' + device.version + '<br />';
}
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/device/device.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/device/device.md b/docs/en/edge/cordova/device/device.md
index 294cb42..3748d36 100644
--- a/docs/en/edge/cordova/device/device.md
+++ b/docs/en/edge/cordova/device/device.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/device/device.model.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/device/device.model.md b/docs/en/edge/cordova/device/device.model.md
index 7aaa5da..59a711b 100644
--- a/docs/en/edge/cordova/device/device.model.md
+++ b/docs/en/edge/cordova/device/device.model.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -23,11 +23,13 @@ device.model
Get the device's model name.
var string = device.model;
-
+
Description
-----------
-`device.model` returns the name of the device's model or product. This value is set by the device manufacturer and may be different across versions of the same product.
+The `device.model` returns the name of the device's model or
+product. The value is set by the device manufacturer and may be
+different across versions of the same product.
Supported Platforms
-------------------
@@ -71,11 +73,11 @@ Full Example
function onDeviceReady() {
var element = document.getElementById('deviceProperties');
- element.innerHTML = 'Device Name: ' + device.name + '<br />' +
- 'Device Cordova: ' + device.cordova + '<br />' +
- 'Device Platform: ' + device.platform + '<br />' +
- 'Device UUID: ' + device.uuid + '<br />' +
- 'Device Model: ' + device.model + '<br />' +
+ element.innerHTML = 'Device Name: ' + device.name + '<br />' +
+ 'Device Cordova: ' + device.cordova + '<br />' +
+ 'Device Platform: ' + device.platform + '<br />' +
+ 'Device UUID: ' + device.uuid + '<br />' +
+ 'Device Model: ' + device.model + '<br />' +
'Device Version: ' + device.version + '<br />';
}
@@ -86,23 +88,20 @@ Full Example
</body>
</html>
-
Android Quirks
--------------
-- Gets the [product name](http://developer.android.com/reference/android/os/Build.html#PRODUCT) instead of the [model name](http://developer.android.com/reference/android/os/Build.html#MODEL).
- - The product name is often the code name given during production.
- - e.g. Nexus One returns "Passion", Motorola Droid returns "voles"
+- Gets the [product name](http://developer.android.com/reference/android/os/Build.html#PRODUCT) instead of the [model name](http://developer.android.com/reference/android/os/Build.html#MODEL), which is often the production code name. For example, the Nexus One returns `Passion`, and Motorola Droid returns `voles`.
Windows Phone 7 and 8 Quirks
-------------
-- returns the manufacturer specified device model, for example, the Samsung Focus returns 'SGH-i917'
+- Returns the device model specified by the manufacturer. For example, the Samsung Focus returns `SGH-i917`.
Bada Quirks
-----------
-- returns the manufacturer model name. For example 'Samsung Wave S8500'
+- Returns the manufacturer model name, for example, `Samsung Wave S8500`
Tizen Quirks
-----------
-- returns the device model assigned by the vendor. For example 'TIZEN'
+- Returns the device model assigned by the vendor, for example, `TIZEN`
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/device/device.name.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/device/device.name.md b/docs/en/edge/cordova/device/device.name.md
index 180c770..5391f8d 100644
--- a/docs/en/edge/cordova/device/device.name.md
+++ b/docs/en/edge/cordova/device/device.name.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -19,16 +19,19 @@ license: Licensed to the Apache Software Foundation (ASF) under one
device.name
===========
-WARNING: device.name is deprecated as of version 2.3.0, use device.model instead
+
+__WARNING:__ `device.name` is deprecated as of version 2.3.0. Use `device.model` instead.
Get the device's model name.
var string = device.name;
-
+
Description
-----------
-`device.name` returns the name of the device's model or product. This value is set by the device manufacturer and may be different across versions of the same product.
+`device.name` returns the name of the device's model or product. This
+value is set by the device manufacturer and may be different across
+versions of the same product.
Supported Platforms
-------------------
@@ -72,11 +75,11 @@ Full Example
function onDeviceReady() {
var element = document.getElementById('deviceProperties');
- element.innerHTML = 'Device Name: ' + device.name + '<br />' +
- 'Device Cordova: ' + device.cordova + '<br />' +
- 'Device Platform: ' + device.platform + '<br />' +
- 'Device UUID: ' + device.uuid + '<br />' +
- 'Device Model: ' + device.model + '<br />' +
+ element.innerHTML = 'Device Name: ' + device.name + '<br />' +
+ 'Device Cordova: ' + device.cordova + '<br />' +
+ 'Device Platform: ' + device.platform + '<br />' +
+ 'Device UUID: ' + device.uuid + '<br />' +
+ 'Device Model: ' + device.model + '<br />' +
'Device Version: ' + device.version + '<br />';
}
@@ -87,23 +90,20 @@ Full Example
</body>
</html>
-
Android Quirks
--------------
-- Gets the [product name](http://developer.android.com/reference/android/os/Build.html#PRODUCT) instead of the [model name](http://developer.android.com/reference/android/os/Build.html#MODEL).
- - The product name is often the code name given during production.
- - e.g. Nexus One returns "Passion", Motorola Droid returns "voles"
+- Gets the [product name](http://developer.android.com/reference/android/os/Build.html#PRODUCT) instead of the [model name](http://developer.android.com/reference/android/os/Build.html#MODEL), which is often the production code name. For example, the Nexus One returns `Passion`, and Motorola Droid returns `voles`.
Windows Phone 7 and 8 Quirks
-------------
-- returns the manufacturer specified device name, for example, the Samsung Focus returns 'SGH-i917'
+- Returns the device model specified by the manufacturer. For example, the Samsung Focus returns `SGH-i917`.
Bada Quirks
-----------
-- returns the manufacturer model name. For example 'Samsung Wave S8500'
+- Returns the manufacturer model name, for example, `Samsung Wave S8500`
Tizen Quirks
-----------
-- returns the device model assigned by the vendor. For example 'TIZEN'
+- Returns the device model assigned by the vendor, for example, `TIZEN`
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6899777b/docs/en/edge/cordova/device/device.platform.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/device/device.platform.md b/docs/en/edge/cordova/device/device.platform.md
index 410798e..a259587 100644
--- a/docs/en/edge/cordova/device/device.platform.md
+++ b/docs/en/edge/cordova/device/device.platform.md
@@ -1,5 +1,5 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one
+ 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
@@ -68,10 +68,10 @@ Full Example
function onDeviceReady() {
var element = document.getElementById('deviceProperties');
- element.innerHTML = 'Device Name: ' + device.name + '<br />' +
- 'Device Cordova: ' + device.cordova + '<br />' +
- 'Device Platform: ' + device.platform + '<br />' +
- 'Device UUID: ' + device.uuid + '<br />' +
+ element.innerHTML = 'Device Name: ' + device.name + '<br />' +
+ 'Device Cordova: ' + device.cordova + '<br />' +
+ 'Device Platform: ' + device.platform + '<br />' +
+ 'Device UUID: ' + device.uuid + '<br />' +
'Device Version: ' + device.version + '<br />';
}
@@ -81,19 +81,20 @@ Full Example
<p id="deviceProperties">Loading device properties...</p>
</body>
</html>
-
+
BlackBerry Quirks
-----------------
-Devices may return the device platform version instead of the platform name. For example, the Storm2 9550 would return '2.13.0.95' or similar.
+Devices may return the device platform version number instead of the
+platform name. For example, the Storm2 9550 returns a value such as
+`2.13.0.95`.
Windows Phone 7 Quirks
-----------------
-Windows Phone 7 devices report platform as 'WinCE'
-
+Windows Phone 7 devices report the platform as `WinCE`.
Windows Phone 8 Quirks
-----------------
-Windows Phone 8 devices report platform as 'Win32NT'
+Windows Phone 8 devices report the platform as `Win32NT`.