merged existing tool guides into a new Renoise Tool page

Author: emuell

docs/SUMMARY.md

@@ -10,17 +10,14 @@
 - [Guides](guide/README.md)
   - [Classes](guide/classes.md)
   - [Observables](guide/observables.md)
-  - [Files & Bits](guide/files&bits.md)
+  - [Renoise Application](guide/application.md)
+  - [Renoise Song](guide/song.md)
+  - [Renoise Tool](guide/tool.md)
+  - [File IO & Bits](guide/files&bits.md)
   - [Sockets](guide/sockets.md)
   - [MIDI](guide/midi.md)
   - [OSC](guide/osc.md)
   - [SQLite](guide/sqlite.md)
-  - [Renoise Application](guide/application.md)
-  - [Renoise Song](guide/song.md)
-  - [Tool Keybindings](guide/keybindings.md)
-  - [Tool Menu Entries](guide/menus.md)
-  - [Tool Views](guide/views.md)
-  - [Tool Preferences](guide/preferences.md)
 - [API Reference](API/README.md)
   <!-- API TOC START -->
   - [renoise](API/renoise.md)

docs/guide/application.md

@@ -1,4 +1,4 @@
-# The Renoise Application
+# Renoise Application
 
 The `renoise.app()` function is the entry point for interacting with the Renoise application itself. It returns a [`renoise.Application`](../API/renoise/renoise.Application.md) object, which provides access to global application states, functions for user interaction like dialogs, and control over the main window.
 

docs/guide/classes.md

@@ -88,7 +88,7 @@ The operators you can overload are:
 *   `__eq` (equality)
 *   `__call` (function call)
 *   `__unm` (unary minus)
-*   `__tostring`
+*   `__tostring` (serialization)
 *   `__len` (length operator `#`)
 
 Note: `__tostring` isn't really an operator, but it's the metamethod that is called by the standard library's `tostring()` function.

docs/guide/files&bits.md

@@ -1,8 +1,10 @@
-# Files & Bits
+# File IO & Bits
+
+The Renoise API uses Lua's standard [io library](https://www.lua.org/pil/21.html) to read or write external files.
 
 To access the raw bits and bytes of some data, for example, to read or write binary file streams, you can use the `bit` library. It's built into the Renoise API, so there's no need to `require` it.
 
-See the [LuaJIT bit library documentation](https://bitop.luajit.org/api.html) for more info and examples. For file operations, you can use Lua's standard [io library](https://www.lua.org/pil/21.html).
+See the [LuaJIT bit library documentation](https://bitop.luajit.org/api.html) for more info and examples. 
 
 ```lua
 -- Reading integer numbers or raw bytes from a file
@@ -31,7 +33,7 @@ local function read_dword(file)
   end   
 end
 
--- and so on (adapt as needed to mess with endianness!) ...
+-- and so on (adapt as needed to deal with endianness!) ...
 
 local file, err = io.open("some_binary_file.bin", "rb")
 if not file then