Update synopsis and description

Scripts/add-firewall-rules.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	add-firewall-rules.ps1 [<PathToExecutables>]
-.DESCRIPTION
 	Adds firewall rules for the given executables (needs admin rights)
+.DESCRIPTION
+	add-firewall-rules.ps1 [<PathToExecutables>]
 .EXAMPLE
 	PS> ./add-firewall-rules C:\MyApp\bin
 	Adding firewall rule for C:\MyApp\bin\app1.exe

Scripts/add-memo.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	add-memo.ps1 [<text>]
+	Adds a memo to Memos.csv in the home folder
 .DESCRIPTION
-	Adds the given memo text to $HOME/Memos.csv
+	add-memo.ps1 [<text>]
 .EXAMPLE
 	PS> ./add-memo "Buy apples"
 	✔️ added to 📄/home/markus/Memos.csv

Scripts/alert.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	alert.ps1 [<message>]
-.DESCRIPTION
 	Handle and escalate the given alert message
+.DESCRIPTION
+	alert.ps1 [<message>]
 .EXAMPLE
 	PS> ./alert "Harddisk failure"
 .LINK

Scripts/cd-desktop.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-desktop.ps1 
-.DESCRIPTION
 	Change the working directory to the user's desktop folder
+.DESCRIPTION
+	cd-desktop.ps1 
 .EXAMPLE
 	PS> ./cd-desktop
 	📂/home/markus/Desktop

Scripts/cd-docs.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-docs.ps1 
-.DESCRIPTION
 	Change the working directory to the user's documents folder
+.DESCRIPTION
+	cd-docs.ps1 
 .EXAMPLE
 	PS> ./cd-docs
 	📂/home/markus/Documents

Scripts/cd-downloads.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-downloads.ps1 
-.DESCRIPTION
 	Change the working directory to the user's downloads folder
+.DESCRIPTION
+	cd-downloads.ps1 
 .EXAMPLE
 	PS> ./cd-downloads
 	📂/home/markus/Downloads

Scripts/cd-dropbox.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-dropbox.ps1 
-.DESCRIPTION
 	Change the working directory to the user's Dropbox folder
+.DESCRIPTION
+	cd-dropbox.ps1 
 .EXAMPLE
 	PS> ./cd-dropbox
 	📂/home/markus/Dropbox

Scripts/cd-home.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-home.ps1 
-.DESCRIPTION
 	Change the working directory to the user's home directory
+.DESCRIPTION
+	cd-home.ps1 
 .EXAMPLE
 	PS> ./cd-home
 	📂/home/markus

Scripts/cd-music.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-music.ps1 
-.DESCRIPTION
 	Change the working directory to the user's music folder
+.DESCRIPTION
+	cd-music.ps1 
 .EXAMPLE
 	PS> ./cd-music
 	📂/home/markus/Music

Scripts/cd-onedrive.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-onedrive.ps1 
-.DESCRIPTION
 	Change the working directory to the user's OneDrive folder
+.DESCRIPTION
+	cd-onedrive.ps1 
 .EXAMPLE
 	PS> ./cd-onedrive
 	📂/home/markus/OneDrive

Scripts/cd-pics.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-pics.ps1 
-.DESCRIPTION
 	Change the working directory to the user's pictures folder
+.DESCRIPTION
+	cd-pics.ps1 
 .EXAMPLE
 	PS> ./cd-pics
 	📂/home/markus/Pictures

Scripts/cd-recycle-bin.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-recycle-bin.ps1 
-.DESCRIPTION
 	Change the working directory to the user's recycle bin folder
+.DESCRIPTION
+	cd-recycle-bin.ps1 
 .EXAMPLE
 	PS> ./cd-recycle-bin
 	📂C:\$Recycle.Bin\S-1-5-21-123404-23309-294260-1001

Scripts/cd-repos.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-repos.ps1 
-.DESCRIPTION
 	Change the working directory to the user's Git repositories folder
+.DESCRIPTION
+	cd-repos.ps1 
 .EXAMPLE
 	PS> ./cd-repos
 	📂/home/markus/Repos

Scripts/cd-root.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-root.ps1 
-.DESCRIPTION
 	Change the working directory to the root directory (C:\ on Windows)
+.DESCRIPTION
+	cd-root.ps1 
 .EXAMPLE
 	PS> ./cd-root
 	📂C:\

Scripts/cd-scripts.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-scripts.ps1 
-.DESCRIPTION
 	Change the working directory to the PowerShell scripts folder
+.DESCRIPTION
+	cd-scripts.ps1 
 .EXAMPLE
 	PS> ./cd-scripts
 	📂/home/markus/PowerShell/Scripts

Scripts/cd-ssh.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-ssh.ps1 
-.DESCRIPTION
 	Change the working directory to the user's SSH folder
+.DESCRIPTION
+	cd-ssh.ps1 
 .EXAMPLE
 	PS> ./cd-ssh
 	📂/home/markus/.ssh

Scripts/cd-up.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-up.ps1
-.DESCRIPTION
 	Change the working directory to one level up
+.DESCRIPTION
+	cd-up.ps1
 .EXAMPLE
 	PS> .\cd-up
 	(one level up)

Scripts/cd-up2.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-up2.ps1
-.DESCRIPTION
 	Change the working directory to two directory levels up
+.DESCRIPTION
+	cd-up2.ps1
 .EXAMPLE
 	PS> ./cd-up2
 	(two levels up)

Scripts/cd-up3.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-up3.ps1
-.DESCRIPTION
 	Change the working directory to three directory levels up
+.DESCRIPTION
+	cd-up3.ps1
 .EXAMPLE
 	PS> ./cd-up3
 	(three levels up)

Scripts/cd-up4.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-up4.ps1
-.DESCRIPTION
 	Change the working directory to four directory levels up
+.DESCRIPTION
+	cd-up4.ps1
 .EXAMPLE
 	PS> ./cd-up4
 	(four levels up)

Scripts/cd-videos.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	cd-videos.ps1 
-.DESCRIPTION
 	Change the working directory to the user's videos folder
+.DESCRIPTION
+	cd-videos.ps1 
 .EXAMPLE
 	PS> ./cd-videos
 	📂/home/markus/Videos

Scripts/check-cpu-temp.ps1

@@ -1,10 +1,11 @@
 <#
 .SYNOPSIS
-	check-cpu-temp.ps1 
-.DESCRIPTION
 	Checks the CPU temperature
+.DESCRIPTION
+	check-cpu-temp.ps1 
 .EXAMPLE
 	PS> ./check-cpu-temp
+	✔️ 30.3 °C CPU temperature - good
 .LINK
 	https://github.com/fleschutz/PowerShell
 .NOTES

Scripts/check-dns-resolution.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-dns-resolution.ps1
-.DESCRIPTION
 	Checks the DNS resolution with frequently used domain names
+.DESCRIPTION
+	check-dns-resolution.ps1
 .EXAMPLE
 	PS> ./check-dns-resolution
 	✔️ 11.8 domains/sec (177 domains resolved in 15 sec)

Scripts/check-drive-space.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-drive-space.ps1 [<drive>] [<min-level>]
-.DESCRIPTION
 	Checks a drive for free space left (20 GB by default)
+.DESCRIPTION
+	check-drive-space.ps1 [<drive>] [<min-level>]
 .EXAMPLE
 	PS> ./check-drive-space C
 	✔️ 172 GB left on drive C (61 of 233 GB used)

Scripts/check-file-system.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-file-system.ps1 [<drive>] 
-.DESCRIPTION
 	Checks the file system of a drive (needs admin rights)
+.DESCRIPTION
+	check-file-system.ps1 [<drive>] 
 .EXAMPLE
 	PS> ./check-file-system C
 	✔️ file system on drive C is clean

Scripts/check-health.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-health.ps1 
-.DESCRIPTION
 	Checks the health of the local computer
+.DESCRIPTION
+	check-health.ps1 
 .EXAMPLE
 	PS> ./check-health
 	✔️ 1213 GB left for swap space (67 of 1280 GB used)

Scripts/check-ipv4-address.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-ipv4-address.ps1 [<Address>]
-.DESCRIPTION
 	Checks the given IPv4 address for validity
+.DESCRIPTION
+	check-ipv4-address.ps1 [<Address>]
 .EXAMPLE
 	PS> ./check-ipv4-address 192.168.11.22
 	✔️ IPv4 192.168.11.22 is valid

Scripts/check-ipv6-address.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-ipv6-address.ps1 [<Address>]
-.DESCRIPTION
 	Checks the given IPv6 address for validity
+.DESCRIPTION
+	check-ipv6-address.ps1 [<Address>]
 .EXAMPLE
 	PS> ./check-ipv6-address fe80::200:5aee:feaa:20a2
 	✔️ IPv6 fe80::200:5aee:feaa:20a2 is valid

Scripts/check-mac-address.ps1

@@ -1,8 +1,9 @@
 <#
 .SYNOPSIS
-	check-mac-address.ps1 [<MAC>]
+	Checks the given MAC address for validity
 .DESCRIPTION
-	Checks the given MAC address for validity (MAC address like 00:00:00:00:00:00 or 00-00-00-00-00-00 or 000000000000).
+	Supported MAC address formats are: 00:00:00:00:00:00 or 00-00-00-00-00-00 or 000000000000.
+	check-mac-address.ps1 [<MAC>]
 .EXAMPLE
 	PS> ./check-mac-address 11:22:33:44:55:66
 	✔️ MAC address 11:22:33:44:55:66 is valid

Scripts/check-ping.ps1

@@ -1,9 +1,9 @@
 <#
 .SYNOPSIS
-	check-ping.ps1 [<hosts>]
-.DESCRIPTION
 	Checks the ping latency from the local computer to selected Internet hosts
-	(default is: 'amazon.com,apple.com,bing.com,cnn.com,dropbox.com,facebook.com,google.com,live.com,twitter.com,youtube.com)
+.DESCRIPTION
+	Hosts by default are: amazon.com,apple.com,bing.com,cnn.com,dropbox.com,facebook.com,google.com,live.com,twitter.com,youtube.com
+	check-ping.ps1 [<hosts>]
 .EXAMPLE
 	PS> ./check-ping
 	✔️ 36 ms ping average (13 ms min, 109 ms max, 10 hosts)

Scripts/check-smart-devices.ps1

@@ -1,9 +1,10 @@
 <#
 .SYNOPSIS
-	check-smart-devices.ps1 [<type>]
+	Performs a selftest on your S.M.A.R.T. HDD/SSD devices.
 .DESCRIPTION
-	Performs a selftest on your S.M.A.R.T. HDD/SSD devices. Type is either short(default) or long.
+	check-smart-devices.ps1 [<type>]
-        Requires smartctl (smartmontools) and admin rights.
+	Type is either short(default) or long.
+        Requires smartctl (smartmontools package) and admin rights.
 .EXAMPLE
 	PS> ./check-smart-devices
 	✔️ short selftest started on S.M.A.R.T. device /dev/sda

Scripts/check-subnet-mask.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-subnet-mask.ps1 [<address>]
-.DESCRIPTION
 	Checks the given subnet mask for validity
+.DESCRIPTION
+	check-subnet-mask.ps1 [<address>]
 .EXAMPLE
 	PS> ./check-subnet-mask 255.255.255.0
 	✔️ subnet mask 255.255.255.0 is valid

Scripts/check-swap-space.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-swap-space.ps1 [<min-level>]
-.DESCRIPTION
 	Checks the free swap space
+.DESCRIPTION
+	check-swap-space.ps1 [<min-level>]
 .EXAMPLE
 	PS> ./check-swap-space
 	✔️ 1213 GB left for swap space (67 of 1280 GB used)

Scripts/check-symlinks.ps1

@@ -1,8 +1,9 @@
 <#
 .SYNOPSIS
-	check-symlinks.ps1 [<DirTree>]
+	Checks every symlink in a folder (including subfolders)
 .DESCRIPTION
-	Checks every symlink in a directory tree.
+	check-symlinks.ps1 [<folder>]
+	Returns the number of broken symlinks as exit value.
 .EXAMPLE
 	PS> ./check-symlinks .
 	✔️ 0 out of 10 symlinks are broken in 📂/home/markus
@@ -12,12 +13,12 @@
 	Author: Markus Fleschutz · License: CC0
 #>
 
-param([string]$DirTree = "")
+param([string]$folder = "")
 
 try {
-	if ($DirTree -eq "" ) { $DirTree = read-host "Enter the path to the directory tree" }
+	if ($folder -eq "" ) { $folder = read-host "Enter the path to the folder" }
 
-	$FullPath = Resolve-Path "$DirTree"
+	$FullPath = Resolve-Path "$folder"
 	write-progress "Checking every symlink in 📂$FullPath..."
 	[int]$NumTotal = [int]$NumBroken = 0
 	Get-ChildItem $FullPath -recurse  | Where { $_.Attributes -match "ReparsePoint" } | ForEach-Object {

Scripts/check-weather.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-weather.ps1 [<location>]
-.DESCRIPTION
 	Checks the weather for critical values
+.DESCRIPTION
+	check-weather.ps1 [<location>]
 .EXAMPLE
 	PS> ./check-weather
 .LINK

Scripts/check-windows-system-files.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-windows-system-files.ps1 
-.DESCRIPTION
 	Checks the validity of the Windows system files (requires admin rights)
+.DESCRIPTION
+	check-windows-system-files.ps1 
 .EXAMPLE
 	PS> ./check-windows-system-files
 	✔️ checked Windows system files

Scripts/check-xml-file.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	check-xml-file [<file>]
-.DESCRIPTION
 	Checks the given XML file for validity
+.DESCRIPTION
+	check-xml-file [<file>]
 .EXAMPLE
 	PS> ./check-xml-file myfile.xml
 	✔️ XML file is valid

Scripts/cherry-picker.ps1

@@ -1,7 +1,8 @@
 <#
 .SYNOPSIS
-	cherry-picker.ps1 [<CommitID>] [<CommitMessage>] [<Branches>] [<RepoDir>]
+	Cherry-picks a Git commit into one or more branches
 .DESCRIPTION
+	cherry-picker.ps1 [<CommitID>] [<CommitMessage>] [<Branches>] [<RepoDir>]
 	Cherry-picks a Git commit into one or more branches (branch names need to be separated by spaces)
 	NOTE: in case of merge conflicts the script stops immediately! 
 .EXAMPLE

Scripts/clean-repo.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	clean-repo.ps1 [<RepoDir>]
+	Cleans a Git repository from untracked files (including submodules)
 .DESCRIPTION
-	Cleans a Git repository from untracked files (including submodules, e.g. for a fresh build)
+	clean-repo.ps1 [<RepoDir>]
 .EXAMPLE
 	PS> ./clean-repo C:\MyRepo
 	🧹 Cleaning Git repository 📂C:\MyRepo from untracked files...

Scripts/clean-repos.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	clean-repos.ps1 [<ParentDir>]
+	Cleans all Git repositories in a folder from untracked files (including submodules)
 .DESCRIPTION
-	Cleans all Git repositories under the current/given directory from untracked files (including submodules)
+	clean-repos.ps1 [<ParentDir>]
 .EXAMPLE
 	PS> ./clean-repos C:\MyRepos
 .NOTES

Scripts/clear-recycle-bin.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	clear-recycle-bin.ps1 
+	Removes the content of the recycle bin folder permanently
 .DESCRIPTION
-	Removes the content of the recycle bin folder
+	clear-recycle-bin.ps1 
 	NOTE: can not be undo!
 .EXAMPLE
 	PS> ./clear-recycle-bin

Scripts/clone-repos.ps1

@@ -1,22 +1,22 @@
 <#
 .SYNOPSIS
-	clone-repos.ps1 [<ParentDir>]
+	Clones well-known Git repositories into a folder
 .DESCRIPTION
-	Clones well-known Git repositories under the current/given directory
+	clone-repos.ps1 [<folder>]
 .EXAMPLE
-	PS> ./clone-repos C:\MyRepos
+	PS> ./clone-repos C:\Users\Markus\Repos
 .NOTES
 	Author: Markus Fleschutz · License: CC0
 .LINK
 	https://github.com/fleschutz/PowerShell
 #>
 
-param([string]$ParentDir = "$PWD")
+param([string]$folder = "$PWD")
 
 try {
 	$StopWatch = [system.diagnostics.stopwatch]::startNew()
 
-	if (-not(test-path "$ParentDir" -pathType container)) { throw "Can't access directory: $ParentDir" }
+	if (-not(test-path "$folder" -pathType container)) { throw "Can't access directory: $folder" }
 
 	$Null = (git --version)
 	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
@@ -32,22 +32,22 @@ try {
 		[string]$Shallow = $Row.Shallow
 		[string]$URL = $Row.URL
 
-		if (test-path "$ParentDir/$FolderName" -pathType container) {
+		if (test-path "$folder/$FolderName" -pathType container) {
 			"📂$FolderName exists, skipping..."
 			continue
 		}
 		if ($Shallow -eq "yes") {
 			"🢃 Cloning to 📂$FolderName, $Branch branch, shallow..."
-			& git clone --branch "$Branch" --depth 1 --shallow-submodules --recurse-submodules "$URL" "$ParentDir/$FolderName"
+			& git clone --branch "$Branch" --depth 1 --shallow-submodules --recurse-submodules "$URL" "$folder/$FolderName"
 		} else {
 			"🢃 Cloning to 📂$FolderName, $Branch branch, full history..."
-			& git clone --branch "$Branch" --recurse-submodules "$URL" "$ParentDir/$FolderName"
+			& git clone --branch "$Branch" --recurse-submodules "$URL" "$folder/$FolderName"
 		}
 		if ($lastExitCode -ne "0") { throw "'git clone $URL' failed" }
 		$Count++
 	}
 	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ cloned $Count Git repositories at 📂$ParentDir in $Elapsed sec"
+	"✔️ cloned $Count Git repositories into 📂$folder in $Elapsed sec"
 	exit 0 # success
 } catch {
 	"⚠️ Error: $($Error[0]) ($($MyInvocation.MyCommand.Name):$($_.InvocationInfo.ScriptLineNumber))"

Scripts/close-calculator.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-calculator.ps1 
-.DESCRIPTION
 	Closes the calculator program gracefully
+.DESCRIPTION
+	close-calculator.ps1 
 .EXAMPLE
 	PS> ./close-calculator
 .NOTES

Scripts/close-chrome.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-chrome.ps1 
-.DESCRIPTION
 	Closes the Google Chrome Web browser
+.DESCRIPTION
+	close-chrome.ps1 
 .EXAMPLE
 	PS> ./close-chrome
 .NOTES

Scripts/close-cortana.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-cortana.ps1
+	Closes Microsoft's Cortana application
 .DESCRIPTION
-	Closes Cortana gracefully
+	close-cortana.ps1
 .EXAMPLE
 	PS> ./close-cortana
 .NOTES

Scripts/close-edge.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-edge.ps1 
+	Closes Microsoft's Edge Web browser
 .DESCRIPTION
-	Closes the Microsoft Edge Web browser
+	close-edge.ps1 
 .EXAMPLE
 	PS> ./close-edge
 .NOTES

Scripts/close-file-explorer.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-file-explorer.ps1 
+	Closes Microsoft's File Explorer 
 .DESCRIPTION
-	Closes Microsoft File Explorer gracefully
+	close-file-explorer.ps1 
 .EXAMPLE
 	PS> ./close-file-explorer
 .NOTES

Scripts/close-firefox.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-firefox.ps1 
+	Closes Mozilla's Firefox Web browser 
 .DESCRIPTION
-	Closes the Firefox Web browser 
+	close-firefox.ps1 
 .EXAMPLE
 	PS> ./close-firefox
 .NOTES

Scripts/close-netflix.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-netflix.ps1 
+	Closes the Netflix application 
 .DESCRIPTION
-	Closes the Netflix application gracefully
+	close-netflix.ps1 
 .EXAMPLE
 	PS> ./close-netflix
 .NOTES

Scripts/close-onedrive.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-onedrive.ps1 
+	Closes Microsoft's OneDrive folder
 .DESCRIPTION
-	Closes Microsoft OneDrive gracefully
+	close-onedrive.ps1 
 .EXAMPLE
 	PS> ./close-onedrive
 .NOTES

Scripts/close-program.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-program.ps1 [<FullProgramName>] [<ProgramName>] [<ProgramAliasName>]
-.DESCRIPTION
 	Closes the processes of the given program gracefully
+.DESCRIPTION
+	close-program.ps1 [<FullProgramName>] [<ProgramName>] [<ProgramAliasName>]
 .EXAMPLE
 	PS> ./close-program "Google Chrome" "chrome.exe"
 .NOTES

Scripts/close-system-settings.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-system-settings.ps1 
+	Closes the System Settings window
 .DESCRIPTION
-	Closes the System Settings gracefully
+	close-system-settings.ps1 
 .EXAMPLE
 	PS> ./close-system-settings
 .NOTES

Scripts/close-thunderbird.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-thunderbird.ps1 
+	Closes Mozilla's Thunderbird email client
 .DESCRIPTION
-	Closes the mail client Mozilla Thunderbird gracefully
+	close-thunderbird.ps1 
 .EXAMPLE
 	PS> ./close-thunderbird
 .NOTES

Scripts/close-vlc.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-vlc.ps1 
-.DESCRIPTION
 	Closes the VLC media player application
+.DESCRIPTION
+	close-vlc.ps1 
 .EXAMPLE
 	PS> ./close-vlc
 .NOTES

Scripts/close-windows-terminal.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	close-windows-terminal.ps1 
-.DESCRIPTION
 	Closes the Windows Terminal application
+.DESCRIPTION
+	close-windows-terminal.ps1 
 .EXAMPLE
 	PS> ./close-windows-terminal
 .NOTES

Scripts/configure-git.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	configure-git.ps1 [<full-name>] [<email-address>] [<favorite-editor>]
+	Configures the user settings for Git 
 .DESCRIPTION
-	Sets up the Git user configuration
+	configure-git.ps1 [<full-name>] [<email-address>] [<favorite-editor>]
 .EXAMPLE
 	PS> ./configure-git
 .NOTES

Scripts/convert-csv2txt.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	convert-csv2txt.ps1 [<csv-file>]
-.DESCRIPTION
 	Converts a .CSV file into a text file
+.DESCRIPTION
+	convert-csv2txt.ps1 [<csv-file>]
 .EXAMPLE
 	PS> ./convert-csv2txt salaries.csv
 .NOTES

Scripts/convert-mysql2csv.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	convert-mysql2csv.ps1 [<server>] [<database>] [<username>] [<password>] [<query>]
-.DESCRIPTION
 	Convert a MySQL database table to a .CSV file
+.DESCRIPTION
+	convert-mysql2csv.ps1 [<server>] [<database>] [<username>] [<password>] [<query>]
 .EXAMPLE
 	PS> ./convert-mysql2csv
 .NOTES

Scripts/convert-ps2bat.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	convert-ps2bat.ps1 [<pattern>]
-.DESCRIPTION
 	Converts a PowerShell script to .bat files
+.DESCRIPTION
+	convert-ps2bat.ps1 [<pattern>]
 .EXAMPLE
 	PS> ./convert-ps2bat *.ps1
 .NOTES

Scripts/convert-ps2md.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	convert-ps2md.ps1 [<filename>]
-.DESCRIPTION
 	Converts the comment-based help of a PowerShell script to Markdown
+.DESCRIPTION
+	convert-ps2md.ps1 [<filename>]
 .EXAMPLE
 	PS> ./convert-ps2md myscript.ps1
 .NOTES

Scripts/convert-sql2csv.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	convert-sql2csv.ps1 [<server>] [<database>] [<username>] [<password>] [<query>]
-.DESCRIPTION
 	Converts a SQL database table to a .CSV file
+.DESCRIPTION
+	convert-sql2csv.ps1 [<server>] [<database>] [<username>] [<password>] [<query>]
 .EXAMPLE
 	PS> ./convert-sql2csv
 .NOTES

Scripts/convert-txt2wav.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	convert-txt2wav.ps1 [<text>] [<wav-file>]
-.DESCRIPTION
 	Converts text to a .WAV audio file
+.DESCRIPTION
+	convert-txt2wav.ps1 [<text>] [<wav-file>]
 .EXAMPLE
 	PS> ./convert-txt2wav "Hello World" spoken.wav
 .NOTES

Scripts/copy-photos-sorted.ps1

@@ -1,8 +1,9 @@
 <#
 .SYNOPSIS
-	copy-photos-sorted.ps1 [<SourceDir>] [<TargetDir>]
+	Copy image files sorted by year and month
 .DESCRIPTION
 	Copy image files from SourceDir to TargetDir sorted by year and month
+	copy-photos-sorted.ps1 [<SourceDir>] [<TargetDir>]
 .EXAMPLE
 	PS> ./copy-photos-sorted D:\Mobile\DCIM C:\MyPhotoAlbum
 .NOTES

Scripts/decrypt-file.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	decrypt-file.ps1 [<path>] [<password>]
-.DESCRIPTION
 	Decrypts the given file
+.DESCRIPTION
+	decrypt-file.ps1 [<path>] [<password>]
 .EXAMPLE
 	PS> ./decrypt-file-rules C:\MyFile.txt "123"
 .NOTES

Scripts/display-time.ps1

@@ -1,8 +1,9 @@
 <#
 .SYNOPSIS
-	display-time.ps1 [<seconds>]
+	Displays the current time
 .DESCRIPTION
 	Displays the current time (for 10 seconds by default)
+	display-time.ps1 [<seconds>]
 .EXAMPLE
 	PS> ./display-time
 .NOTES

Scripts/download-dir.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	download-dir.ps1 [<URL>]
+	Downloads a folder (including subfolders) from the given URL
 .DESCRIPTION
-	Downloads a directory tree from the given URL
+	download-dir.ps1 [<URL>]
 .EXAMPLE
 	PS> ./download-dir "https://www.cnn.com"
 .NOTES

Scripts/download-file.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	download-file.ps1 [<URL>]
-.DESCRIPTION
 	Downloads a file from the given URL
+.DESCRIPTION
+	download-file.ps1 [<URL>]
 .EXAMPLE
 	PS> ./download-file "https://www.cnn.com/index.html"
 .NOTES

Scripts/edit.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	edit.ps1 <filename>
-.DESCRIPTION
 	Opens the built-in text editor to edit the given file
+.DESCRIPTION
+	edit.ps1 <filename>
 .EXAMPLE
 	PS> ./edit C:\MyFile.txt
 .NOTES

Scripts/enable-crash-dumps.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	enable-crash-dumps.ps1 
-.DESCRIPTION
 	Enables the writing of crash dumps
+.DESCRIPTION
+	enable-crash-dumps.ps1 
 .EXAMPLE
 	PS> ./enable-crash-dumps
 .NOTES

Scripts/enable-god-mode.ps1

@@ -1,8 +1,9 @@
 <#
 .SYNOPSIS
-	enable-god-mode.ps1 
+	Enables the god mode
 .DESCRIPTION
 	Enables the god mode (adds a new icon to the desktop)
+	enable-god-mode.ps1 
 .EXAMPLE
 	PS> ./enable-god-mode
 .NOTES

Scripts/encrypt-file.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	encrypt-file.ps1 [<path>] [<password>]
+	Encrypts a file
 .DESCRIPTION
-	Encrypts the given file
+	encrypt-file.ps1 [<Path>] [<Password>]
 .EXAMPLE
 	PS> ./encrypt-file C:\MyFile.txt "123"
 .NOTES

Scripts/enter-chat.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	enter-chat.ps1 
-.DESCRIPTION
 	Enters a chat using a common network shared file
+.DESCRIPTION
+	enter-chat.ps1 
 .EXAMPLE
 	PS> ./enter-chat
 .NOTES

Scripts/fetch-repo.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	fetch-repo.ps1 [<repo-dir>]
-.DESCRIPTION
 	Fetches updates for a local Git repository (including submodules)
+.DESCRIPTION
+	fetch-repo.ps1 [<repo-dir>]
 .EXAMPLE
 	PS> ./fetch-repo
 .NOTES

Scripts/fetch-repos.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	fetch-repos.ps1 [<ParentDir>]
+	Fetches updates for all Git repositories in a folder (including submodules)
 .DESCRIPTION
-	Fetches updates for all Git repositories under the current/given directory (including submodules)
+	fetch-repos.ps1 [<ParentDir>]
 .EXAMPLE
 	PS> ./fetch-repos C:\MyRepos
 .NOTES

Scripts/get-md5.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	get-md5.ps1 [<file>]
-.DESCRIPTION
 	Prints the MD5 checksum of the given file
+.DESCRIPTION
+	get-md5.ps1 [<file>]
 .EXAMPLE
 	PS> ./get-md5 C:\MyFile.txt
 .NOTES

Scripts/get-sha1.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	get-sha1.ps1 [<file>]
+	Prints the SHA1 checksum of a file
 .DESCRIPTION
-	Prints the SHA1 checksum of the given file
+	get-sha1.ps1 [<file>]
 .EXAMPLE
 	PS> ./get-sha1 C:\MyFile.txt
 .NOTES

Scripts/get-sha256.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	get-sha256.ps1 [<file>]
+	Prints the SHA256 checksum of a file
 .DESCRIPTION
-	Prints the SHA256 checksum of the given file
+	get-sha256.ps1 [<file>]
 .EXAMPLE
 	PS> ./get-sha256 C:\MyFile.txt
 .NOTES

Scripts/hibernate.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	hibernate.ps1
-.DESCRIPTION
 	Enables hibernate mode for the local computer (needs admin rights)
+.DESCRIPTION
+	hibernate.ps1
 .EXAMPLE
 	PS> ./hibernate
 .NOTES

Scripts/inspect-exe.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	inspect-exe.ps1 [<path-to-exe-file>]
+	Prints basic information of an executable file
 .DESCRIPTION
-	Prints basic information of the given executable file
+	inspect-exe.ps1 [<path-to-exe-file>]
 .EXAMPLE
 	PS> ./inspect-exe C:\MyApp.exe
 .NOTES

Scripts/install-github-cli.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	install-github-cli.ps1 
-.DESCRIPTION
 	Installs GitHub CLI
+.DESCRIPTION
+	install-github-cli.ps1 
 .EXAMPLE
 	PS> ./install-github-cli
 .NOTES

Scripts/install-google-chrome.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	install-google-chrome.ps1
-.DESCRIPTION
 	Installs the latest Google Chrome browser
+.DESCRIPTION
+	install-google-chrome.ps1
 .EXAMPLE
 	PS> ./install-google-chrome
 .NOTES

Scripts/install-knot-resolver.ps1

@@ -1,8 +1,9 @@
 <#
 .SYNOPSIS
-        install-knot-resolver.ps1
+        Installs Knot Resolver (needs admin rights)
 .DESCRIPTION
-        Installs the Knot Resolver (a DNS resolver daemon, needs admin rights)
+        Knot Resolver is a DNS resolver daemon.
+        install-knot-resolver.ps1
 .EXAMPLE
         PS> ./install-knot-resolver
 .NOTES

Scripts/install-signal-cli.ps1

@@ -1,8 +1,9 @@
 <#
 .SYNOPSIS
-	install-signal-cli.ps1 [<version>]
+	Installs signal-cli 
 .DESCRIPTION
 	Installs signal-cli from github.com/AsamK/signal-cli. See the Web page for the correct version number
+	install-signal-cli.ps1 [<version>]
 .EXAMPLE
 	PS> ./install-signal-cli 0.11.12
 .NOTES

Scripts/install-ssh-client.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	install-ssh-client.ps1
-.DESCRIPTION
 	Installs the SSH client (needs admin rights)
+.DESCRIPTION
+	install-ssh-client.ps1
 .EXAMPLE
 	PS> ./install-ssh-client
 .NOTES

Scripts/install-ssh-server.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	install-ssh-server.ps1
-.DESCRIPTION
 	Installs the SSH server (needs admin rights)
+.DESCRIPTION
+	install-ssh-server.ps1
 .EXAMPLE
 	PS> ./install-ssh-server
 .NOTES

Scripts/install-updates.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	install-updates.ps1
+	Installs updates for the local machine (needs admin rights)
 .DESCRIPTION
-	Install updates on the local machhine (needs admin rights)
+	install-updates.ps1
 .EXAMPLE
 	PS> ./install-updates
 .NOTES

Scripts/install-wsl.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	install-wsl.ps1
+	Installs Windows Subsystem for Linux (needs admin rights)
 .DESCRIPTION
-	Installs Windows Subsystem for Linux (WSL) - needs admin rights
+	install-wsl.ps1
 .EXAMPLE
 	PS> ./install-wsl
 .NOTES

Scripts/introduce-powershell.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	introduce-powershell.ps1
-.DESCRIPTION
 	Introduces PowerShell to new users
+.DESCRIPTION
+	introduce-powershell.ps1
 .EXAMPLE
 	PS> ./introduce-powershell
 .NOTES

Scripts/list-aliases.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	list-aliases.ps1
-.DESCRIPTION
 	Lists all PowerShell aliases
+.DESCRIPTION
+	list-aliases.ps1
 .EXAMPLE
 	PS> ./list-aliases
 

Scripts/list-anagrams.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	list-anagrams.ps1 [<word>] [<columns>]
-.DESCRIPTION
 	Lists all anagrams of the given word
+.DESCRIPTION
+	list-anagrams.ps1 [<word>] [<columns>]
 .EXAMPLE
 	PS> ./list-anagrams Baby
 .NOTES

Scripts/list-automatic-variables.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	list-automatic-variables.ps1
-.DESCRIPTION
 	Lists all automatic variables of PowerShell
+.DESCRIPTION
+	list-automatic-variables.ps1
 .EXAMPLE
 	PS> ./list-automatic-variables
 

Scripts/list-branches.ps1

@@ -1,8 +1,10 @@
 <#
 .SYNOPSIS
-	list-branches.ps1 [<repo-dir>] [<pattern>]
+	Lists all branches in a Git repository
 .DESCRIPTION
-	Lists all branches in the current/given Git repository
+	list-branches.ps1 [<RepoDir>] [<SearchPattern>]
+	<RepoDir> is the current working directory by default
+	<SearchPattern> is "*" (anything) by default
 .EXAMPLE
 	PS> ./list-branches
 .NOTES
@@ -11,7 +13,7 @@
 	https://github.com/fleschutz/PowerShell
 #>
 
-param([string]$RepoDir = "$PWD", [string]$Pattern = "*")
+param([string]$RepoDir = "$PWD", [string]$SearchPattern = "*")
 
 try {
 	if (-not(test-path "$RepoDir" -pathType container)) { throw "Can't access directory: $RepoDir" }
@@ -31,7 +33,7 @@ try {
 	foreach($Branch in $Branches) {
 		if ("$Branch" -match "origin/HEAD") { continue }
 		$BranchName = $Branch.substring(9)
-		if ("$BranchName" -notlike "$Pattern") { continue }
+		if ("$BranchName" -notlike "$SearchPattern") { continue }
 		"$BranchName"
 	}
 	""

Scripts/list-cheat-sheet.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	list-cheat-sheet.ps1 
-.DESCRIPTION
 	Lists the PowerShell cheat sheet
+.DESCRIPTION
+	list-cheat-sheet.ps1 
 .EXAMPLE
 	PS> ./list-cheat-sheet
 .NOTES

Scripts/list-city-weather.ps1

@@ -1,8 +1,9 @@
 <#
 .SYNOPSIS
-	list-city-weather.ps1
+	List the current weather of cities world-wide 
 .DESCRIPTION
 	List the current weather of cities world-wide (west to east)
+	list-city-weather.ps1
 .EXAMPLE
 	PS> ./list-city-weather
 .NOTES

Scripts/list-cli-tools.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	list-cli-tools.ps1
-.DESCRIPTION
 	Lists available command-line interface (CLI) tools
+.DESCRIPTION
+	list-cli-tools.ps1
 .EXAMPLE
 	PS> ./list-cli-tools
 

Scripts/list-clipboard.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	list-clipboard.ps1
-.DESCRIPTION
 	Lists the contents of the clipboard
+.DESCRIPTION
+	list-clipboard.ps1
 .EXAMPLE
 	PS> ./list-clipboard
 .NOTES

Scripts/list-cmdlets.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	list-cmdlets.ps1 
-.DESCRIPTION
 	Lists all PowerShell cmdlets
+.DESCRIPTION
+	list-cmdlets.ps1 
 .EXAMPLE
 	PS> ./list-cmdlets
 

Scripts/list-commits.ps1

@@ -1,8 +1,10 @@
 <#
 .SYNOPSIS
-	list-commits.ps1 [<RepoDir>] [<Format>]
+	Lists all commits in a Git repository
 .DESCRIPTION
-	Lists all commits in a Git repository (format is: list|compact|normal|JSON)
+	list-commits.ps1 [<RepoDir>] [<Format>]
+	<RepoDir> is the path to the Git repository
+	<Format> is either: list|compact|normal|JSON
 .EXAMPLE
 	PS> ./list-commits
 

Scripts/list-console-colors.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	list-console-colors.ps1 
-.DESCRIPTION
 	Lists all console colors
+.DESCRIPTION
+	list-console-colors.ps1 
 .EXAMPLE
 	PS> ./list-console-colors
 .NOTES

Scripts/list-countries.ps1

@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	list-countries.ps1 
-.DESCRIPTION
 	Lists details of all countries
+.DESCRIPTION
+	list-countries.ps1 
 .EXAMPLE
 	PS> ./list-countries
 .NOTES