diff --git a/install.pl b/install.pl
index 7e84dda..c5fe49b 100644
--- a/install.pl
+++ b/install.pl
@@ -1,6 +1,7 @@
 #!/usr/bin/env perl
 
-# Script: install.pl
+# Script:      install.pl
+# Lang:        perl
 # Description: This script installs my personal scripts from the git repo
 #              found at $repo_url
 
diff --git a/scripts/ds b/scripts/ds
index 5974432..33b1299 100755
--- a/scripts/ds
+++ b/scripts/ds
@@ -1,7 +1,10 @@
-#!/usr/bin/perl
+#!/usr/bin/env perl
 
+# Script:      ds
+# Lang:        perl
+# Description: calculates and displays the size of a given directory in a human
+#              readable format
 
-# ds - calculate and display the size of a given directory in a human readable format
 # Copyright Frederick Boniface 2023 - fredboniface.co.uk
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
diff --git a/scripts/regain b/scripts/regain
index 811d92b..3b39037 100755
--- a/scripts/regain
+++ b/scripts/regain
@@ -1,7 +1,12 @@
 #!/usr/bin/env python3
 
+# Script:      regain
+# Lang:        python 3
+# Description: Search folders below working directory and call regainer on each
+#              album found
 
-# regain - search folders below working directory and call regainer on each album found
+# NOTE: The below license applies only to this file, not any other files
+#       from the same source.
 # Copyright Frederick Boniface 2023 - fredboniface.co.uk
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy