Copy edit DiscoveredService.h

Make minor copy edits, mostly for active voice and branding.
pull/5392/head
Amanda Butler 2017-11-07 15:59:37 -06:00 committed by GitHub
parent 7a4ac93eb1
commit 4bf95bc3f8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 12 deletions

View File

@ -32,17 +32,17 @@
/** /**
* Representation of a GATT service discovered. * Representation of a GATT service discovered.
* *
* GATT Services are discovered on distant GATT servers by the discovery * The discovery procedure discovers GATT Services are discovered on distant
* procedure which can be initiated by calling * GATT servers, which can be initiated by calling
* GattClient::launchServiceDiscovery() or GattClient::discoverServices(). The * GattClient::launchServiceDiscovery() or GattClient::discoverServices(). The
* discovery process will pass instances of this class to the callback handling * discovery process passes instances of this class to the callback handling
* service discovered. * service discovered.
* *
* Discovered services are characterized by the UUID of the service discovered * Discovered services are characterized by the UUID of the service discovered
* and the range of the GATT attributes belonging to the service. * and the range of the GATT attributes belonging to the service.
* *
* The UUID can be queried by calling getUUID() while the begining of the * The UUID can be queried by calling getUUID() while the begining of the
* attribute range can be obtained via getStartHandle() and the end of the * attribute range can be obtained through getStartHandle() and the end of the
* attribute range with a call to getEndHandle(). * attribute range with a call to getEndHandle().
* *
* The characteristics composing the service may be discovered by the function * The characteristics composing the service may be discovered by the function
@ -84,8 +84,8 @@ public:
/** /**
* Construct a DiscoveredService instance. * Construct a DiscoveredService instance.
* *
* @important This API is not meant to be used publicly it is meant to be * @important This API is not meant to be used publicly. It is meant to be
* used by internal APIs of mbed BLE. * used by internal APIs of Mbed BLE.
*/ */
DiscoveredService() : DiscoveredService() :
uuid(UUID::ShortUUIDBytes_t(0)), uuid(UUID::ShortUUIDBytes_t(0)),
@ -96,8 +96,8 @@ public:
/** /**
* Set information about the discovered service. * Set information about the discovered service.
* *
* @important This API is not meant to be used publicly it is meant to be * @important This API is not meant to be used publicly. It is meant to be
* used by internal APIs of mbed BLE. * used by internal APIs of Mbed BLE.
* *
* @param[in] uuidIn The UUID of the discovered service. * @param[in] uuidIn The UUID of the discovered service.
* @param[in] startHandleIn The start handle of the discovered service in * @param[in] startHandleIn The start handle of the discovered service in
@ -118,8 +118,8 @@ public:
/** /**
* Set the start and end handle of the discovered service. * Set the start and end handle of the discovered service.
* *
* @important This API is not meant to be used publicly it is meant to be * @important This API is not meant to be used publicly. It is meant to be
* used by internal APIs of mbed BLE. * used by internal APIs of Mbed BLE.
* *
* @param[in] startHandleIn The start handle of the discovered service in * @param[in] startHandleIn The start handle of the discovered service in
* the peer's GATT server. * the peer's GATT server.
@ -137,8 +137,8 @@ public:
/** /**
* Set the long UUID of the discovered service. * Set the long UUID of the discovered service.
* *
* @important This API is not meant to be used publicly it is meant to be * @important This API is not meant to be used publicly. It is meant to be
* used by internal APIs of mbed BLE. * used by internal APIs of Mbed BLE.
* *
* @param[in] longUUID The bytes composing the long UUID of this discovered * @param[in] longUUID The bytes composing the long UUID of this discovered
* service. * service.