docs(bluetooth): update docs

src/plugins/bluetoothserial.ts

@@ -5,43 +5,6 @@ import {Observable} from 'rxjs/Observable';
  * @name Bluetooth Serial
  * @description This plugin enables serial communication over Bluetooth. It was written for communicating between Android or iOS and an Arduino.
  * @usage
- */
-@Plugin({
-  repo: 'https://github.com/don/BluetoothSerial',
-  plugin: 'cordova-plugin-bluetooth-serial',
-  pluginRef: 'bluetoothSerial',
-  platforms: ['Android', 'iOS', 'Windows Phone', 'Browser']
-})
-export class BluetoothSerial {
-
-  /**
-   * Connect to a Bluetooth device
-   * Returns an Observable. Subscribe to connect, unsubscribe to disconnect.
-   * @param macAddress_or_uuid Identifier of the remote device
-   */
-  @Cordova({
-    platforms: ['Android', 'iOS', 'Windows Phone'],
-    observable: true,
-    clearFunction: 'disconnect'
-  })
-  static connect (macAddress_or_uuid: string): Observable<any> {return; }
-
-  /**
-   * Connect insecurely to a Bluetooth device
-   * Returns an Observable. Subscribe to connect, unsubscribe to disconnect.
-   * @param macAddress Identifier of the remote device
-   */
-  @Cordova({
-    platforms: ['Android'],
-    observable: true,
-    clearFunction: 'disconnect'
-  })
-  static connectInsecure (macAddress: string): Observable<any> {return; }
-
-  /**
-   * Writes data to the serial port
-   * @param data ArrayBuffer of data
-   * @usage
  * ```ts
  * // Write a string
  * Bluetooth.write("hello world").then(success, failure);
@@ -61,6 +24,43 @@ export class BluetoothSerial {
  * Bluetooth.write(data.buffer).then(success, failure);
  * ```
  */
+@Plugin({
+  repo: 'https://github.com/don/BluetoothSerial',
+  plugin: 'cordova-plugin-bluetooth-serial',
+  pluginRef: 'bluetoothSerial',
+  platforms: ['Android', 'iOS', 'Windows Phone', 'Browser']
+})
+export class BluetoothSerial {
+
+  /**
+   * Connect to a Bluetooth device
+   * @param {string} macAddress_or_uuid Identifier of the remote device
+   * @returns {Observable} Subscribe to connect, unsubscribe to disconnect.
+   */
+  @Cordova({
+    platforms: ['Android', 'iOS', 'Windows Phone'],
+    observable: true,
+    clearFunction: 'disconnect'
+  })
+  static connect (macAddress_or_uuid: string): Observable<any> {return; }
+
+  /**
+   * Connect insecurely to a Bluetooth device
+   * @param {string} macAddress Identifier of the remote device
+   * @returns {Observable} Subscribe to connect, unsubscribe to disconnect.
+   */
+  @Cordova({
+    platforms: ['Android'],
+    observable: true,
+    clearFunction: 'disconnect'
+  })
+  static connectInsecure (macAddress: string): Observable<any> {return; }
+
+  /**
+   * Writes data to the serial port
+   * @param {any} data ArrayBuffer of data
+   * @returns {Promise} returns a promise when data has been written
+   */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
   })
@@ -68,6 +68,7 @@ export class BluetoothSerial {
 
   /**
    * Gets the number of bytes of data available
+   * @returns {Promise} returns a promise that contains the available bytes
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -75,6 +76,7 @@ export class BluetoothSerial {
 
   /**
    * Reads data from the buffer
+   * @returns {Promise} returns a promise with data from the buffer
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -83,7 +85,8 @@ export class BluetoothSerial {
 
   /**
    * Reads data from the buffer until it reaches a delimiter
-   * @param delimiter
+   * @param {string} delimiter string that you want to search until
+   * @returns {Promise} returns a promise
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -92,7 +95,8 @@ export class BluetoothSerial {
 
   /**
    * Subscribe to be notified when data is received
-   * @param delimiter
+   * @param {string} delimiter the string you want to watch for
+   * @returns {Observable} returns an observable.
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone'],
@@ -103,6 +107,7 @@ export class BluetoothSerial {
 
   /**
    * Subscribe to be notified when data is received
+   * @returns {Observable} returns an observable
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone'],
@@ -113,6 +118,7 @@ export class BluetoothSerial {
 
   /**
    * Clears data in buffer
+   * @returns {Promise} returns a promise when completed
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -121,6 +127,7 @@ export class BluetoothSerial {
 
   /**
    * Lists bonded devices
+   * @returns {Promise} returns a promise
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -129,6 +136,7 @@ export class BluetoothSerial {
 
   /**
    * Reports if bluetooth is enabled
+   * @returns {Promise} returns a promise
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -137,6 +145,7 @@ export class BluetoothSerial {
 
   /**
    * Reports the connection status
+   * @returns {Promise} returns a promise
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -145,6 +154,7 @@ export class BluetoothSerial {
 
   /**
    * Reads the RSSI from the connected peripheral
+   * @returns {Promise} returns a promise
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -153,6 +163,7 @@ export class BluetoothSerial {
 
   /**
    * Show the Bluetooth settings on the device
+   * @returns {Promise} returns a promise
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -161,6 +172,7 @@ export class BluetoothSerial {
 
   /**
    * Enable Bluetooth on the device
+   * @returns {Promise} returns a promise
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -169,20 +181,7 @@ export class BluetoothSerial {
 
   /**
    * Discover unpaired devices
-   * @usage
-   * ```ts
-   * [{
-   *    "class": 276,
-   *    "id": "10:BF:48:CB:00:00",
-   *    "address": "10:BF:48:CB:00:00",
-   *    "name": "Nexus 7"
-   * }, {
-   *    "class": 7936,
-   *    "id": "00:06:66:4D:00:00",
-   *    "address": "00:06:66:4D:00:00",
-   *    "name": "RN42"
-   * }]
-   * ```
+   * @returns {Promise} returns a promise
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone']
@@ -191,6 +190,7 @@ export class BluetoothSerial {
 
   /**
    * Subscribe to be notified on Bluetooth device discovery. Discovery process must be initiated with the `discoverUnpaired` function.
+   * @returns {Observable} Returns an observable
    */
   @Cordova({
     platforms: ['Android', 'iOS', 'Windows Phone'],
@@ -201,7 +201,7 @@ export class BluetoothSerial {
 
   /**
    * Sets the human readable device name that is broadcasted to other devices
-   * @param newName Desired name of device
+   * @param {string} newName Desired name of device
    */
   @Cordova({
     platforms: ['Android'],
@@ -211,14 +211,11 @@ export class BluetoothSerial {
 
   /**
    * Makes the device discoverable by other devices
-   * @param discoverableDuration Desired number of seconds device should be discoverable for
+   * @param {number} discoverableDuration Desired number of seconds device should be discoverable for
    */
   @Cordova({
     platforms: ['Android'],
     sync: true
   })
   static setDiscoverable (discoverableDuration: number): void {}
-
-
-
 }