Merge pull request #482 from theotherjimmy/cleanup-platform

Platform docs cleanup

Author: Amanda Butler

docs/reference/api/platform/ATCmdParser.md

@@ -2,7 +2,7 @@
 
 <span class="images">![](https://os-doc-builder.test.mbed.com/docs/development/mbed-os-api-doxy/classmbed_1_1_a_t_cmd_parser.png)<span>ATCmdParser class hierarchy</span></span>
 
-ATCmdParser is an Mbed OS compatible AT command parser. AT commands are instructions used to communicate with a communication device such as a modem, phone or Wi-Fi module. Each command is a text string in ASCII format, and every command starts with "AT" characters followed by a command specifying the operation to be carried out.
+ATCmdParser is an Mbed OS compatible AT command parser and serializer. AT commands are instructions used to communicate with a communication device such as a modem, phone or Wi-Fi module. Each command is a text string in ASCII format, and every command starts with "AT" characters followed by a command specifying the operation to be carried out.
 
 The ATCmdParser class in Mbed OS implements functionality to send and receive AT commands to devices capable of communicating using AT commands. The ATCmdParser internally uses the driver for the communication channel to talk to the device. It expects the driver to implement the FileHandle interface to invoke the functions on the driver.
 

docs/reference/api/platform/Callback.md

@@ -13,17 +13,34 @@ This is the technical reference for callbacks. You should read the [Callbacks](/
 
 ### Thread example with callbacks
 
-The Callback API provides a convenient way to pass arguments to spawned threads.
+The Callback API provides a convenient way to pass arguments to spawned threads. This example uses a C function pointer in the Callback.
 
  [![View code](https://www.mbed.com/embed/?url=https://os.mbed.com/teams/mbed_example/code/rtos_threading_with_callback/)](https://os.mbed.com/teams/mbed_example/code/rtos_threading_with_callback/file/d4b2a035ffe3/main.cpp)
 
 ### Sonar example
 
-Here is an example that uses everything discussed in the [introduction to callbacks](/docs/development/reference/platform.html#callbacks) document in the form of a minimal Sonar class.
+Here is an example that uses everything discussed in the [introduction to callbacks](/docs/development/reference/platform.html#callbacks) document in the form of a minimal Sonar class. This example uses a C++ class and method in the Callback.
 
 [![View code](https://www.mbed.com/embed/?url=https://os.mbed.com/teams/mbed_example/code/callback-sonar-example/)](https://os.mbed.com/teams/mbed_example/code/callback-sonar-example/file/1713cdc51510/main.cpp)
 
-### Related content
+### Calling callbacks
 
-- [Platform overview](/docs/development/reference/platform.html).
-- [Introduction to callbacks](/docs/development/reference/platform.html#callbacks).
+Callbacks overload the function call operator, so you can call a Callback like you would a normal function:
+
+```c++
+void run_timer_event(Callback<void(float)> on_timer) {
+    on_timer(1.0f);
+}
+```
+
+The only thing to watch out for is that the Callback type has a null Callback, just like a null function pointer. Uninitialized callbacks are null and assert if you call them. If you want a call to always succeed, you need to check if it is null first.
+
+``` c++
+void run_timer_event(Callback<void(float)> on_timer) {
+    if (on_timer) {
+        on_timer(1.0f);
+    }
+}
+```
+
+The Callback class is what’s known in C++ as a “Concrete Type”. That is, the Callback class is lightweight enough to be passed around like an int, pointer or other primitive type.