Capitalization and punctuation

Author: Mel W

features/nanostack/mbed-mesh-api/source/include/enet_tasklet.h

@@ -30,33 +30,33 @@ void enet_tasklet_init(void);
 /*
  * \brief Create network interface.
  *
- * \param device_id registered physical device
- * \return interface ID that can be used to communication with this interface
+ * \param device_id Registered physical device.
+ * \return interface ID used to communication with this interface.
  */
 int8_t enet_tasklet_network_init(int8_t device_id);
 
 /*
- * \brief Connect to ethernet network
+ * \brief Connect to Ethernet network.
  *
- * \param callback to be called when network state changes
- * \param nwk_interface_id to use for networking
+ * \param callback Call when network state changes.
+ * \param nwk_interface_id To use for networking.
  *
  */
 int8_t enet_tasklet_connect(void (*)(mesh_connection_status_t mesh_status), int8_t nwk_interface_id);
 
 /*
  * \brief Disconnect network interface.
  *
- * \param send_cb send possible network status change event if set to true.
+ * \param send_cb Send possible network status change event if set to `true`.
  * \return >= 0 if disconnected successfully.
- * \return < 0 in case of errors
+ * \return < 0 if error.
  */
 int8_t enet_tasklet_disconnect(bool send_cb);
 
 /*
- * \brief callback to be called when the link state changes.
+ * \brief Callback to call when the link state changes.
  *
- * \param up tells if the link is up or down
+ * \param up Tells if link is up or down.
  */
 void enet_tasklet_link_state_changed(bool up);