updated to 1.5.0

VERSION

@@ -1 +1 @@
-1.5.0rc1
+1.5.0

docs/en/1.5.0/config.json

@@ -0,0 +1,170 @@
+{
+    "language": "English",
+    "merge": {
+        "accelerometer.md": [
+            "phonegap/accelerometer/accelerometer.md",
+            "phonegap/accelerometer/accelerometer.getCurrentAcceleration.md",
+            "phonegap/accelerometer/accelerometer.watchAcceleration.md",
+            "phonegap/accelerometer/accelerometer.clearWatch.md",
+            "phonegap/accelerometer/acceleration/acceleration.md",
+            "phonegap/accelerometer/parameters/accelerometerSuccess.md",
+            "phonegap/accelerometer/parameters/accelerometerError.md",
+            "phonegap/accelerometer/parameters/accelerometerOptions.md"
+        ],
+        "camera.md": [
+            "phonegap/camera/camera.md",
+            "phonegap/camera/camera.getPicture.md",
+            "phonegap/camera/parameter/cameraSuccess.md",
+            "phonegap/camera/parameter/cameraError.md",
+            "phonegap/camera/parameter/cameraOptions.md"
+        ],
+        "capture.md": [
+            "phonegap/media/capture/capture.md",
+            "phonegap/media/capture/captureAudio.md",
+            "phonegap/media/capture/captureAudioOptions.md",
+            "phonegap/media/capture/captureImage.md",
+            "phonegap/media/capture/captureImageOptions.md",
+            "phonegap/media/capture/captureVideo.md",
+            "phonegap/media/capture/captureVideoOptions.md",
+            "phonegap/media/capture/CaptureError.md",
+            "phonegap/media/capture/CaptureCB.md",
+            "phonegap/media/capture/CaptureErrorCB.md",
+            "phonegap/media/capture/ConfigurationData.md",
+            "phonegap/media/capture/MediaFile.md",
+            "phonegap/media/capture/MediaFile.getFormatData.md",
+            "phonegap/media/capture/MediaFileData.md"
+        ],
+        "compass.md": [
+            "phonegap/compass/compass.md",
+            "phonegap/compass/compass.getCurrentHeading.md",
+            "phonegap/compass/compass.watchHeading.md",
+            "phonegap/compass/compass.clearWatch.md",
+            "phonegap/compass/compass.watchHeadingFilter.md",
+            "phonegap/compass/compass.clearWatchFilter.md",
+            "phonegap/compass/parameters/compassSuccess.md",
+            "phonegap/compass/parameters/compassError.md",
+            "phonegap/compass/parameters/compassOptions.md",
+            "phonegap/compass/parameters/compassHeading.md",
+            "phonegap/compass/compassError/compassError.md"
+        ],
+        "contacts.md": [
+            "phonegap/contacts/contacts.md",
+            "phonegap/contacts/contacts.create.md",
+            "phonegap/contacts/contacts.find.md",
+            "phonegap/contacts/Contact/contact.md",
+            "phonegap/contacts/ContactAddress/contactaddress.md",
+            "phonegap/contacts/ContactField/contactfield.md",
+            "phonegap/contacts/ContactFindOptions/contactfindoptions.md",
+            "phonegap/contacts/ContactName/contactname.md",
+            "phonegap/contacts/ContactOrganization/contactorganization.md",
+            "phonegap/contacts/ContactError/contactError.md",
+            "phonegap/contacts/parameters/contactSuccess.md",
+            "phonegap/contacts/parameters/contactError.md",
+            "phonegap/contacts/parameters/contactFields.md",
+            "phonegap/contacts/parameters/contactFindOptions.md"
+        ],
+        "device.md": [
+            "phonegap/device/device.md",
+            "phonegap/device/device.name.md",
+            "phonegap/device/device.phonegap.md",
+            "phonegap/device/device.platform.md",
+            "phonegap/device/device.uuid.md",
+            "phonegap/device/device.version.md"
+        ],
+        "events.md": [
+            "phonegap/events/events.md",
+            "phonegap/events/events.deviceready.md",
+            "phonegap/events/events.pause.md",
+            "phonegap/events/events.resume.md",
+            "phonegap/events/events.online.md",
+            "phonegap/events/events.offline.md",
+            "phonegap/events/events.backbutton.md",
+            "phonegap/events/events.batterycritical.md",
+            "phonegap/events/events.batterylow.md",
+            "phonegap/events/events.batterystatus.md",
+            "phonegap/events/events.menubutton.md",
+            "phonegap/events/events.searchbutton.md",
+            "phonegap/events/events.startcallbutton.md",
+            "phonegap/events/events.endcallbutton.md",
+            "phonegap/events/events.volumedownbutton.md",
+            "phonegap/events/events.volumeupbutton.md"
+        ],
+        "file.md": [
+            "phonegap/file/file.md",
+            "phonegap/file/fileobj/fileobj.md",
+            "phonegap/file/filereader/filereader.md",
+            "phonegap/file/filewriter/filewriter.md",
+            "phonegap/file/filesystem/filesystem.md",
+            "phonegap/file/fileentry/fileentry.md",
+            "phonegap/file/directoryentry/directoryentry.md",
+            "phonegap/file/directoryreader/directoryreader.md",
+            "phonegap/file/filetransfer/filetransfer.md",
+            "phonegap/file/fileuploadoptions/fileuploadoptions.md",
+            "phonegap/file/fileuploadresult/fileuploadresult.md",
+            "phonegap/file/flags/flags.md",
+            "phonegap/file/localfilesystem/localfilesystem.md",
+            "phonegap/file/metadata/metadata.md",
+            "phonegap/file/fileerror/fileerror.md",
+            "phonegap/file/filetransfererror/filetransfererror.md"
+        ],
+        "geolocation.md": [
+            "phonegap/geolocation/geolocation.md",
+            "phonegap/geolocation/geolocation.getCurrentPosition.md",
+            "phonegap/geolocation/geolocation.watchPosition.md",
+            "phonegap/geolocation/geolocation.clearWatch.md",
+            "phonegap/geolocation/Coordinates/coordinates.md",
+            "phonegap/geolocation/Position/position.md",
+            "phonegap/geolocation/PositionError/positionError.md",
+            "phonegap/geolocation/parameters/geolocationSuccess.md",
+            "phonegap/geolocation/parameters/geolocationError.md",
+            "phonegap/geolocation/parameters/geolocation.options.md"
+        ],
+        "media.md": [
+            "phonegap/media/media.md",
+            "phonegap/media/media.getCurrentPosition.md",
+            "phonegap/media/media.getDuration.md",
+            "phonegap/media/media.pause.md",
+            "phonegap/media/media.play.md",
+            "phonegap/media/media.release.md",
+            "phonegap/media/media.seekTo.md",
+            "phonegap/media/media.startRecord.md",
+            "phonegap/media/media.stop.md",
+            "phonegap/media/media.stopRecord.md",
+            "phonegap/media/MediaError/mediaError.md",
+            "phonegap/media/Parameters/mediaError.md"
+        ],
+        "network.md": [
+            "phonegap/network/network.md",
+            "phonegap/network/network.isReachable.md",
+            "phonegap/network/NetworkStatus/NetworkStatus.md",
+            "phonegap/network/parameters/reachableCallback.md",
+            "phonegap/network/parameters/reachableHostname.md",
+            "phonegap/network/parameters/reachableOptions.md"
+        ],
+        "connection.md": [
+            "phonegap/connection/connection.md",
+            "phonegap/connection/connection.type.md"
+        ],
+        "notification.md": [
+            "phonegap/notification/notification.md",
+            "phonegap/notification/notification.alert.md",
+            "phonegap/notification/notification.confirm.md",
+            "phonegap/notification/notification.beep.md",
+            "phonegap/notification/notification.vibrate.md"
+        ],
+        "storage.md": [
+            "phonegap/storage/storage.md",
+            "phonegap/storage/storage.opendatabase.md",
+            "phonegap/storage/parameters/name.md",
+            "phonegap/storage/parameters/version.md",
+            "phonegap/storage/parameters/display_name.md",
+            "phonegap/storage/parameters/size.md",
+            "phonegap/storage/database/database.md",
+            "phonegap/storage/sqltransaction/sqltransaction.md",
+            "phonegap/storage/sqlresultset/sqlresultset.md",
+            "phonegap/storage/sqlresultsetlist/sqlresultsetlist.md",
+            "phonegap/storage/sqlerror/sqlerror.md",
+            "phonegap/storage/localstorage/localstorage.md"
+        ]
+    }
+}

docs/en/1.5.0/guide/getting-started/android/index.md

@@ -0,0 +1,111 @@
+Getting Started with Android
+============================
+
+
+Video Tutorials:
+----------------
+
+- [PhoneGap and Android Quick Start Video Using Ecliplse](http://www.youtube.com/v/MzcIcyBYJMA?autoplay=1)
+
+
+1. Requirements
+---------------
+
+- Eclipse 3.4+
+
+There is also a [Terminal](http://wiki.phonegap.com/w/page/30864168/phonegap-android-terminal-quickstart) of this tutorial that doesn't use Eclipse.
+
+
+2. Install SDK + PhoneGap
+----------------------------
+
+- Download and install [Eclipse Classic](http://www.eclipse.org/downloads/)
+- Download and install [Android SDK](http://developer.android.com/sdk/index.html)
+- Download and install [ADT Plugin](http://developer.android.com/sdk/eclipse-adt.html#installing)
+- Donwload the latest copy of [PhoneGap](http://phonegap.com/download) and extract its contents. We will be working with the Android directory.
+
+ 3. Setup New Project
+-----------------------
+
+- Launch Eclipse, then under the menu select **New > Android Project**
+
+    ![](img/guide/getting-started/android/new_android_project.jpeg)
+- In the root directory of the project, create two new directories:
+ 	- **/libs**
+ 	- **assets/www**
+- Copy **phonegap.js** from your PhoneGap download earlier to **assets/www**
+- Copy **phonegap.jar** from your PhoneGap download earlier to **/libs**
+- Copy **xml** folder from your PhoneGap download earlier to **/res**
+- Make a few adjustments too the project's main Java file found in the **src** folder in Eclipse: (view image below)
+	- Change the class's extend from **Activity** to **DroidGap**
+	- Replace the **setContentView()** line with **super.loadUrl("file:///android_asset/www/index.html");**	
+	- Add **import com.phonegap.*;**
+	- Remove **import android.app.Activity;**
+
+	![](img/guide/getting-started/android/javaSrc.jpg)
+- You might experience an error here, where Eclipse can't find phonegap-1.0.0.jar. In this case, right click on the /libs folder and go to Build Paths/ > Configure Build Paths. Then, in the Libraries tab, add phonegap-1.0.0.jar to the Project. If Eclipse is being temperamental, you might need to refresh (F5) the project once again.
+- Right click on AndroidManifest.xml and select **Open With > Text Editor**
+- Paste the following permissions under versionName: (view image below)
+
+        <supports-screens android:largeScreens="true" android:normalScreens="true" android:smallScreens="true" android:resizeable="true" android:anyDensity="true" />
+        <uses-permission android:name="android.permission.CAMERA" />
+        <uses-permission android:name="android.permission.VIBRATE" />
+        <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+        <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
+        <uses-permission android:name="android.permission.READ_PHONE_STATE" />
+        <uses-permission android:name="android.permission.INTERNET" />
+        <uses-permission android:name="android.permission.RECEIVE_SMS" />
+        <uses-permission android:name="android.permission.RECORD_AUDIO" />
+        <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
+        <uses-permission android:name="android.permission.READ_CONTACTS" />
+        <uses-permission android:name="android.permission.WRITE_CONTACTS" />
+        <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+        <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.GET_ACCOUNTS" />
+        <uses-permission android:name="android.permission.BROADCAST_STICKY" />
+
+- Add `android:configChanges="orientation|keyboardHidden"` to the activity tag in AndroidManifest. (view image below)
+- Add a second activity under you appliction tag in AndroidManifest. (view image below)
+
+	    <activity android:name="com.phonegap.DroidGap" android:label="@string/app_name" android:configChanges="orientation|keyboardHidden"> <intent-filter> </intent-filter> </activity>
+
+	![](img/guide/getting-started/android/manifest.jpg)
+
+4. Hello World
+--------------    
+
+Now create and open a new file named **index.html** in the **assets/www** directory. Paste the following code:
+
+	    <!DOCTYPE HTML>
+        <html>
+        <head>
+        <title>PhoneGap</title>
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        </head>
+        <body>
+        <h1>Hello World</h1>
+        </body>
+        </html>
+
+    *phonegap.js might need to be replaced with phonegap-&lt;VERSION NUMBER&gt;.js
+
+
+5A. Deploy to Simulator
+-----------------------
+
+- Right click the project and go to **Run As** and click **Android Application**
+- Eclipse will ask you to select an appropriate AVD. If there isn't one, then you'll need to create it.
+
+
+5B. Deploy to Device
+--------------------
+
+- Make sure USB debugging is enabled on your device and plug it into your system. (Settings &gt; Applications &gt; Development)
+- Right click the project and go to **Run As** and click **Android Application**
+
+
+Done!
+-----
+
+You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/30862722/phonegap-android-eclipse-quickstart).
+

docs/en/1.5.0/guide/getting-started/blackberry/index.md

@@ -0,0 +1,63 @@
+Getting Started with Blackberry
+============================
+
+
+Video Tutorials:
+----------------
+
+- [PhoneGap and BlackBerry Widgets uick Start Video](http://www.youtube.com/v/eF0h0K0OLwI?autoplay=1)
+
+
+
+1. Requirements
+---------------
+
+- Windows XP (32-bit) or Windows 7 (32-bit and 64-bit) or Mac OSX 10.6.4+
+
+For 4.x devices check out [this guide](http://wiki.phonegap.com/w/page/25653281/Getting%20Started%20with%20PhoneGap-BlackBerry%20with%20the%20Latest%20Environment).
+
+
+2. Install SDK + PhoneGap
+-------------------------
+
+- (Windows Only) Download and install [SUN JDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html#jdk) (32-Bit Version). Add it to your PATH variable.
+- (Windows Only) Download and extract [Apache Ant](http://ant.apache.org/bindownload.cgi). Add it to your PATH variable.
+- Download [BlackBerry WebWorks Smartphone SDK](ttps://bdsc.webapps.blackberry.com/html5/download/sdk) for BlackBerry development and/or [BlackBerry WebWorks Tablet OS SDK](https://bdsc.webapps.blackberry.com/html5/download/sdk) for Playbook development. Keep note of the directories you install these SDKs.
+- Donwload the latest copy of [PhoneGap](http://phonegap.com/download) and extract its contents. We will be working with the Android directory.
+
+
+3. Setup New Project
+--------------------
+
+- Open up a command prompt/terminal and navigate to where you extracted PhoneGap. CD into the PhoneGapBlackBerry directory.
+- Create a PhoneGap BlackBerry and PlayBook project. Type 'ant create -Dproject.path='followed by the location you wish to create your project into the command prompt/terminal.
+- Change to the newly created directory located at `C:\Dev\bbw\sample`.
+- Open up the project.properties file with your favourite editor and change the lines `BlackBerry.bbwp.dir=` and `PlayBook.bbwp.dir=` to equal the respective install locations of the SDKs you downloaded earlier.
+
+
+4. Hello World
+--------------
+
+Build the PhoneGap sample project by typing `ant target build` in your command prompt/terminal while you are in your project's directory. Replace the target with either blackberry or playbook. Note this is the sample PhoneGap project and not a basic hello world application. You can go edit the index.html file located in the www directory of your project to make it say Hello World if you wish.
+
+
+5A. Deploy to Simulator (Windows Only)
+--------------------------------------
+
+- While in your project directory, in command prompt/terminal type `ant target load-simulator`. Replace the target with either blackberry or playbook.
+- Press the BlackBerry button on the simulator, go to downloads and you should see your app loaded there.
+
+
+5B. Deploy to Device (Windows and Mac)
+--------------------------------------
+
+- You have to have your signing keys from RIM by filling out this [form](https://www.blackberry.com/SignedKeys/).
+- While in your project directory, in command prompt/terminal type `ant target load-device`. Replace the target with either blackberry or playbook.
+- Press the BlackBerry button on the simulator, go to downloads and you should see your app loaded there.
+
+
+Done!
+-----
+
+You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/31930982/Getting-Started-with-PhoneGap-BlackBerry-WebWorks).
+

docs/en/1.5.0/guide/getting-started/index.md

@@ -0,0 +1,9 @@
+Getting Started Guides
+======================
+
+- Getting Started with Android
+- Getting Started with Blackberry
+- Getting Started with iOS
+- Getting Started with Symbian
+- Getting Started with WebOS
+- Getting Started with Windows Phone