Updated the header

Scripts/SHA256.ps1

@@ -1,10 +1,10 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script to Calculate SHA256 Hashes for Files
-# ------------------------------------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
+# Description:	prints the SHA256 checksum of the given file
+# Author: 	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
+# 
 param(
 [string]$File)
 

Scripts/init_git.ps1

@@ -1,7 +1,10 @@
 #!/snap/bin/powershell
 #
-
-
+# Description:	initializes Git
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
+#
 $UserName   = read-host "Your full name: "
 $UserEmail  = read-host "Your email address: "
 $UserEditor = read-host "Your favorite editor (nano, vi, emacs): "

Scripts/password.ps1

@@ -1,11 +1,10 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script to Create a New Password
-# ------------------------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
-
+# Description:	generates and prints a single new password
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
+# 
 $CharsPerPassword = 15
 $MinCharCode = 33
 $MaxCharCode = 126

Scripts/passwords.ps1

@@ -1,11 +1,10 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script to Create New Passwords
-# -----------------------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
-
+# Description:	generates and prints a list of new passwords
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
+# 
 $NumPasswords = 20
 $CharsPerPassword = 15
 $MinCharCode = 33

Scripts/poweroff.ps1

@@ -1,12 +1,9 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script to Shutdown the Local Computer
-# ------------------------------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
+# Description:	halts the local computer (administrator rights might be needed)
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
 #
-# NOTE:   Halts the local computer! Administrator rights might be needed!
-
 Stop-Computer
 exit 0

Scripts/reboot.ps1

@@ -1,12 +1,9 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script to Reboot the Local Computer
-# ----------------------------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
+# Description:	reboots the local computer (administrator rights might be needed)
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
 #
-# NOTE:   Reboots the local computer! Administrator rights might be needed.
-
 Restart-Computer
 exit 0

Scripts/speak.ps1

@@ -1,11 +1,10 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script for Text-To-Speech (TTS)
-# ------------------------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
-
+# Description:	speaks the given text
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
+# 
 $Text = "Hello World!"
 
 $voice = New-Object ComObject SAPI.SPVoice

Scripts/test.ps1

@@ -1,10 +1,9 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script for Testing
-# -----------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
-
+# Description:	simple test script
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
+# 
 write-output "PowerShell Works!"
 exit 0

Scripts/train_dns_cache.ps1

@@ -1,11 +1,10 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script to Train the DNS Cache
-# ----------------------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
-
+# Description:	trains the DNS cache with frequently used domain names
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
+# 
 $DomainTable = import-csv domain_table.csv
 
 foreach($Row in $DomainTable) {

Scripts/translate.ps1

@@ -1,11 +1,10 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script for Translating Texts
-# ---------------------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
-
+# Description:	translates the given text
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
+# 
 $SourceText = "Hello World!"
 $SourceLang = "en"
 $TargetLanguages = "af","da","de","el","es","hr","it","ja","ko","pl","pt","nl","ru","tr","uk","vi"

Scripts/txt2wav.ps1

@@ -1,11 +1,10 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script to Convert Text to Audio WAV files
-# ----------------------------------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
-
+# Description:	converts the given text into an audio .WAV file
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
+# 
 # Configuration:
 $Text = "Hello, my name ist Bond, James Bond"
 $Speed = -1 # -10 is slowest, 10 is fastest

Scripts/wakeup.ps1

@@ -1,11 +1,10 @@
 #!/snap/bin/powershell
 #
-# PowerShell Script to Wake-up Other Computers
-# --------------------------------------------
-# Author:  Markus Fleschutz
-# Source:  github.com/fleschutz/PowerShell
-# License: CC0
-
+# Description:	sends a magic packet to the given computer, waking him up
+# Author:	Markus Fleschutz
+# Source:	github.com/fleschutz/PowerShell
+# License:	CC0
+# 
 function Send-WOL 
 { 
 <#