From cefc3ceb9b3f6d7c94f604767b1f2a3c130fc625 Mon Sep 17 00:00:00 2001 From: Nate Eagleson Date: Thu, 3 Aug 2023 00:20:51 -0400 Subject: [PATCH] Improve grammar and style in manual/include/lua-scripting.html Nothing huge - just reworking a few things that struck me as rough while reading the docs. --- include/lua-scripting.html | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/include/lua-scripting.html b/include/lua-scripting.html index f3b52bd..3d63e51 100644 --- a/include/lua-scripting.html +++ b/include/lua-scripting.html @@ -10,24 +10,24 @@ This Documentation is Work in Progress and far from complete. Also the documente

Preface

-There are cases that Ardour cannot reasonably cater to with core functionality alone, either because they're session specific -or user specific edge cases. +There are cases that Ardour cannot reasonably cater to with core functionality alone, either because they're session-specific +or user-specific edge cases.

Examples for these include voice-activate (record-arm specific tracks and roll transport depending on signal levels), rename all regions after a specific timecode, launch an external application when a certain track is soloed, generate automation curves or simply provide a quick shortcut for a custom batch operation.

-Cases like this call for means to extend the DAW without actually changing the DAW itself. This is where scripting comes in. +Handling cases like these requires extending the DAW without actually changing the DAW itself. This is where scripting comes in.

-"Scripting" refers to tasks that could alternatively be executed step-by-step by a human operator. +"Scripting" refers to automating tasks that would normally be done interactively by a human operator.

Lua is a tiny and simple language which is easy to learn, yet allows for comprehensive solutions. -Lua is also a glue language it allows to tie existing component in Ardour together in unprecedented ways, -and most importantly Lua is one of the few scripting-languages which can be safely used in a real-time environment. +Lua also allows tying existing Ardour components together in unprecedented ways, +and most importantly Lua is one of the few scripting languages which can be safely used in a real-time environment.

A good introduction to Lua is the book Programming in Lua. The first edition is -available online, but if you have the means buy a copy of the book, it not only helps to support the Lua project, but provides -for a much nicer reading and learning experience. +available online for free, but if you have the means we recommend you buy a copy of the book - it helps support the Lua project and provides +a much nicer reading and learning experience.

Overview