Platform examples: Fix after review

Author: mprse

APIs_Platform/FileHandle/README.md

@@ -1,10 +1,10 @@
-## FileHandle example
-
-The example monitors a serial console device, and every time it outputs a character, send it to the console back and toggle LED2.
-
-1. Flash the board, and ensure the target's USB is plugged into the PC.
-2. Open serial console (select associated COM port, transmission speed: 19200 bps).
-3. Reset the target.
-4. Every time that device outputs a character, the character should appear in the console and LED2 should be toggled LED2.
-
-**Note:** You can check the associated serial port using `mbedls` command.
+## FileHandle example
+
+The example monitors a serial console device, and every time it reads a character, it sends it back to the console and toggles LED2.
+
+1. Flash the board, and ensure the target's USB is plugged into the PC.
+2. Open serial console (select associated COM port, transmission speed: 9600 bps).
+3. Reset the target.
+4. Every time that device reads a character, the character should appear in the console and LED2 should be toggled.
+
+**Note:** You can check the associated serial port using `mbedls` command.

APIs_Platform/FileHandle/main.cpp

@@ -11,9 +11,6 @@ static BufferedSerial device(STDIO_UART_TX, STDIO_UART_RX);
 
 int main()
 {
-    // Perform device-specific setup
-    device.set_baud(19200);
-
     // Once set up, access through the C library
     FILE *devin = fdopen(&device, "r");
 

APIs_Platform/FileHandle_sigio/README.md

@@ -1,10 +1,10 @@
 ## FileHandle sigio example
 
-The example monitors a serial console device, and every time it outputs a character, send it to the console back and toggle LED2.
+The example monitors a serial console device, and every time it reads a character, it sends it back to the console and toggles LED2.
 
 1. Flash the board, and ensure the target's USB is plugged into the PC.
-2. Open serial console (select associated COM port, transmission speed: 19200 bps).
+2. Open serial console (select associated COM port, transmission speed: 9600 bps).
 3. Reset the target.
-4. Every time that device outputs a character, the character should appear in the console and LED2 should be toggled LED2.
+4. Every time that device reads a character, the character should appear in the console and LED2 should be toggled.
 
 **Note:** You can check the associated serial port using `mbedls` command.

APIs_Platform/FileHandle_sigio/main.cpp

@@ -19,15 +19,13 @@ static void callback_ex()
             break;
         }
         putchar(c);
+        putchar('\n');
         led2 = !led2;
     }
 }
 
 int main()
 {
-    // BufferedSerial-specific method - all others are from FileHandle base class
-    device.set_baud(19200);
-
     // Ensure that device.read() returns -EAGAIN when out of data
     device.set_blocking(false);
 

APIs_Platform/Poll/README.md

@@ -19,7 +19,7 @@ The example transfers bidirectional data between two serial ports, acting as a v
 3. Connect second serial port to PC via USB to serial adapter (UART1).
 4. Open two serial consoles (select associated COM ports, transmission speed: 9600 bps).
 5. Reset the target.
-6. Data send from one console should appear in the other one and vice versa.
+6. Data sent from one console should appear in the other one and vice versa.
 
 **Note:** You can check the associated serial port using `mbedls` command (UART2).  
 **Note:** Note: On Windows you can check the associated COM port in the Device Manager (UART1).  

APIs_Platform/Poll/main.cpp

@@ -2,8 +2,6 @@
  * Copyright (c) 2006-2020 Arm Limited and affiliates.
  * SPDX-License-Identifier: Apache-2.0
  */
-// Transfer bidirectional data between two ports, acting as a virtual link.
-// poll() is used to monitor both ports for input.
 #include "mbed.h"
 
 // Pins for each port are specified using mbed_app.json. Assume no flow control.
@@ -37,6 +35,8 @@ static void copy_some(FileHandle *out, FileHandle *in)
     }
 }
 
+// Transfer bidirectional data between two ports, acting as a virtual link.
+// poll() is used to monitor both ports for input.
 int main()
 {
     pollfh fds[2];

APIs_Platform/ScopedRomWriteLock/README.md

@@ -1,3 +1,3 @@
-## ScopedRamExecutionLock example
+## ScopedRomWriteLock example
 
 The example shows how to use ScopedRomWriteLock class for enabling writing to ROM. 

APIs_Platform/ScopedRomWriteLock/main.cpp

@@ -6,7 +6,7 @@
 
 int main()
 {
-    // Enable execution from RAM while in main
+    // Enable writing to ROM while in main
     ScopedRomWriteLock make_rom_writable;
 
     //custom_flash_programming();