Re #1: examples and corrections

Author: projectkk2glider

lib/io.md

@@ -8,3 +8,45 @@ The **io** library has been simplified and only a subset of functions and their
 * [io.read()](io_read.md)
 * [io.write()](io_write.md)
 * [io.seek()](io_seek.md)
+
+
+## Examples
+
+### Read whole file
+
+```lua
+-- this is an OpenTX stand-alone script
+
+local function run(event)
+  print("lua io.read test")         -- print() statements are visible in Debug output window
+  local f = io.open("foo.bar", "r")
+  while true do
+    local data = io.read(f, 10)     -- read up to 10 characters (newline char also counts!)
+    if #data == 0 then break end    -- we get zero lenght string back when we reach end of the file
+    print("data: "..data)
+    end
+  io.close(f)
+  return 1
+end
+
+return {  run=run }
+```
+
+### Append data to file
+
+```lua
+-- this is an OpenTX stand-alone script
+
+local function run(event)
+  print("lua io.write test")
+  local f = io.open("foo.bar", "a")        -- open file in append mode
+  io.write(f, "first line\r\nsecond line\r\n")
+  io.write(f, 4, "\r\n", 35.6778, "\r\n")  -- one can write multiple items at the same time
+  local foo = -4.45
+  io.write(f, foo, "\r\n")
+  io.close(f)
+  return 1    -- this will end the script execution
+end
+
+return { run=run }
+```

lib/io_open.md

@@ -22,17 +22,3 @@ The io.open() function is used to open the file on SD card for subsequent readin
 * `<file object>` if file was successfully opened.
 
 * `nil` if file could not be opened.
-
-
-### io.seek(fd, offset)
-`fd` file object
-`offset` is always based from the beginning of the file. If offset is bigger than the file size, the pointer is moved to the end of the file.
-Other standard seek bases (like "cur", "end") are not supported.
-
-### io.read(fd, length)
-`fd` file object
-`length` number of characters to read.
-
-Other read *commands* (like "*all") are **not supported**.
-
-Return: string, number of characters returned is <= length. If end of file is reached, then empty string is returned.