Update Lua script descriptions, rename some scripts

25 files changed, 24 insertions, 29 deletions

diff --git a/share/scripts/HiAndLowPass.lua b/share/scripts/HiAndLowPass.lua
index 75704d9701..0438236229 100644
--- a/share/scripts/HiAndLowPass.lua
+++ b/share/scripts/HiAndLowPass.lua
@@ -4,7 +4,7 @@ ardour {
 	category    = "Filter",
 	license     = "GPLv2",
 	author      = "Ardour Team",
-	description = [[High and Low Pass Filter with de-zipped controls, written in Ardour-Lua]]
+	description = [[High and Low Pass Filter with de-zipped controls]]
 }
 
 function dsp_ioconfig ()
diff --git a/share/scripts/add_filters.lua b/share/scripts/_add_filters.lua
index 77b41c17bf..77b41c17bf 100644
--- a/share/scripts/add_filters.lua
+++ b/share/scripts/_add_filters.lua
diff --git a/share/scripts/new_playlist.lua b/share/scripts/_new_playlist.lua
index 7d86c5ba7c..ef2e808539 100644
--- a/share/scripts/new_playlist.lua
+++ b/share/scripts/_new_playlist.lua
@@ -1,13 +1,12 @@
 ardour {
 	["type"]    = "EditorAction",
-	name        = "New Playlist",
+	name        = "New Playlists",
 	license     = "MIT",
 	author      = "Ardour Lua Taskforce",
-	description = [[Prompts and builds a new playlist for every track in the session.]]
+	description = [[Prompts and builds a new playlist for every track in the session. Beware the operation cannot be cancelled.]]
 }
 
 function factory () return function ()
-
 	for r in Session:get_tracks():iter() do
 		local rtav = Editor:rtav_from_route(r) -- lookup RTAV
 		Editor:new_playlists(rtav:to_timeaxisview())
diff --git a/share/scripts/transparent_regions.lua b/share/scripts/_transparent_regions.lua
index 7db81fb7af..7db81fb7af 100644
--- a/share/scripts/transparent_regions.lua
+++ b/share/scripts/_transparent_regions.lua
diff --git a/share/scripts/a-noise.lua b/share/scripts/a-noise.lua
index dccded19c6..f3a8bade4f 100644
--- a/share/scripts/a-noise.lua
+++ b/share/scripts/a-noise.lua
@@ -4,7 +4,7 @@ ardour {
 	category    = "Utility",
 	license     = "MIT",
 	author      = "Ardour Team",
-	description = [[Noise Generator]]
+	description = [[Noise Generator featuring either white noise with uniform or gaussian distribution, or pink-noise. The signal level can be customized.]]
 }
 
 function dsp_ioconfig ()
diff --git a/share/scripts/a_slow_mute.lua b/share/scripts/a_slow_mute.lua
index a9ef12b754..8a38c482a5 100644
--- a/share/scripts/a_slow_mute.lua
+++ b/share/scripts/a_slow_mute.lua
@@ -4,7 +4,7 @@ ardour {
 	category    = "Amplifier",
 	license     = "MIT",
 	author      = "Ardour Team",
-	description = [[Mute button with slow fade in/out]]
+	description = [[Mute button with slow fade in/out (approx. 1sec exponential)]]
 }
 
 function dsp_ioconfig ()
diff --git a/share/scripts/access_action.lua b/share/scripts/access_action.lua
index b50c6386d8..71110f31d6 100644
--- a/share/scripts/access_action.lua
+++ b/share/scripts/access_action.lua
@@ -3,7 +3,7 @@ ardour {
 	name        = "Shortcut",
 	license     = "MIT",
 	author      = "me",
-	description = [[Trigger a keyboard shortcut.  You will be prompted for the shortcut's action in the next step.]]
+	description = [[Trigger a keyboard shortcut. You will be prompted for the shortcut's action in the next step.]]
 }
 
 function action_params ()
diff --git a/share/scripts/create_drum_tracks.lua b/share/scripts/create_drum_tracks.lua
index 982cf2dd07..e6fc338460 100644
--- a/share/scripts/create_drum_tracks.lua
+++ b/share/scripts/create_drum_tracks.lua
@@ -2,7 +2,7 @@ ardour {
 	["type"] = "EditorAction",

 	name = "Create Drum Tracks",

 	author = "PSmith",

-	description = [[Creates 8 new tracks with representative names and colors.]]

+	description = [[Creates eight new tracks with representative drum names and colors.]]

 }

 

 function factory () return function ()

diff --git a/share/scripts/faders_to_trims.lua b/share/scripts/faders_to_trims.lua
index 3fd62833f2..8591dc03c6 100644
--- a/share/scripts/faders_to_trims.lua
+++ b/share/scripts/faders_to_trims.lua
@@ -3,7 +3,7 @@ ardour {
 	name        = "Faders to Trims",
 	license     = "MIT",
 	author      = "PSmith",
-	description = [[Add 'Trim' plugins to all tracks.  Move the fader value into the trim.]]
+	description = [[Add 'Trim' plugins to all tracks. Move the fader value into the trim.]]
 }
 
 function action_params ()
diff --git a/share/scripts/jump_to_marker.lua b/share/scripts/jump_to_marker.lua
index ea92020c83..4e5305f6d6 100644
--- a/share/scripts/jump_to_marker.lua
+++ b/share/scripts/jump_to_marker.lua
@@ -1,7 +1,7 @@
-ardour { ["type"] = "EditorAction", name = "Jump to Marker",
+ardour { ["type"] = "EditorAction", name = "Search and Jump to Marker",
 	license     = "MIT",
 	author      = "Ardour Team",
-	description = [[Jump to the first marker matching a given pattern]]
+	description = [[Jump to the first marker that matches a given name pattern]]
 }
 
 function factory () return function ()
diff --git a/share/scripts/lfo_automation.lua b/share/scripts/lfo_automation.lua
index 3f9fa0263e..3cd4e4cb2b 100644
--- a/share/scripts/lfo_automation.lua
+++ b/share/scripts/lfo_automation.lua
@@ -4,7 +4,7 @@ ardour {
    version     = "0.1.1",
    license     = "MIT",
    author      = "Daniel Appelt",
-   description = [[Add LFO-like plugin automation to selected region]]
+   description = [[Add LFO-like plugin automation to any automatable parameter below a selected region]]
 }
 
 function factory (unused_params)
diff --git a/share/scripts/ltc_reader.lua b/share/scripts/ltc_reader.lua
index b86dc009ef..6df646c0e1 100644
--- a/share/scripts/ltc_reader.lua
+++ b/share/scripts/ltc_reader.lua
@@ -4,7 +4,7 @@ ardour {
 	category    = "Utility",
 	author      = "Ardour Team",
 	license     = "MIT",
-	description = [[Linear Timecode Decoder with mixer strip inline display]]
+	description = [[Linear Timecode (LTC) Decoder with mixer strip inline display]]
 }
 
 function dsp_ioconfig ()
diff --git a/share/scripts/meter_tap.lua b/share/scripts/metering_point.lua
index 645af522bd..3a229a640b 100644
--- a/share/scripts/meter_tap.lua
+++ b/share/scripts/metering_point.lua
@@ -1,8 +1,8 @@
 ardour {
     ["type"] = "EditorAction",
-    name = "Meter Tap",
+    name = "Meter Point",
     author = "Ardour Lua Taskforce",
-    description = [[Change Metering  Point for tracks in your session.]]
+    description = [[Batch change metering point for selected or tracks in the given session.]]
 }
 
 function factory () return function ()
diff --git a/share/scripts/midi_remap.lua b/share/scripts/midi_remap.lua
index 4fb7919e23..2da985caf2 100644
--- a/share/scripts/midi_remap.lua
+++ b/share/scripts/midi_remap.lua
@@ -4,7 +4,7 @@ ardour {
     category    = "Utility",
     license     = "MIT",
     author      = "Alby Musaelian",
-    description = [[Map arbitrary MIDI notes to others. Affects Note On/Off and polyphonic key pressure. Note that if a single note is mapped multiple times, the last mapping wins -- MIDI events are never duplicated.]]
+    description = [[Map arbitrary MIDI notes to others. Affects Note On/Off and polyphonic key pressure. Note that if a single note is mapped multiple times, the last mapping wins (MIDI events are never duplicated).]]
 }
 
 -- The number of remapping pairs to allow. Increasing this (at least in theory)
diff --git a/share/scripts/mixer_settings_recall.lua b/share/scripts/mixer_settings_recall.lua
index 27a2e56e05..25147979dc 100644
--- a/share/scripts/mixer_settings_recall.lua
+++ b/share/scripts/mixer_settings_recall.lua
@@ -3,13 +3,11 @@ ardour {
 	name        = "Recall Mixer Settings",
 	author      = "Mixbus Team",
 	description = [[
-
 	Recalls mixer settings outined by files
 	created by Store Mixer Settings.
 
 	Allows for some room to change Source
 	and Destination.
-
 	]]
 }
 
diff --git a/share/scripts/mixer_settings_store.lua b/share/scripts/mixer_settings_store.lua
index 3c6ecbaef7..2603d2857e 100644
--- a/share/scripts/mixer_settings_store.lua
+++ b/share/scripts/mixer_settings_store.lua
@@ -3,7 +3,6 @@ ardour {
 	name        = "Store Mixer Settings",
 	author      = "Mixbus Team",
 	description = [[
-
 	Stores the current Mixer state as a file
 	that can be read and recalled arbitrarily
 	by it's companion script, Recall Mixer Settings.
@@ -11,7 +10,6 @@ ardour {
 	Supports: processor settings, grouping,
 	mute, solo, gain, trim, pan and processor ordering,
 	plus re-adding certain deleted plugins.
-
 	]]
 }
 
diff --git a/share/scripts/mute_all_tracks.lua b/share/scripts/mute_all_tracks.lua
index e15c0530c0..f9e0b4b9d0 100644
--- a/share/scripts/mute_all_tracks.lua
+++ b/share/scripts/mute_all_tracks.lua
@@ -3,7 +3,7 @@ ardour {
 	name        = "Mute All Tracks",
 	license     = "MIT",
 	author      = "Ardour Team",
-	description = [[Mute All Tracks in the Session]]
+	description = [[Mute all tracks in the session]]
 }
 
 function factory () return function ()
diff --git a/share/scripts/periodic_backup.lua b/share/scripts/periodic_backup.lua
index ff274a7a08..0142f41c6d 100644
--- a/share/scripts/periodic_backup.lua
+++ b/share/scripts/periodic_backup.lua
@@ -2,7 +2,7 @@ ardour {
 	["type"]    = "EditorHook",
 	name        = "Periodically Save Snapshot",
 	author      = "Ardour Lua Task Force",
-	description = "Save a session-snapshot peridocally (every 15mins) named after the current date-time",
+	description = "Save a session-snapshot periodically (every 15mins) named after the current date-time",
 }
 
 -- subscribe to signals
diff --git a/share/scripts/reset_mixer.lua b/share/scripts/reset_mixer.lua
index 6feabdf268..8c18865a89 100644
--- a/share/scripts/reset_mixer.lua
+++ b/share/scripts/reset_mixer.lua
@@ -3,7 +3,7 @@ ardour {
 	name        = "Reset Mixer",

 	license     = "MIT",

 	author      = "Ben Loftis, Nikolaus Gullotta, Maxime Lecoq",

-	description = [[Resets key Mixer settings after user-prompt (warning: this cannot be undone)]]

+	description = [[Resets key mixer settings after user-prompt (warning: this cannot be undone)]]

 }

 

 function factory() return function()

diff --git a/share/scripts/_rubberband_swing.lua b/share/scripts/rubberband_swing.lua
index 52ce2c1bcc..52ce2c1bcc 100644
--- a/share/scripts/_rubberband_swing.lua
+++ b/share/scripts/rubberband_swing.lua
diff --git a/share/scripts/select_every_2nd_region.lua b/share/scripts/select_every_2nd_region.lua
index 30ad519483..792d7a74c4 100644
--- a/share/scripts/select_every_2nd_region.lua
+++ b/share/scripts/select_every_2nd_region.lua
@@ -3,7 +3,7 @@ ardour {
 	name        = "Region Select/2",
 	license     = "MIT",
 	author      = "Ardour Team",
-	description = [[select every 2nd region on all selected tracks]]
+	description = [[Select every 2nd region on all selected tracks]]
 }
 
 -- select every 2nd region on all selected tracks
diff --git a/share/scripts/session_template_advanced.lua b/share/scripts/session_template_advanced.lua
index 1eec0349ce..08de50133b 100644
--- a/share/scripts/session_template_advanced.lua
+++ b/share/scripts/session_template_advanced.lua
@@ -1,7 +1,7 @@
 ardour {
 	["type"]    = "SessionInit",
 	name        = "Advanced Session",
-	description = [[Allows to configure master-bus and autoconnect]],
+	description = [[Allow to configure master-bus and autoconnect settings]],
 	master_bus  = 0
 }
 
diff --git a/share/scripts/singen.lua b/share/scripts/singen.lua
index 8b22c1257b..623f9379e8 100644
--- a/share/scripts/singen.lua
+++ b/share/scripts/singen.lua
@@ -4,7 +4,7 @@ ardour {
 	category    = "Instrument",
 	license     = "MIT",
 	author      = "Ardour Team",
-	description = [[Sine Wave Generator (v1.2)]]
+	description = [[Simple sine wave generator with gain and frequency controls]]
 }
 
 local lpf = 0
@@ -91,4 +91,4 @@ function render_inline (ctx, w, max_h) --inline display
 		p = p + inc
 	end
 	return {w, h + 6}
-end
\ No newline at end of file
+end
diff --git a/share/scripts/stop_at_marker.lua b/share/scripts/stop_at_marker.lua
index 35de3510c4..0d5da48b91 100644
--- a/share/scripts/stop_at_marker.lua
+++ b/share/scripts/stop_at_marker.lua
@@ -3,7 +3,7 @@ ardour {
 	name        = "Stop at Marker",
 	license     = "MIT",
 	author      = "Ardour Lua Task Force",
-	description = [[An example session script which stops the transport on every location marker when rolling forward.]]
+	description = [[Stop the transport on every location marker when rolling forward.]]
 }
 
 function factory ()
diff --git a/share/scripts/synth1.lua b/share/scripts/synth1.lua
index de68c58e46..3b765d87c4 100644
--- a/share/scripts/synth1.lua
+++ b/share/scripts/synth1.lua
@@ -4,7 +4,7 @@ ardour {
 	category    = "Instrument",
 	license     = "MIT",
 	author      = "Ardour Lua Task Force",
-	description = [[An Example Synth for Prototyping.]]
+	description = [[An Example synth for prototyping: Sine-wave with a basic attack/sustain/release envelope, variable number of output channels.]]
 }
 
 function dsp_ioconfig ()