update definitions

Author: emuell

definitions

@@ -24,6 +24,20 @@
 ### installed_tools : table<[`string`](../../API/builtins/string.md), [`string`](../../API/builtins/string.md)><a name="installed_tools"></a>
 > **READ-ONLY** Returns information about all currently installed tools.
 
+### installed_tools_observable : [`renoise.Document.Observable`](../../API/renoise/renoise.Document.Observable.md)<a name="installed_tools_observable"></a>
+> Fired when the list of installed tools changed.
+
+### audio_plugin_effects_observable : [`renoise.Document.Observable`](../../API/renoise/renoise.Document.Observable.md)<a name="audio_plugin_effects_observable"></a>
+> Fired when the list of available audio plugin effects changed, for example
+> when scanning for new plugins in the preferences.
+> Use the component's `available_plugins` or `available_devices` properties
+> to access currently available devices which are supported by the component
+> such as the track device chains.
+
+### audio_plugin_instruments_observable : [`renoise.Document.Observable`](../../API/renoise/renoise.Document.Observable.md)<a name="audio_plugin_instruments_observable"></a>
+> Fired when the list of available audio plugin instruments changed, for example
+> when scanning for new plugins in the preferences.
+
 ### key_modifier_states : table<[`string`](../../API/builtins/string.md), [`string`](../../API/builtins/string.md)><a name="key_modifier_states"></a>
 > **Deprecated.** **READ-ONLY** Use `key_modifier_flags` instead
 
@@ -63,12 +77,12 @@
 ### show_custom_prompt([*self*](../../API/builtins/self.md), title : [`string`](../../API/builtins/string.md), content_view : [`renoise.Views.View`](../../API/renoise/renoise.Views.View.md), button_labels : [`string`](../../API/builtins/string.md)[], key_handler : [`KeyHandler`](#KeyHandler)[`?`](../../API/builtins/nil.md), key_handler_options : [`KeyHandlerOptions`](#keyhandleroptions)[`?`](../../API/builtins/nil.md), focus_handler : [`FocusHandler`](#FocusHandler)[`?`](../../API/builtins/nil.md))<a name="show_custom_prompt"></a>
 `->`label : [`string`](../../API/builtins/string.md)  
 
-> Opens a modal dialog with a title, custom content and custom button labels.  
+> Opens a modal dialog with a title, custom content and custom button labels.
 > See: `renoise.ViewBuilder` for more info about custom views.
 ### show_custom_dialog([*self*](../../API/builtins/self.md), title : [`DialogTitle`](#DialogTitle), content_view : [`renoise.Views.View`](../../API/renoise/renoise.Views.View.md), key_handler : [`KeyHandler`](#KeyHandler)[`?`](../../API/builtins/nil.md), key_handler_options : [`KeyHandlerOptions`](#keyhandleroptions)[`?`](../../API/builtins/nil.md), focus_handler : [`FocusHandler`](#FocusHandler)[`?`](../../API/builtins/nil.md))<a name="show_custom_dialog"></a>
 `->`[`renoise.Dialog`](../../API/renoise/renoise.Dialog.md)  
 
-> Shows a non modal dialog (a floating tool window) with custom content.  
+> Shows a non modal dialog (a floating tool window) with custom content.
 > When no key_handler is provided, the Escape key is used to close the dialog.
 > See: `renoise.ViewBuilder` for more info about custom views.
 ### show_menu([*self*](../../API/builtins/self.md), dialog : [`renoise.Dialog`](../../API/renoise/renoise.Dialog.md), menu_entries : [`DialogMenuEntry`](#dialogmenuentry)[], below_view : [`renoise.Views.View`](../../API/renoise/renoise.Views.View.md)[`?`](../../API/builtins/nil.md))<a name="show_menu"></a>
@@ -315,10 +329,10 @@
 >  * Windows : "shift", "alt", "control", "winkey"
 >  * Linux : "shift", "alt", "control", "meta"
 >  * Mac : "shift", "option", "control", "command".
-> If multiple modifiers are held down, the string will be formatted as  
+> If multiple modifiers are held down, the string will be formatted as
 > "<key> + <key>"
 > Their order will correspond to the following precedence
-> `shift + alt/option + control + winkey/meta/command`  
+> `shift + alt/option + control + winkey/meta/command`
 > If no modifier is pressed, this will be an empty string.  
   
 
@@ -347,13 +361,13 @@
   
 ### FocusHandler<a name="FocusHandler"></a>
 (dialogs : [`renoise.Dialog`](../../API/renoise/renoise.Dialog.md), focused : [`boolean`](../../API/builtins/boolean.md)) `->` [`KeyEvent`](#keyevent)[`?`](../../API/builtins/nil.md)  
-> Optional focus change notifier for a custom dialog.  
-> Will be called when the dialog gains of loses key focus. You maybe want to initialize 
+> Optional focus change notifier for a custom dialog.
+> Will be called when the dialog gains of loses key focus. You maybe want to initialize
 > your dloag's (modifier) keyboard states here.  
   
 ### KeyHandler<a name="KeyHandler"></a>
 (dialog : [`renoise.Dialog`](../../API/renoise/renoise.Dialog.md), key_event : [`KeyEvent`](#keyevent)) `->` [`KeyEvent`](#keyevent)[`?`](../../API/builtins/nil.md)  
-> Optional keyhandler to process key events on a custom dialog.  
+> Optional keyhandler to process key events on a custom dialog.
 > When returning the passed key from the key-handler function, the
 > key will be passed back to Renoise's key event chain, in order to allow
 > processing global Renoise key-bindings from your dialog. This will not work
@@ -376,10 +390,10 @@
 >  * Windows : "shift", "alt", "control", "winkey"
 >  * Linux : "shift", "alt", "control", "meta"
 >  * Mac : "shift", "option", "control", "command".
-> If multiple modifiers are held down, the string will be formatted as  
+> If multiple modifiers are held down, the string will be formatted as
 > "<key> + <key>"
 > Their order will correspond to the following precedence
-> `shift + alt/option + control + winkey/meta/command`  
+> `shift + alt/option + control + winkey/meta/command`
 > If no modifier is pressed, this will be an empty string.  
   
 

docs/API/renoise/renoise.Application.md

@@ -1,7 +1,7 @@
 # renoise.ApplicationTheme<a name="renoise.ApplicationTheme"></a>  
 > Application's theme colors and other general color theme properties.
 > 
-> Note: All properties and functions of the app theme are **read-only**, so the 
+> Note: All properties and functions of the app theme are **read-only**, so the
 > theme can't be modified here. Use the app's `renoise.Application:load_theme`
 > function to load and apply new themes instead.
 > 
@@ -14,11 +14,11 @@
 ---  
 ## Properties
 ### colors : { [ThemeColor]: RGBColor }<a name="colors"></a>
-> **READ-ONLY** Get all theme colors in a flat list of RGBColors. 
+> **READ-ONLY** Get all theme colors in a flat list of RGBColors.
 > Color table keys are string identifiers as used in the theme XML file,
 > but in lower case.
 > 
-> Note that if you only need to access a single color from the theme, 
+> Note that if you only need to access a single color from the theme,
 > use `renoise.app().theme.color(color_name)` instead.
 > 
 > To get notified of color changes, use `renoise.app().theme_observable`
@@ -58,11 +58,11 @@
 ### color([*self*](../../API/builtins/self.md), color_name : [`ThemeColor`](#ThemeColor))<a name="color"></a>
 `->`[`RGBColor`](#RGBColor)  
 
-> Get a single color from the theme using a color identifier as used 
+> Get a single color from the theme using a color identifier as used
 > in the theme XML file - but in lower case.
 > 
-> e.g. to access the button background color from the theme, use 
-> `renoise.app().theme.color("button_back")` 
+> e.g. to access the button background color from the theme, use
+> `renoise.app().theme.color("button_back")`
 > 
 > To get notified of color changes, use `renoise.app().theme_observable`
 > 

docs/API/renoise/renoise.ApplicationTheme.md

@@ -53,7 +53,7 @@
 > functions to it.
 
 ### script : [`renoise.InstrumentPhraseScript`](../../API/renoise/renoise.InstrumentPhraseScript.md)<a name="script"></a>
-> **READ-ONLY** Phrase script properties. Only used when `playback_mode` is 
+> **READ-ONLY** Phrase script properties. Only used when `playback_mode` is
 > set to `renoise.InstrumentPhrase.PLAY_SCRIPT`
 
 ### is_empty : [`boolean`](../../API/builtins/boolean.md)<a name="is_empty"></a>

docs/API/renoise/renoise.InstrumentPhrase.md

@@ -5,6 +5,12 @@
 
 ---  
 ## Properties
+### editor_visible : [`boolean`](../../API/builtins/boolean.md)<a name="editor_visible"></a>
+> When false, a preview of the script is shown instead of a text editor.
+
+### editor_visible_observable : [`renoise.Document.Observable`](../../API/renoise/renoise.Document.Observable.md)<a name="editor_visible_observable"></a>
+> fired, when the editor visibility changed.
+
 ### parameters : [`renoise.DeviceParameter`](../../API/renoise/renoise.DeviceParameter.md)[]<a name="parameters"></a>
 >  **READ-ONLY** List of script input parameters, if any.
 
@@ -40,7 +46,7 @@
 > functions to it.
 
 ### pending_changes : [`integer`](../../API/builtins/integer.md)<a name="pending_changes"></a>
-> **READ-ONLY** Number of changes since the last commit() or auto-commit call, 
+> **READ-ONLY** Number of changes since the last commit() or auto-commit call,
 > that have been applied to the parapgraphs.
 > Note: `auto-commit` only is applied for scripts which are currently edited.
 

docs/API/renoise/renoise.InstrumentPhraseScript.md

@@ -41,11 +41,11 @@
 > functions to it.
 
 ### tuning : [`number`](../../API/builtins/number.md)[]<a name="tuning"></a>
-> Array of custom pitch values relative to 1/1, used as custom tuning values for 
-> instrument sample playback. The root key is assumed to be middle C (48 in Renoise), 
-> The scale will be repeated, so only one octave of values should be defined. An 
-> octave may contain more or less than 12 notes. 
->  
+> Array of custom pitch values relative to 1/1, used as custom tuning values for
+> instrument sample playback. The root key is assumed to be middle C (48 in Renoise),
+> The scale will be repeated, so only one octave of values should be defined. An
+> octave may contain more or less than 12 notes.
+> 
 > When set mts_esp_tuning is disabled. Set an empty table to disable custom tuning
 > using default 12-TET tuning instead.
 > 
@@ -54,12 +54,12 @@
 > #### examples:
 > ```lua
 > -- Andreas Werckmeister's temperament III (the most famous one, 1681)
-> local well_tempered_tuning = { 
->   256/243, 1.117403, 32/27, 1.252827, 4/3, 1024/729, 
+> local well_tempered_tuning = {
+>   256/243, 1.117403, 32/27, 1.252827, 4/3, 1024/729,
 >   1.494927, 128/81, 1.670436, 16/9, 1.879241, 2/1
 > }
 > instrument.tuning = well_tempered_tuning
-> ``` 
+> ```
 
 ### tuning_observable : [`renoise.Document.Observable`](../../API/renoise/renoise.Document.Observable.md)<a name="tuning_observable"></a>
 > Track changes to document properties or general states by attaching listener

docs/API/renoise/renoise.InstrumentTriggerOptions.md

@@ -25,7 +25,7 @@
 > Pattern order list: Notifiers will only be fired when sequence positions are
 > added, removed or their order changed. To get notified of pattern assignment
 > changes use the property `pattern_assignments_observable`.
-> Use `set_pattern` to change a single pattern in the sequence. 
+> Use `set_pattern` to change a single pattern in the sequence.
 
 ### pattern_sequence_observable : [`renoise.Document.ObservableList`](../../API/renoise/renoise.Document.ObservableList.md)<a name="pattern_sequence_observable"></a>
 > Track changes to document lists by attaching listener functions to it.

docs/API/renoise/renoise.PatternSequencer.md

@@ -96,15 +96,15 @@
 > **READ-ONLY** The most recent error message.
 
 ### changes : [`integer`](../../API/builtins/integer.md)<a name="changes"></a>
-> **READ-ONLY** Number of database rows that were changed, inserted, or deleted by 
-> the most recent SQL statement. 
+> **READ-ONLY** Number of database rows that were changed, inserted, or deleted by
+> the most recent SQL statement.
 > Only changes that are directly specified by INSERT, UPDATE, or DELETE statements
 > are counted.
 > Auxiliary changes caused by triggers are not counted. Use `db.total_changes`
 > to find the total number of changes.
 
 ### total_changes : [`integer`](../../API/builtins/integer.md)<a name="total_changes"></a>
-> **READ-ONLY** The number of database rows that have been modified by INSERT, 
+> **READ-ONLY** The number of database rows that have been modified by INSERT,
 > UPDATE or DELETE statements since the database was opened.
 > This includes UPDATE, INSERT and DELETE statements executed as part of
 > trigger programs. All changes are counted as soon as the statement that
@@ -201,7 +201,7 @@
 ### interrupt([*self*](../../API/builtins/self.md))<a name="interrupt"></a>
 >  Causes any pending database operation to abort and return at the next opportunity.
 ### busy_handler([*self*](../../API/builtins/self.md), fun : (udata : [`any`](../../API/builtins/any.md), retries : [`integer`](../../API/builtins/integer.md)) `->` [`boolean`](../../API/builtins/boolean.md)[`?`](../../API/builtins/nil.md), data : [`any`](../../API/builtins/any.md))<a name="busy_handler"></a>
-> Sets or removes a busy handler for a SQLiteDatabase. 
+> Sets or removes a busy handler for a SQLiteDatabase.
 > `fun` is either a Lua function that implements the busy handler or `nil`
 > to remove a previously set handler. This function returns nothing.
 > The handler function is called with two parameters: `data` and the number
@@ -278,7 +278,7 @@
 > or 0 if the statement does not return data (for example an UPDATE).
 
 ### last_insert_rowid : [`integer`](../../API/builtins/integer.md)<a name="last_insert_rowid"></a>
-> **READ-ONLY** rowid of the most recent INSERT into the database corresponding 
+> **READ-ONLY** rowid of the most recent INSERT into the database corresponding
 > to this statement.
 
 ### named_types : table<[`string`](../../API/builtins/string.md), [`string`](../../API/builtins/string.md)><a name="named_types"></a>
@@ -349,23 +349,23 @@
 
 > Evaluates the (next iteration of the) prepared statement.
 > It will return one of the following values:
->  - `renoise.SQLite.Status.BUSY`: the engine was unable to acquire the locks needed. 
->    If the statement is a COMMIT or occurs outside of an explicit transaction, 
+>  - `renoise.SQLite.Status.BUSY`: the engine was unable to acquire the locks needed.
+>    If the statement is a COMMIT or occurs outside of an explicit transaction,
 >    then you can retry the statement. If the statement is not a COMMIT and
 >    occurs within a explicit transaction then you should rollback the transaction
 >    before continuing.
->  - `renoise.SQLite.Status.DONE`: the statement has finished executing successfully. 
+>  - `renoise.SQLite.Status.DONE`: the statement has finished executing successfully.
 >    `stmt:step()` should not be called again on this statement without first
 >    calling `stmt:reset()` to reset the virtual machine back to the initial state.
 >  - `renoise.SQLite.Status.ROW`: this is returned each time a new row of data is ready.
->    The values may be accessed using the column access functions. 
+>    The values may be accessed using the column access functions.
 >    `stmt:step()` can be called again to retrieve the next row of data.
 >  - `renoise.SQLite.Status.ERROR`: a run-time error (e.g. a constraint violation) occurred.
 >    `stmt:step()` should not be called again. More information may be found by
->    calling `db:error_message()`. A more specific error code can be obtained by calling 
+>    calling `db:error_message()`. A more specific error code can be obtained by calling
 >    `stmt:reset()`.
 >  - `renoise.SQLite.Status.MISUSE`: the function was called inappropriately.
->    Perhaps because the statement has already been finalized or a previous call to 
+>    Perhaps because the statement has already been finalized or a previous call to
 >    `stmt:step()` has returned `sqlite.ERROR` or `sqlite.DONE`.
 ### bind_parameter_count([*self*](../../API/builtins/self.md))<a name="bind_parameter_count"></a>
 `->`[`integer`](../../API/builtins/integer.md)  

docs/API/renoise/renoise.SQLite.md

@@ -120,7 +120,7 @@
 > data for your changes and update sample overview caches!
 ### prepare_sample_data_changes([*self*](../../API/builtins/self.md), undo_redo_enabled : [`boolean`](../../API/builtins/boolean.md)[`?`](../../API/builtins/nil.md))<a name="prepare_sample_data_changes"></a>
 > To be called once **before** sample data gets manipulated via `set_sample_data`.
-> This will prepare undo/redo data for the whole sample and does other internal 
+> This will prepare undo/redo data for the whole sample and does other internal
 > housekeeping. Every *prepare_sample_data_changes* call must be paired with a
 > *finalize_sample_data_changes* call.
 > 
@@ -134,7 +134,7 @@
 > This will create undo/redo data for the whole samples, and also updates the
 > sample view caches for the sample.
 > The reason this isn't automatically invoked is to avoid performance overhead when
-> changing sample data 'sample by sample'. 
+> changing sample data 'sample by sample'.
 > 
 > Don't forget to call this after any data changes, or changes may not be visible
 > in the GUI and can not be un/redone!

docs/API/renoise/renoise.SampleBuffer.md

@@ -59,8 +59,8 @@
 > **READ-ONLY** List of available filter types depending on the filter_version.
 
 ### filter_type : [`FilterTypes`](#FilterTypes)<a name="filter_type"></a>
-> The type of the filter selected for the modulation set. 
-> Songs made with previous versions of Renoise may use old filter types. 
+> The type of the filter selected for the modulation set.
+> Songs made with previous versions of Renoise may use old filter types.
 
 ### filter_type_observable : [`renoise.Document.Observable`](../../API/renoise/renoise.Document.Observable.md)<a name="filter_type_observable"></a>
 > Track changes to document properties or general states by attaching listener