missing cross refernces and grammar

connectivity/FEATURE_BLE/include/ble/Gap.h

@@ -413,8 +413,8 @@ public:
 
         /**
          * Called when connection attempt ends. Check event.getStatus() to see if connection
-         * was established. If this device is the peripheral and it as advertising this will
-         * end advertising which will also create the onAdvertisingEnd event.
+         * was established. If this device is the peripheral and it was advertising this will
+         * end the advertising set which will also create the onAdvertisingEnd event.
          *
          * @see startAdvertising()
          * @see connect()
@@ -1093,6 +1093,7 @@ public:
      * @see EventHandler::onUpdateConnectionParametersRequest when a central
      * receives a request to update the connection parameters.
      *
+     * @see onUpdateConnectionParametersRequest
      * @see acceptConnectionParametersUpdate to accept the request.
      * @see rejectConnectionParametersUpdate to reject the request.
      */

connectivity/FEATURE_BLE/include/ble/SecurityManager.h

@@ -273,6 +273,7 @@ public:
          * @param[in] result result of the pairing indicating success or reason for failure
          *
          * @see acceptPairingRequest()
+         * @see requestPairing()
          */
         virtual void pairingResult(ble::connection_handle_t connectionHandle, SecurityCompletionStatus_t result) {
             (void)connectionHandle;
@@ -626,8 +627,9 @@ public:
      *                     or cancelPairingRequest if the user wishes to reject it.
      * @return BLE_ERROR_NONE or appropriate error code indicating the failure reason.
      *
-     *
      * @see EventHandler::pairingRequest()
+     * @see EventHandler::acceptPairingRequest()
+     * @see EventHandler::cancelPairingRequest()
      */
     ble_error_t setPairingRequestAuthorisation(bool required = true);