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/08/15 20:03:24 UTC
svn commit: r1514418 - in /cordova/site/public/docs/en: 3.0.0/ edge/
Author: mwbrooks
Date: Thu Aug 15 18:03:23 2013
New Revision: 1514418
URL: http://svn.apache.org/r1514418
Log:
Update documentation.
Modified:
cordova/site/public/docs/en/3.0.0/cordova_camera_camera.md.html
cordova/site/public/docs/en/3.0.0/cordova_contacts_contacts.md.html
cordova/site/public/docs/en/3.0.0/cordova_file_file.md.html
cordova/site/public/docs/en/3.0.0/cordova_geolocation_geolocation.md.html
cordova/site/public/docs/en/3.0.0/cordova_media_capture_capture.md.html
cordova/site/public/docs/en/3.0.0/guide_appdev_privacy_index.md.html
cordova/site/public/docs/en/3.0.0/guide_appdev_whitelist_index.md.html
cordova/site/public/docs/en/3.0.0/guide_overview_index.md.html
cordova/site/public/docs/en/3.0.0/guide_platforms_android_config.md.html
cordova/site/public/docs/en/3.0.0/guide_platforms_android_plugin.md.html
cordova/site/public/docs/en/3.0.0/guide_platforms_ios_config.md.html
cordova/site/public/docs/en/3.0.0/guide_platforms_ios_plugin.md.html
cordova/site/public/docs/en/3.0.0/guide_platforms_ios_webview.md.html
cordova/site/public/docs/en/3.0.0/plugin_ref_spec.md.html
cordova/site/public/docs/en/edge/cordova_camera_camera.md.html
cordova/site/public/docs/en/edge/cordova_contacts_contacts.md.html
cordova/site/public/docs/en/edge/cordova_file_file.md.html
cordova/site/public/docs/en/edge/cordova_geolocation_geolocation.md.html
cordova/site/public/docs/en/edge/cordova_media_capture_capture.md.html
cordova/site/public/docs/en/edge/guide_appdev_privacy_index.md.html
cordova/site/public/docs/en/edge/guide_appdev_whitelist_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_android_config.md.html
cordova/site/public/docs/en/edge/guide_platforms_android_plugin.md.html
cordova/site/public/docs/en/edge/guide_platforms_ios_config.md.html
cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html
cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html
cordova/site/public/docs/en/edge/plugin_ref_spec.md.html
Modified: cordova/site/public/docs/en/3.0.0/cordova_camera_camera.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/cordova_camera_camera.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/cordova_camera_camera.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/cordova_camera_camera.md.html Thu Aug 15 18:03:23 2013
@@ -159,7 +159,17 @@
<p>The <code>camera</code> object provides access to the device's default camera application.</p>
</blockquote>
-<p><strong>Important privacy note:</strong> Collection and use of images from a device's camera raises important privacy issues. Your app's privacy policy should discuss how the app uses the camera and whether the images recorded are shared with any other parties. In addition, if the app's use of the camera is not apparent in the user interface, you should provide a just-in-time notice prior to your app accessing the camera (if the device operating system doesn't do so already). That notice should provide the same information noted above, as well as obtaining the user's permission (e.g., by presenting choices for "OK" and "No Thanks"). For more information, please see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
+<p><strong>Important privacy note:</strong> Collection and use of images from a
+device's camera raises important privacy issues. Your app's privacy
+policy should discuss how the app uses the camera and whether the
+images recorded are shared with any other parties. In addition, if
+the app's use of the camera is not apparent in the user interface, you
+should provide a just-in-time notice prior to your app accessing the
+camera (if the device operating system doesn't do so already). That
+notice should provide the same information noted above, as well as
+obtaining the user's permission (e.g., by presenting choices for
+<strong>OK</strong> and <strong>No Thanks</strong>). For more information, please see the
+<a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
<h2>
<a name="Camera_methods">Methods</a>
@@ -571,7 +581,7 @@ function cameraCallback(imageData) {
<pre class="prettyprint"><code><a href="cordova_camera_camera.md.html#Camera">Camera</a>.DestinationType = {
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)
+ NATIVE_URI : 2 // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
};
</code></pre>
</li>
@@ -638,7 +648,7 @@ function cameraCallback(imageData) {
<li><p>Ignores the <code>sourceType</code> parameter.</p></li>
<li><p>Ignores the <code>allowEdit</code> parameter.</p></li>
<li><p>Application must have key injection permissions to <a href="cordova_inappbrowser_inappbrowser.md.html#close">close</a> the native <a href="cordova_camera_camera.md.html#Camera">Camera</a> application after the user snaps the photo.</p></li>
-<li><p>Using large image sizes may result in the inability to encode images on later-model devices (e.g. Torch 9800) that feature high-resolution cameras.</p></li>
+<li><p>Using large image sizes may result in the inability to encode images on later-model devices (e.g., Torch 9800) that feature high-resolution cameras.</p></li>
<li><p><code><a href="cordova_camera_camera.md.html#Camera">Camera</a>.MediaType</code> is not supported.</p></li>
<li><p>Ignores the <code>correctOrientation</code> parameter.</p></li>
<li><p>Ignores the <code>cameraDirection</code> parameter.</p></li>
Modified: cordova/site/public/docs/en/3.0.0/cordova_contacts_contacts.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/cordova_contacts_contacts.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/cordova_contacts_contacts.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/cordova_contacts_contacts.md.html Thu Aug 15 18:03:23 2013
@@ -207,7 +207,22 @@
<p>The <code>contacts</code> object provides access to the device contacts database.</p>
</blockquote>
-<p><strong>Important privacy note:</strong> Collection and use of contact data raises important privacy issues. Your app's privacy policy should discuss how the app uses contact data and whether it is shared with any other parties. <a href="cordova_contacts_contacts.md.html#Contact">Contact</a> information is considered sensitive because it reveals the people with whom a person communicates. Therefore, in addition to your app's privacy policy, you should strongly consider providing a just-in-time notice prior to your app accessing or using contact data (if the device operating system doesn't do so already). That notice should provide the same information noted above, as well as obtaining the user's permission (e.g., by presenting choices for "OK" and "No Thanks"). Note that some app marketplaces may require your app to provide just-in-time notice and obtain permission from the user prior to accessing contact data. A clear and easy to understand user experience surrounding the u
se of contact data will help avoid user confusion and perceived misuse of contact data. For more information, please see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
+<p><strong>Important privacy note:</strong> Collection and use of contact data raises
+important privacy issues. Your app's privacy policy should discuss
+how the app uses contact data and whether it is shared with any other
+parties. <a href="cordova_contacts_contacts.md.html#Contact">Contact</a> information is considered sensitive because it
+reveals the people with whom a person communicates. Therefore, in
+addition to your app's privacy policy, you should strongly consider
+providing a just-in-time notice prior to your app accessing or using
+contact data (if the device operating system doesn't do so
+already). That notice should provide the same information noted above,
+as well as obtaining the user's permission (e.g., by presenting
+choices for <strong>OK</strong> and <strong>No Thanks</strong>). Note that some app
+marketplaces may require your app to provide just-in-time notice and
+obtain permission from the user prior to accessing contact data. A
+clear and easy-to-understand user experience surrounding the use of
+contact data will help avoid user confusion and perceived misuse of
+contact data. For more information, please see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
<h2>
<a name="Contacts_methods">Methods</a>
@@ -1061,7 +1076,7 @@ string.</p>
<ul>
<li><p><strong>filter</strong>: The search string used to find contacts. <em>(DOMString)</em> (Default: <code>""</code>)</p></li>
-<li><p><strong>multiple</strong>: Determines if the find operation returns multiple contacts. <em>(Boolean)</em> (Default: false)</p></li>
+<li><p><strong>multiple</strong>: Determines if the find operation returns multiple contacts. <em>(Boolean)</em> (Default: <code>false</code>)</p></li>
</ul>
<h2>
<a name="ContactFindOptions_supported_platforms">Supported Platforms</a>
Modified: cordova/site/public/docs/en/3.0.0/cordova_file_file.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/cordova_file_file.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/cordova_file_file.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/cordova_file_file.md.html Thu Aug 15 18:03:23 2013
@@ -277,6 +277,12 @@ Interface</a>, to add or remove this fea
$ cordova plugin rm org.apache.cordova.core.file
</code></pre>
+<p>To use the file-transfer plugin you must add that separately.</p>
+
+<pre class="prettyprint"><code> $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer.git
+ $ cordova plugin rm org.apache.cordova.core.file-transfer
+</code></pre>
+
<p>These commands apply to all targeted platforms, but modify the
platform-specific configuration settings described below:</p>
@@ -1023,8 +1029,8 @@ specification.</p>
</h2>
<ul>
-<li><p><strong>isFile</strong>: Always true. <em>(boolean)</em></p></li>
-<li><p><strong>isDirectory</strong>: Always false. <em>(boolean)</em></p></li>
+<li><p><strong>isFile</strong>: Always <code>true</code>. <em>(boolean)</em></p></li>
+<li><p><strong>isDirectory</strong>: Always <code>false</code>. <em>(boolean)</em></p></li>
<li><p><strong>name</strong>: The name of the <code><a href="cordova_file_file.md.html#FileEntry">FileEntry</a></code>, excluding the path leading to it. <em>(DOMString)</em></p></li>
<li><p><strong>fullPath</strong>: The full absolute path from the root to the <code><a href="cordova_file_file.md.html#FileEntry">FileEntry</a></code>. <em>(DOMString)</em></p></li>
</ul>
@@ -1369,8 +1375,8 @@ specification.</p>
</h2>
<ul>
-<li><p><strong>isFile</strong>: Always false. <em>(boolean)</em></p></li>
-<li><p><strong>isDirectory</strong>: Always true. <em>(boolean)</em></p></li>
+<li><p><strong>isFile</strong>: Always <code>false</code>. <em>(boolean)</em></p></li>
+<li><p><strong>isDirectory</strong>: Always <code>true</code>. <em>(boolean)</em></p></li>
<li><p><strong>name</strong>: The name of the <code><a href="cordova_file_file.md.html#DirectoryEntry">DirectoryEntry</a></code>, excluding the path leading to it. <em>(DOMString)</em></p></li>
<li><p><strong>fullPath</strong>: The full absolute path from the root to the <code><a href="cordova_file_file.md.html#DirectoryEntry">DirectoryEntry</a></code>. <em>(DOMString)</em></p></li>
</ul>
@@ -1904,7 +1910,7 @@ device.</p>
<li><p><strong>successCallback</strong>: A callback that is passed a <code><a href="cordova_file_file.md.html#Metadata">Metadata</a></code> object. <em>(Function)</em></p></li>
<li><p><strong>errorCallback</strong>: A callback that executes if an error occurs retrieving the <code><a href="cordova_file_file.md.html#Metadata">Metadata</a></code>. Invoked with a <code><a href="cordova_file_file.md.html#FileTransferError">FileTransferError</a></code> object. <em>(Function)</em></p></li>
<li><p><strong>options</strong>: Optional parameters such as file name and mimetype.</p></li>
-<li><p><strong>trustAllHosts</strong>: Optional parameter, defaults to <code>false</code>. If set to true, it accepts all security certificates. This is useful since Android rejects self-signed security certificates. Not recommended for production use. Supported on Android and iOS. <em>(boolean)</em></p></li>
+<li><p><strong>trustAllHosts</strong>: Optional parameter, defaults to <code>false</code>. If set to <code>true</code>, it accepts all security certificates. This is useful since Android rejects self-signed security certificates. Not recommended for production use. Supported on Android and iOS. <em>(boolean)</em></p></li>
</ul>
<p><strong>Quick Example</strong></p>
@@ -2142,7 +2148,7 @@ fileTransfer.download(...); // or fileTr
</code></pre>
<p><strong>Quirks</strong>
-- On both Android an iOS, lengthComputable is false for downloads that use gzip encoding.</p>
+- On both Android an iOS, lengthComputable is <code>false</code> for downloads that use gzip encoding.</p>
<hr>
<h1><a name="FileUploadOptions">FileUploadOptions</a></h1>
Modified: cordova/site/public/docs/en/3.0.0/cordova_geolocation_geolocation.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/cordova_geolocation_geolocation.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/cordova_geolocation_geolocation.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/cordova_geolocation_geolocation.md.html Thu Aug 15 18:03:23 2013
@@ -186,7 +186,20 @@ device's actual location.</p>
<a class="external" href="http://dev.w3.org/geo/api/spec-source.html">W3C </a><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a> API Specification,
and only executes on devices that don't already provide an implementation.</p>
-<p><strong>Important privacy note:</strong> Collection and use of geolocation data raises important privacy issues. Your app's privacy policy should discuss how the app uses geolocation data, whether it is shared with any other parties, and the level of precision of the data (for example, coarse, fine, ZIP code level, etc.). <a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a> data is generally considered sensitive because it can reveal a person's whereabouts and, if stored, the history of his or her travels. Therefore, in addition to your app's privacy policy, you should strongly consider providing a just-in-time notice prior to your app accessing geolocation data (if the device operating system doesn't do so already). That notice should provide the same information noted above, as well as obtaining the user's permission (e.g., by presenting choices for "OK" and "No Thanks"). For more information, please see the <a href="guide_appdev_privacy_index.md.h
tml#Privacy%20Guide">Privacy Guide</a>.</p>
+<p><strong>Important privacy note:</strong> Collection and use of geolocation data
+raises important privacy issues. Your app's privacy policy should
+discuss how the app uses geolocation data, whether it is shared with
+any other parties, and the level of precision of the data (for
+example, coarse, fine, ZIP code level, etc.). <a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a> data is
+generally considered sensitive because it can reveal a person's
+whereabouts and, if stored, the history of his or her travels.
+Therefore, in addition to your app's privacy policy, you should
+strongly consider providing a just-in-time notice prior to your app
+accessing geolocation data (if the device operating system doesn't do
+so already). That notice should provide the same information noted
+above, as well as obtaining the user's permission (e.g., by presenting
+choices for <strong>OK</strong> and <strong>No Thanks</strong>). For more information, please
+see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
<h2>
<a name="Geolocation_methods">Methods</a>
Modified: cordova/site/public/docs/en/3.0.0/cordova_media_capture_capture.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/cordova_media_capture_capture.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/cordova_media_capture_capture.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/cordova_media_capture_capture.md.html Thu Aug 15 18:03:23 2013
@@ -196,7 +196,20 @@
<p>Provides access to the device's audio, image, and video capture capabilities.</p>
</blockquote>
-<p><strong>Important privacy note:</strong> Collection and use of images, video, or audio from the device's camera or microphone raises important privacy issues. Your app's privacy policy should discuss how the app uses such sensors and whether the data recorded is shared with any other parties. In addition, if the app's use of the camera or microphone is not apparent in the user interface, you should provide a just-in-time notice prior to your app accessing the camera or microphone (if the device operating system doesn't do so already). That notice should provide the same information noted above, as well as obtaining the user's permission (e.g., by presenting choices for "OK" and "No Thanks"). Note that some app marketplaces may require your app to provide just-in-time notice and obtain permission from the user prior to accessing the camera or microphone. For more information, please see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
+<p><strong>Important privacy note:</strong> Collection and use of images, video, or
+audio from the device's camera or microphone raises important privacy
+issues. Your app's privacy policy should discuss how the app uses
+such sensors and whether the data recorded is shared with any other
+parties. In addition, if the app's use of the camera or microphone is
+not apparent in the user interface, you should provide a just-in-time
+notice prior to your app accessing the camera or microphone (if the
+device operating system doesn't do so already). That notice should
+provide the same information noted above, as well as obtaining the
+user's permission (e.g., by presenting choices for <strong>OK</strong> and <strong>No
+Thanks</strong>). Note that some app marketplaces may require your app to
+provide just-in-time notice and obtain permission from the user prior
+to accessing the camera or microphone. For more information, please
+see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
<h2>
<a name="Capture_objects">Objects</a>
@@ -891,7 +904,7 @@ navigator.device.<a href="cordova_media_
<ul>
<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_INTERNAL_ERR</code>: The camera or microphone failed to capture image or sound.</p></li>
<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_APPLICATION_BUSY</code>: The camera or audio capture application is currently serving another capture request.</p></li>
-<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_INVALID_ARGUMENT</code>: Invalid use of the API (e.g. the value of <code>limit</code> is less than one).</p></li>
+<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_INVALID_ARGUMENT</code>: Invalid use of the API (e.g., the value of <code>limit</code> is less than one).</p></li>
<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_NO_MEDIA_FILES</code>: The user exits the camera or audio capture application before capturing anything.</p></li>
<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_NOT_SUPPORTED</code>: The requested capture operation is not supported.</p></li>
</ul>
@@ -1149,7 +1162,7 @@ the following default values:</p>
<p>Supports the following <code><a href="cordova_media_capture_capture.md.html#MediaFileData">MediaFileData</a></code> properties:</p>
<ul>
-<li><p><strong>codecs</strong>: Not supported, and returns null.</p></li>
+<li><p><strong>codecs</strong>: Not supported, and returns <code>null</code>.</p></li>
<li><p><strong>bitrate</strong>: Supported on iOS4 devices for audio only. Returns zero for images and videos.</p></li>
<li><p><strong>height</strong>: Supported: image and video files only.</p></li>
<li><p><strong>width</strong>: Supported: image and video files only.</p></li>
Modified: cordova/site/public/docs/en/3.0.0/guide_appdev_privacy_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/guide_appdev_privacy_index.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/guide_appdev_privacy_index.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/guide_appdev_privacy_index.md.html Thu Aug 15 18:03:23 2013
@@ -123,9 +123,16 @@
<div id="content">
<h1><a name="Privacy%20Guide">Privacy Guide</a></h1>
-<p>Mobile privacy is a critical issue that every app developer must address. Your users expect that their private information will be collected and treated appropriately by your app. Also, there are an increasing number of jurisdictions that now have legal requirements regarding mobile privacy practices.</p>
+<p>Mobile privacy is a critical issue that every app developer must
+address. Your users expect that their private information will be
+collected and treated appropriately by your app. Also, there are an
+increasing number of jurisdictions that now have legal requirements
+regarding mobile privacy practices.</p>
-<p>This guide on mobile app privacy should be considered a "primer" addressing some the most significant issues. It outlines some broadly accepted best practices and provides references to other more detailed guides and references.</p>
+<p>This guide on mobile app privacy should be considered a <em>primer</em>
+addressing some the most significant issues. It outlines some broadly
+accepted best practices and provides references to other more detailed
+guides and references.</p>
<ul>
<li><p><strong>Privacy Policy</strong>: You app should include a privacy policy that
@@ -138,7 +145,7 @@ users to review prior to download, such
the app marketplace. In addition, you should make your privacy
policy available within the app itself. The limited size of mobile
device displays creates challenges for displaying privacy policies
-to users. Consider developing a "short form" of the policy that
+to users. Consider developing a <em>short form</em> of the policy that
includes the most important information, and then provide a link to
the "long form" policy for those interested in more details. Several
groups are attempting to develop icon-based standards for
Modified: cordova/site/public/docs/en/3.0.0/guide_appdev_whitelist_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/guide_appdev_whitelist_index.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/guide_appdev_whitelist_index.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/guide_appdev_whitelist_index.md.html Thu Aug 15 18:03:23 2013
@@ -166,12 +166,12 @@ access to specific network domains and s
<pre class="prettyprint"><code>http://maps.google.com
</code></pre>
-<p>Access to all the subdomains on <a class="external" href="http://google.com">google.com</a> (e.g. <a class="external" href="http://mail.google.com">mail.google.com</a> and <a class="external" href="http://docs.google.com">docs.google.com</a>):</p>
+<p>Access to all the subdomains on <a class="external" href="http://google.com">google.com</a> (e.g., <a class="external" href="http://mail.google.com">mail.google.com</a> and <a class="external" href="http://docs.google.com">docs.google.com</a>):</p>
<pre class="prettyprint"><code>http://*.google.com
</code></pre>
-<p>Access to all domains (e.g. <a class="external" href="http://google.com">google.com</a> and <a class="external" href="http://developer.mozilla.org">developer.mozilla.org</a>):</p>
+<p>Access to all domains (e.g., <a class="external" href="http://google.com">google.com</a> and <a class="external" href="http://developer.mozilla.org">developer.mozilla.org</a>):</p>
<pre class="prettyprint"><code>*
</code></pre>
Modified: cordova/site/public/docs/en/3.0.0/guide_overview_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/guide_overview_index.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/guide_overview_index.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/guide_overview_index.md.html Thu Aug 15 18:03:23 2013
@@ -384,8 +384,10 @@ CLI's shorthand stubs.)</p>
<td data-col="blackberry" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="winphone7" class="p">(no <a href="cordova_file_file.md.html#FileTransfer">FileTransfer</a>)</td>
- <td data-col="winphone8" class="p">(no <a href="cordova_file_file.md.html#FileTransfer">FileTransfer</a>)</td>
+ <td data-col="winphone7" class="p">no <a href="cordova_file_file.md.html#FileTransfer">FileTransfer</a>
+</td>
+ <td data-col="winphone8" class="p">no <a href="cordova_file_file.md.html#FileTransfer">FileTransfer</a>
+</td>
<td data-col="win8" class="y"></td>
<td data-col="tizen" class="n"></td>
</tr>
Modified: cordova/site/public/docs/en/3.0.0/guide_platforms_android_config.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/guide_platforms_android_config.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/guide_platforms_android_config.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/guide_platforms_android_config.md.html Thu Aug 15 18:03:23 2013
@@ -136,7 +136,7 @@ across the application, and per CordovaW
breaking existing apps. The available preferences are:</p>
<ul>
-<li><p><code>useBrowserHistory</code> (boolean, defaults to <code>true</code>): set to false if you
+<li><p><code>useBrowserHistory</code> (boolean, defaults to <code>true</code>): set to <code>false</code> 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)</p></li>
@@ -145,11 +145,11 @@ app. The value's format is <em>Title, Me
<li><p><code>loadingPageDialog</code>: Display a native loading dialog when loading
sub-pages. The value's format is <em>Title, Message</em></p></li>
<li><p><code>errorUrl</code>: Set the error page for your application. Should be
-located in your Android project in file://android_asset/www/</p></li>
+located in your Android project in <code>file://android_asset/www/</code></p></li>
<li><p><code>backgroundColor</code>: Set the background color for your application.
Supports a four-byte hex value, with the first byte representing
alpha value, and the following three bytes with standard RGB
-values. (i.e. 0x00000000 = Black)</p></li>
+values. For example, <code>0x00000000</code> is black.</p></li>
<li><p><code>loadUrlTimeoutValue</code>: How much time Cordova should wait before
throwing a timeout error on the application.</p></li>
<li><p><code>keepRunning</code> (boolean, defaults to <code>true</code>): Determines whether
Modified: cordova/site/public/docs/en/3.0.0/guide_platforms_android_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/guide_platforms_android_plugin.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/guide_platforms_android_plugin.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/guide_platforms_android_plugin.md.html Thu Aug 15 18:03:23 2013
@@ -292,7 +292,7 @@ public class Echo extends CordovaPlugin
the top. Our class extends from <code>CordovaPlugin</code>. We override the
execute() method in order to recieve messages from exec(). Our method
first compares against <code>action</code>: this plugin only supports one action,
-the <code>echo</code> action. Any other action returns false, which results in an
+the <code>echo</code> action. Any other action returns <code>false</code>, which results in an
error of type <code>INVALID_ACTION</code>, which translates into an error
callback invocation on the JavaScript side. Next, we grab the echo
string using the <code>getString</code> method on our <code>args</code>, telling it we want
Modified: cordova/site/public/docs/en/3.0.0/guide_platforms_ios_config.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/guide_platforms_ios_config.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/guide_platforms_ios_config.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/guide_platforms_ios_config.md.html Thu Aug 15 18:03:23 2013
@@ -142,21 +142,21 @@ you don't want the WebView to rubber-ban
<li><p><code>TopActivityIndicator</code> (string, defaults to <code>gray</code>): this is the top
spinning throbber in the status/battery bar, valid values are
<code>whiteLarge</code>, <code>white</code>, and <code>gray</code>.</p></li>
-<li><p><code>EnableLocation</code> (boolean, defaults to <code>false</code>): set to true, to
+<li><p><code>EnableLocation</code> (boolean, defaults to <code>false</code>): set to <code>true</code>, to
initialize the <a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a> plugin at start-up (so the fix on your
location can be more accurate) <strong>DEPRECATED</strong>: please set the
<code>onload</code> attribute of the <code><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></code> plugin to <code>true</code>
instead.</p></li>
-<li><p><code>EnableViewportScale</code> (boolean, defaults to <code>false</code>): set to true to
+<li><p><code>EnableViewportScale</code> (boolean, defaults to <code>false</code>): set to <code>true</code> to
prevent viewport scaling through a meta tag.</p></li>
-<li><p><code>AutoHideSplashScreen</code> (boolean, defaults to <code>true</code>): set to false to
+<li><p><code>AutoHideSplashScreen</code> (boolean, defaults to <code>true</code>): set to <code>false</code> to
control when the splashscreen is hidden through a JavaScript API.</p></li>
-<li><p><code>FadeSplashScreen</code> (boolean, defaults to <code>true</code>): set to false to
+<li><p><code>FadeSplashScreen</code> (boolean, defaults to <code>true</code>): set to <code>false</code> to
prevent the splash-screen to fade in and out when showing or hiding
it.</p></li>
<li><p><code>FadeSplashScreenDuration</code> (float, defaults to 2): The splash-screen
Fade duration in seconds.</p></li>
-<li><p><code>ShowSplashScreenSpinner</code> (boolean, defaults to <code>true</code>): set to false
+<li><p><code>ShowSplashScreenSpinner</code> (boolean, defaults to <code>true</code>): set to <code>false</code>
to hide the splash-screen spinner.</p></li>
<li><p><code>MediaPlaybackRequiresUserAction</code> (boolean, defaults to <code>false</code>): set
to true to not allow autoplayed HTML5 video.</p></li>
Modified: cordova/site/public/docs/en/3.0.0/guide_platforms_ios_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/guide_platforms_ios_plugin.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/guide_platforms_ios_plugin.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/guide_platforms_ios_plugin.md.html Thu Aug 15 18:03:23 2013
@@ -183,7 +183,7 @@ referenced by a call from JavaScript, un
<p>There is <em>no</em> designated initializer for plugins. Instead, plugins
should use the <code>pluginInitialize</code> method for their start-up logic.</p>
-<p>Plugins with long-running requests, background activity (e.g. playing
+<p>Plugins with long-running requests, background activity (e.g., playing
media), listeners or internal state should implement the <code>onReset</code>
method and stop or clean up those activities. This method is run when
the <code>UIWebView</code> navigates to a new page or refreshes, which reloads
@@ -239,7 +239,7 @@ callback does not fire.</p>
<li>
<code>messageAsMultipart</code> expects an <code>NSArray*</code> containing any of the other supported types, and sends the whole array as the <code>arguments</code> to your JavaScript callback.
<ul>
-<li>Quirk: this is not just syntactic sugar (though it is sweet). This way, all of the arguments are serialized or deserialized as necessary. e.g. it is safe to return <code>NSData*</code> as multipart, but not as <code>Array</code>/<code>Dictionary</code>.</li>
+<li>Quirk: this is not just syntactic sugar (though it is sweet). This way, all of the arguments are serialized or deserialized as necessary. E.g., it is safe to return <code>NSData*</code> as multipart, but not as <code>Array</code>/<code>Dictionary</code>.</li>
</ul>
</li>
</ul>
Modified: cordova/site/public/docs/en/3.0.0/guide_platforms_ios_webview.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/guide_platforms_ios_webview.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/guide_platforms_ios_webview.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/guide_platforms_ios_webview.md.html Thu Aug 15 18:03:23 2013
@@ -210,7 +210,7 @@ this if you have multiple boxes!</p></li
</code></pre>
</li>
<li>
-<p>Instantiate a new <code>CDVViewController</code>, and retain it somewhere (e.g. to a property in your class):</p>
+<p>Instantiate a new <code>CDVViewController</code>, and retain it somewhere (e.g., to a property in your class):</p>
<pre class="prettyprint"><code>CDVViewController* viewController = [CDVViewController new];
</code></pre>
Modified: cordova/site/public/docs/en/3.0.0/plugin_ref_spec.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.0.0/plugin_ref_spec.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.0.0/plugin_ref_spec.md.html (original)
+++ cordova/site/public/docs/en/3.0.0/plugin_ref_spec.md.html Thu Aug 15 18:03:23 2013
@@ -681,7 +681,7 @@ require extra steps that can't be easily
plugman's scope. Examples:</p>
<pre class="prettyprint"><code><info>
-You need to install **Google Play Services** from the `Android Extras` section using the Android SDK manager (run `android`).
+You need to install __Google Play Services__ from the `Android Extras` section using the Android SDK manager (run `android`).
You need to add the following line to your `local.properties`
Modified: cordova/site/public/docs/en/edge/cordova_camera_camera.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/cordova_camera_camera.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/cordova_camera_camera.md.html (original)
+++ cordova/site/public/docs/en/edge/cordova_camera_camera.md.html Thu Aug 15 18:03:23 2013
@@ -159,7 +159,17 @@
<p>The <code>camera</code> object provides access to the device's default camera application.</p>
</blockquote>
-<p><strong>Important privacy note:</strong> Collection and use of images from a device's camera raises important privacy issues. Your app's privacy policy should discuss how the app uses the camera and whether the images recorded are shared with any other parties. In addition, if the app's use of the camera is not apparent in the user interface, you should provide a just-in-time notice prior to your app accessing the camera (if the device operating system doesn't do so already). That notice should provide the same information noted above, as well as obtaining the user's permission (e.g., by presenting choices for "OK" and "No Thanks"). For more information, please see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
+<p><strong>Important privacy note:</strong> Collection and use of images from a
+device's camera raises important privacy issues. Your app's privacy
+policy should discuss how the app uses the camera and whether the
+images recorded are shared with any other parties. In addition, if
+the app's use of the camera is not apparent in the user interface, you
+should provide a just-in-time notice prior to your app accessing the
+camera (if the device operating system doesn't do so already). That
+notice should provide the same information noted above, as well as
+obtaining the user's permission (e.g., by presenting choices for
+<strong>OK</strong> and <strong>No Thanks</strong>). For more information, please see the
+<a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
<h2>
<a name="Camera_methods">Methods</a>
@@ -571,7 +581,7 @@ function cameraCallback(imageData) {
<pre class="prettyprint"><code><a href="cordova_camera_camera.md.html#Camera">Camera</a>.DestinationType = {
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)
+ NATIVE_URI : 2 // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
};
</code></pre>
</li>
@@ -638,7 +648,7 @@ function cameraCallback(imageData) {
<li><p>Ignores the <code>sourceType</code> parameter.</p></li>
<li><p>Ignores the <code>allowEdit</code> parameter.</p></li>
<li><p>Application must have key injection permissions to <a href="cordova_inappbrowser_inappbrowser.md.html#close">close</a> the native <a href="cordova_camera_camera.md.html#Camera">Camera</a> application after the user snaps the photo.</p></li>
-<li><p>Using large image sizes may result in the inability to encode images on later-model devices (e.g. Torch 9800) that feature high-resolution cameras.</p></li>
+<li><p>Using large image sizes may result in the inability to encode images on later-model devices (e.g., Torch 9800) that feature high-resolution cameras.</p></li>
<li><p><code><a href="cordova_camera_camera.md.html#Camera">Camera</a>.MediaType</code> is not supported.</p></li>
<li><p>Ignores the <code>correctOrientation</code> parameter.</p></li>
<li><p>Ignores the <code>cameraDirection</code> parameter.</p></li>
Modified: cordova/site/public/docs/en/edge/cordova_contacts_contacts.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/cordova_contacts_contacts.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/cordova_contacts_contacts.md.html (original)
+++ cordova/site/public/docs/en/edge/cordova_contacts_contacts.md.html Thu Aug 15 18:03:23 2013
@@ -207,7 +207,22 @@
<p>The <code>contacts</code> object provides access to the device contacts database.</p>
</blockquote>
-<p><strong>Important privacy note:</strong> Collection and use of contact data raises important privacy issues. Your app's privacy policy should discuss how the app uses contact data and whether it is shared with any other parties. <a href="cordova_contacts_contacts.md.html#Contact">Contact</a> information is considered sensitive because it reveals the people with whom a person communicates. Therefore, in addition to your app's privacy policy, you should strongly consider providing a just-in-time notice prior to your app accessing or using contact data (if the device operating system doesn't do so already). That notice should provide the same information noted above, as well as obtaining the user's permission (e.g., by presenting choices for "OK" and "No Thanks"). Note that some app marketplaces may require your app to provide just-in-time notice and obtain permission from the user prior to accessing contact data. A clear and easy to understand user experience surrounding the u
se of contact data will help avoid user confusion and perceived misuse of contact data. For more information, please see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
+<p><strong>Important privacy note:</strong> Collection and use of contact data raises
+important privacy issues. Your app's privacy policy should discuss
+how the app uses contact data and whether it is shared with any other
+parties. <a href="cordova_contacts_contacts.md.html#Contact">Contact</a> information is considered sensitive because it
+reveals the people with whom a person communicates. Therefore, in
+addition to your app's privacy policy, you should strongly consider
+providing a just-in-time notice prior to your app accessing or using
+contact data (if the device operating system doesn't do so
+already). That notice should provide the same information noted above,
+as well as obtaining the user's permission (e.g., by presenting
+choices for <strong>OK</strong> and <strong>No Thanks</strong>). Note that some app
+marketplaces may require your app to provide just-in-time notice and
+obtain permission from the user prior to accessing contact data. A
+clear and easy-to-understand user experience surrounding the use of
+contact data will help avoid user confusion and perceived misuse of
+contact data. For more information, please see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
<h2>
<a name="Contacts_methods">Methods</a>
@@ -1061,7 +1076,7 @@ string.</p>
<ul>
<li><p><strong>filter</strong>: The search string used to find contacts. <em>(DOMString)</em> (Default: <code>""</code>)</p></li>
-<li><p><strong>multiple</strong>: Determines if the find operation returns multiple contacts. <em>(Boolean)</em> (Default: false)</p></li>
+<li><p><strong>multiple</strong>: Determines if the find operation returns multiple contacts. <em>(Boolean)</em> (Default: <code>false</code>)</p></li>
</ul>
<h2>
<a name="ContactFindOptions_supported_platforms">Supported Platforms</a>
Modified: cordova/site/public/docs/en/edge/cordova_file_file.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/cordova_file_file.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/cordova_file_file.md.html (original)
+++ cordova/site/public/docs/en/edge/cordova_file_file.md.html Thu Aug 15 18:03:23 2013
@@ -1029,8 +1029,8 @@ specification.</p>
</h2>
<ul>
-<li><p><strong>isFile</strong>: Always true. <em>(boolean)</em></p></li>
-<li><p><strong>isDirectory</strong>: Always false. <em>(boolean)</em></p></li>
+<li><p><strong>isFile</strong>: Always <code>true</code>. <em>(boolean)</em></p></li>
+<li><p><strong>isDirectory</strong>: Always <code>false</code>. <em>(boolean)</em></p></li>
<li><p><strong>name</strong>: The name of the <code><a href="cordova_file_file.md.html#FileEntry">FileEntry</a></code>, excluding the path leading to it. <em>(DOMString)</em></p></li>
<li><p><strong>fullPath</strong>: The full absolute path from the root to the <code><a href="cordova_file_file.md.html#FileEntry">FileEntry</a></code>. <em>(DOMString)</em></p></li>
</ul>
@@ -1375,8 +1375,8 @@ specification.</p>
</h2>
<ul>
-<li><p><strong>isFile</strong>: Always false. <em>(boolean)</em></p></li>
-<li><p><strong>isDirectory</strong>: Always true. <em>(boolean)</em></p></li>
+<li><p><strong>isFile</strong>: Always <code>false</code>. <em>(boolean)</em></p></li>
+<li><p><strong>isDirectory</strong>: Always <code>true</code>. <em>(boolean)</em></p></li>
<li><p><strong>name</strong>: The name of the <code><a href="cordova_file_file.md.html#DirectoryEntry">DirectoryEntry</a></code>, excluding the path leading to it. <em>(DOMString)</em></p></li>
<li><p><strong>fullPath</strong>: The full absolute path from the root to the <code><a href="cordova_file_file.md.html#DirectoryEntry">DirectoryEntry</a></code>. <em>(DOMString)</em></p></li>
</ul>
@@ -1910,7 +1910,7 @@ device.</p>
<li><p><strong>successCallback</strong>: A callback that is passed a <code><a href="cordova_file_file.md.html#Metadata">Metadata</a></code> object. <em>(Function)</em></p></li>
<li><p><strong>errorCallback</strong>: A callback that executes if an error occurs retrieving the <code><a href="cordova_file_file.md.html#Metadata">Metadata</a></code>. Invoked with a <code><a href="cordova_file_file.md.html#FileTransferError">FileTransferError</a></code> object. <em>(Function)</em></p></li>
<li><p><strong>options</strong>: Optional parameters such as file name and mimetype.</p></li>
-<li><p><strong>trustAllHosts</strong>: Optional parameter, defaults to <code>false</code>. If set to true, it accepts all security certificates. This is useful since Android rejects self-signed security certificates. Not recommended for production use. Supported on Android and iOS. <em>(boolean)</em></p></li>
+<li><p><strong>trustAllHosts</strong>: Optional parameter, defaults to <code>false</code>. If set to <code>true</code>, it accepts all security certificates. This is useful since Android rejects self-signed security certificates. Not recommended for production use. Supported on Android and iOS. <em>(boolean)</em></p></li>
</ul>
<p><strong>Quick Example</strong></p>
@@ -2148,7 +2148,7 @@ fileTransfer.download(...); // or fileTr
</code></pre>
<p><strong>Quirks</strong>
-- On both Android an iOS, lengthComputable is false for downloads that use gzip encoding.</p>
+- On both Android an iOS, lengthComputable is <code>false</code> for downloads that use gzip encoding.</p>
<hr>
<h1><a name="FileUploadOptions">FileUploadOptions</a></h1>
Modified: cordova/site/public/docs/en/edge/cordova_geolocation_geolocation.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/cordova_geolocation_geolocation.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/cordova_geolocation_geolocation.md.html (original)
+++ cordova/site/public/docs/en/edge/cordova_geolocation_geolocation.md.html Thu Aug 15 18:03:23 2013
@@ -186,7 +186,20 @@ device's actual location.</p>
<a class="external" href="http://dev.w3.org/geo/api/spec-source.html">W3C </a><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a> API Specification,
and only executes on devices that don't already provide an implementation.</p>
-<p><strong>Important privacy note:</strong> Collection and use of geolocation data raises important privacy issues. Your app's privacy policy should discuss how the app uses geolocation data, whether it is shared with any other parties, and the level of precision of the data (for example, coarse, fine, ZIP code level, etc.). <a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a> data is generally considered sensitive because it can reveal a person's whereabouts and, if stored, the history of his or her travels. Therefore, in addition to your app's privacy policy, you should strongly consider providing a just-in-time notice prior to your app accessing geolocation data (if the device operating system doesn't do so already). That notice should provide the same information noted above, as well as obtaining the user's permission (e.g., by presenting choices for "OK" and "No Thanks"). For more information, please see the <a href="guide_appdev_privacy_index.md.h
tml#Privacy%20Guide">Privacy Guide</a>.</p>
+<p><strong>Important privacy note:</strong> Collection and use of geolocation data
+raises important privacy issues. Your app's privacy policy should
+discuss how the app uses geolocation data, whether it is shared with
+any other parties, and the level of precision of the data (for
+example, coarse, fine, ZIP code level, etc.). <a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a> data is
+generally considered sensitive because it can reveal a person's
+whereabouts and, if stored, the history of his or her travels.
+Therefore, in addition to your app's privacy policy, you should
+strongly consider providing a just-in-time notice prior to your app
+accessing geolocation data (if the device operating system doesn't do
+so already). That notice should provide the same information noted
+above, as well as obtaining the user's permission (e.g., by presenting
+choices for <strong>OK</strong> and <strong>No Thanks</strong>). For more information, please
+see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
<h2>
<a name="Geolocation_methods">Methods</a>
Modified: cordova/site/public/docs/en/edge/cordova_media_capture_capture.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/cordova_media_capture_capture.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/cordova_media_capture_capture.md.html (original)
+++ cordova/site/public/docs/en/edge/cordova_media_capture_capture.md.html Thu Aug 15 18:03:23 2013
@@ -196,7 +196,20 @@
<p>Provides access to the device's audio, image, and video capture capabilities.</p>
</blockquote>
-<p><strong>Important privacy note:</strong> Collection and use of images, video, or audio from the device's camera or microphone raises important privacy issues. Your app's privacy policy should discuss how the app uses such sensors and whether the data recorded is shared with any other parties. In addition, if the app's use of the camera or microphone is not apparent in the user interface, you should provide a just-in-time notice prior to your app accessing the camera or microphone (if the device operating system doesn't do so already). That notice should provide the same information noted above, as well as obtaining the user's permission (e.g., by presenting choices for "OK" and "No Thanks"). Note that some app marketplaces may require your app to provide just-in-time notice and obtain permission from the user prior to accessing the camera or microphone. For more information, please see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
+<p><strong>Important privacy note:</strong> Collection and use of images, video, or
+audio from the device's camera or microphone raises important privacy
+issues. Your app's privacy policy should discuss how the app uses
+such sensors and whether the data recorded is shared with any other
+parties. In addition, if the app's use of the camera or microphone is
+not apparent in the user interface, you should provide a just-in-time
+notice prior to your app accessing the camera or microphone (if the
+device operating system doesn't do so already). That notice should
+provide the same information noted above, as well as obtaining the
+user's permission (e.g., by presenting choices for <strong>OK</strong> and <strong>No
+Thanks</strong>). Note that some app marketplaces may require your app to
+provide just-in-time notice and obtain permission from the user prior
+to accessing the camera or microphone. For more information, please
+see the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>.</p>
<h2>
<a name="Capture_objects">Objects</a>
@@ -891,7 +904,7 @@ navigator.device.<a href="cordova_media_
<ul>
<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_INTERNAL_ERR</code>: The camera or microphone failed to capture image or sound.</p></li>
<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_APPLICATION_BUSY</code>: The camera or audio capture application is currently serving another capture request.</p></li>
-<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_INVALID_ARGUMENT</code>: Invalid use of the API (e.g. the value of <code>limit</code> is less than one).</p></li>
+<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_INVALID_ARGUMENT</code>: Invalid use of the API (e.g., the value of <code>limit</code> is less than one).</p></li>
<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_NO_MEDIA_FILES</code>: The user exits the camera or audio capture application before capturing anything.</p></li>
<li><p><code><a href="cordova_media_capture_capture.md.html#CaptureError">CaptureError</a>.CAPTURE_NOT_SUPPORTED</code>: The requested capture operation is not supported.</p></li>
</ul>
@@ -1149,7 +1162,7 @@ the following default values:</p>
<p>Supports the following <code><a href="cordova_media_capture_capture.md.html#MediaFileData">MediaFileData</a></code> properties:</p>
<ul>
-<li><p><strong>codecs</strong>: Not supported, and returns null.</p></li>
+<li><p><strong>codecs</strong>: Not supported, and returns <code>null</code>.</p></li>
<li><p><strong>bitrate</strong>: Supported on iOS4 devices for audio only. Returns zero for images and videos.</p></li>
<li><p><strong>height</strong>: Supported: image and video files only.</p></li>
<li><p><strong>width</strong>: Supported: image and video files only.</p></li>
Modified: cordova/site/public/docs/en/edge/guide_appdev_privacy_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_appdev_privacy_index.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_appdev_privacy_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_appdev_privacy_index.md.html Thu Aug 15 18:03:23 2013
@@ -123,9 +123,16 @@
<div id="content">
<h1><a name="Privacy%20Guide">Privacy Guide</a></h1>
-<p>Mobile privacy is a critical issue that every app developer must address. Your users expect that their private information will be collected and treated appropriately by your app. Also, there are an increasing number of jurisdictions that now have legal requirements regarding mobile privacy practices.</p>
+<p>Mobile privacy is a critical issue that every app developer must
+address. Your users expect that their private information will be
+collected and treated appropriately by your app. Also, there are an
+increasing number of jurisdictions that now have legal requirements
+regarding mobile privacy practices.</p>
-<p>This guide on mobile app privacy should be considered a "primer" addressing some the most significant issues. It outlines some broadly accepted best practices and provides references to other more detailed guides and references.</p>
+<p>This guide on mobile app privacy should be considered a <em>primer</em>
+addressing some the most significant issues. It outlines some broadly
+accepted best practices and provides references to other more detailed
+guides and references.</p>
<ul>
<li><p><strong>Privacy Policy</strong>: You app should include a privacy policy that
@@ -138,7 +145,7 @@ users to review prior to download, such
the app marketplace. In addition, you should make your privacy
policy available within the app itself. The limited size of mobile
device displays creates challenges for displaying privacy policies
-to users. Consider developing a "short form" of the policy that
+to users. Consider developing a <em>short form</em> of the policy that
includes the most important information, and then provide a link to
the "long form" policy for those interested in more details. Several
groups are attempting to develop icon-based standards for
Modified: cordova/site/public/docs/en/edge/guide_appdev_whitelist_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_appdev_whitelist_index.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_appdev_whitelist_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_appdev_whitelist_index.md.html Thu Aug 15 18:03:23 2013
@@ -166,12 +166,12 @@ access to specific network domains and s
<pre class="prettyprint"><code>http://maps.google.com
</code></pre>
-<p>Access to all the subdomains on <a class="external" href="http://google.com">google.com</a> (e.g. <a class="external" href="http://mail.google.com">mail.google.com</a> and <a class="external" href="http://docs.google.com">docs.google.com</a>):</p>
+<p>Access to all the subdomains on <a class="external" href="http://google.com">google.com</a> (e.g., <a class="external" href="http://mail.google.com">mail.google.com</a> and <a class="external" href="http://docs.google.com">docs.google.com</a>):</p>
<pre class="prettyprint"><code>http://*.google.com
</code></pre>
-<p>Access to all domains (e.g. <a class="external" href="http://google.com">google.com</a> and <a class="external" href="http://developer.mozilla.org">developer.mozilla.org</a>):</p>
+<p>Access to all domains (e.g., <a class="external" href="http://google.com">google.com</a> and <a class="external" href="http://developer.mozilla.org">developer.mozilla.org</a>):</p>
<pre class="prettyprint"><code>*
</code></pre>
Modified: cordova/site/public/docs/en/edge/guide_platforms_android_config.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_android_config.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_android_config.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_android_config.md.html Thu Aug 15 18:03:23 2013
@@ -136,7 +136,7 @@ across the application, and per CordovaW
breaking existing apps. The available preferences are:</p>
<ul>
-<li><p><code>useBrowserHistory</code> (boolean, defaults to <code>true</code>): set to false if you
+<li><p><code>useBrowserHistory</code> (boolean, defaults to <code>true</code>): set to <code>false</code> 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)</p></li>
@@ -145,11 +145,11 @@ app. The value's format is <em>Title, Me
<li><p><code>loadingPageDialog</code>: Display a native loading dialog when loading
sub-pages. The value's format is <em>Title, Message</em></p></li>
<li><p><code>errorUrl</code>: Set the error page for your application. Should be
-located in your Android project in file://android_asset/www/</p></li>
+located in your Android project in <code>file://android_asset/www/</code></p></li>
<li><p><code>backgroundColor</code>: Set the background color for your application.
Supports a four-byte hex value, with the first byte representing
alpha value, and the following three bytes with standard RGB
-values. (i.e. 0x00000000 = Black)</p></li>
+values. For example, <code>0x00000000</code> is black.</p></li>
<li><p><code>loadUrlTimeoutValue</code>: How much time Cordova should wait before
throwing a timeout error on the application.</p></li>
<li><p><code>keepRunning</code> (boolean, defaults to <code>true</code>): Determines whether
Modified: cordova/site/public/docs/en/edge/guide_platforms_android_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_android_plugin.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_android_plugin.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_android_plugin.md.html Thu Aug 15 18:03:23 2013
@@ -292,7 +292,7 @@ public class Echo extends CordovaPlugin
the top. Our class extends from <code>CordovaPlugin</code>. We override the
execute() method in order to recieve messages from exec(). Our method
first compares against <code>action</code>: this plugin only supports one action,
-the <code>echo</code> action. Any other action returns false, which results in an
+the <code>echo</code> action. Any other action returns <code>false</code>, which results in an
error of type <code>INVALID_ACTION</code>, which translates into an error
callback invocation on the JavaScript side. Next, we grab the echo
string using the <code>getString</code> method on our <code>args</code>, telling it we want
Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_config.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_config.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_config.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_config.md.html Thu Aug 15 18:03:23 2013
@@ -142,21 +142,21 @@ you don't want the WebView to rubber-ban
<li><p><code>TopActivityIndicator</code> (string, defaults to <code>gray</code>): this is the top
spinning throbber in the status/battery bar, valid values are
<code>whiteLarge</code>, <code>white</code>, and <code>gray</code>.</p></li>
-<li><p><code>EnableLocation</code> (boolean, defaults to <code>false</code>): set to true, to
+<li><p><code>EnableLocation</code> (boolean, defaults to <code>false</code>): set to <code>true</code>, to
initialize the <a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a> plugin at start-up (so the fix on your
location can be more accurate) <strong>DEPRECATED</strong>: please set the
<code>onload</code> attribute of the <code><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></code> plugin to <code>true</code>
instead.</p></li>
-<li><p><code>EnableViewportScale</code> (boolean, defaults to <code>false</code>): set to true to
+<li><p><code>EnableViewportScale</code> (boolean, defaults to <code>false</code>): set to <code>true</code> to
prevent viewport scaling through a meta tag.</p></li>
-<li><p><code>AutoHideSplashScreen</code> (boolean, defaults to <code>true</code>): set to false to
+<li><p><code>AutoHideSplashScreen</code> (boolean, defaults to <code>true</code>): set to <code>false</code> to
control when the splashscreen is hidden through a JavaScript API.</p></li>
-<li><p><code>FadeSplashScreen</code> (boolean, defaults to <code>true</code>): set to false to
+<li><p><code>FadeSplashScreen</code> (boolean, defaults to <code>true</code>): set to <code>false</code> to
prevent the splash-screen to fade in and out when showing or hiding
it.</p></li>
<li><p><code>FadeSplashScreenDuration</code> (float, defaults to 2): The splash-screen
Fade duration in seconds.</p></li>
-<li><p><code>ShowSplashScreenSpinner</code> (boolean, defaults to <code>true</code>): set to false
+<li><p><code>ShowSplashScreenSpinner</code> (boolean, defaults to <code>true</code>): set to <code>false</code>
to hide the splash-screen spinner.</p></li>
<li><p><code>MediaPlaybackRequiresUserAction</code> (boolean, defaults to <code>false</code>): set
to true to not allow autoplayed HTML5 video.</p></li>
Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html Thu Aug 15 18:03:23 2013
@@ -183,7 +183,7 @@ referenced by a call from JavaScript, un
<p>There is <em>no</em> designated initializer for plugins. Instead, plugins
should use the <code>pluginInitialize</code> method for their start-up logic.</p>
-<p>Plugins with long-running requests, background activity (e.g. playing
+<p>Plugins with long-running requests, background activity (e.g., playing
media), listeners or internal state should implement the <code>onReset</code>
method and stop or clean up those activities. This method is run when
the <code>UIWebView</code> navigates to a new page or refreshes, which reloads
@@ -239,7 +239,7 @@ callback does not fire.</p>
<li>
<code>messageAsMultipart</code> expects an <code>NSArray*</code> containing any of the other supported types, and sends the whole array as the <code>arguments</code> to your JavaScript callback.
<ul>
-<li>Quirk: this is not just syntactic sugar (though it is sweet). This way, all of the arguments are serialized or deserialized as necessary. e.g. it is safe to return <code>NSData*</code> as multipart, but not as <code>Array</code>/<code>Dictionary</code>.</li>
+<li>Quirk: this is not just syntactic sugar (though it is sweet). This way, all of the arguments are serialized or deserialized as necessary. E.g., it is safe to return <code>NSData*</code> as multipart, but not as <code>Array</code>/<code>Dictionary</code>.</li>
</ul>
</li>
</ul>
Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html Thu Aug 15 18:03:23 2013
@@ -210,7 +210,7 @@ this if you have multiple boxes!</p></li
</code></pre>
</li>
<li>
-<p>Instantiate a new <code>CDVViewController</code>, and retain it somewhere (e.g. to a property in your class):</p>
+<p>Instantiate a new <code>CDVViewController</code>, and retain it somewhere (e.g., to a property in your class):</p>
<pre class="prettyprint"><code>CDVViewController* viewController = [CDVViewController new];
</code></pre>
Modified: cordova/site/public/docs/en/edge/plugin_ref_spec.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/plugin_ref_spec.md.html?rev=1514418&r1=1514417&r2=1514418&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/plugin_ref_spec.md.html (original)
+++ cordova/site/public/docs/en/edge/plugin_ref_spec.md.html Thu Aug 15 18:03:23 2013
@@ -681,7 +681,7 @@ require extra steps that can't be easily
plugman's scope. Examples:</p>
<pre class="prettyprint"><code><info>
-You need to install **Google Play Services** from the `Android Extras` section using the Android SDK manager (run `android`).
+You need to install __Google Play Services__ from the `Android Extras` section using the Android SDK manager (run `android`).
You need to add the following line to your `local.properties`