From f1a20bc962f1d59083d1536409472eeca710e203 Mon Sep 17 00:00:00 2001
From: Markus Fleschutz <markus.fleschutz@atcsim.de>
Date: Wed, 8 Jan 2025 14:29:32 +0100
Subject: [PATCH] Updated list-commits.ps1 and watch-commits.ps1

---
 scripts/list-commits.ps1  | 26 +++++++++++++-------------
 scripts/watch-commits.ps1 |  4 ++--
 2 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/scripts/list-commits.ps1 b/scripts/list-commits.ps1
index 73f723e7..8d41b4fe 100755
--- a/scripts/list-commits.ps1
+++ b/scripts/list-commits.ps1
@@ -4,7 +4,7 @@
 .DESCRIPTION
 	This PowerShell script lists all commits in a Git repository. Supported output formats are: pretty, list, compact, normal or JSON.
 .PARAMETER RepoDir
-	Specifies the path to the Git repository.
+	Specifies the file path to the local Git repository.
 .PARAMETER Format
 	Specifies the output format: pretty|list|compact|normal|JSON (pretty by default)
 .EXAMPLE
@@ -20,40 +20,40 @@
 	Author: Markus Fleschutz | License: CC0
 #>
 
-param([string]$RepoDir = "$PWD", [string]$Format = "pretty")
+param([string]$pathToRepo = "$PWD", [string]$format = "pretty")
 
 try {
-	if (-not(Test-Path "$RepoDir" -pathType container)) { throw "Can't access directory: $RepoDir" }
+	if (-not(Test-Path "$pathToRepo" -pathType container)) { throw "Can't access directory: $pathToRepo" }
 
-	$Null = (git --version)
+	$null = (git --version)
 	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
 
 	Write-Progress "Fetching latest updates..."
-	& git -C "$RepoDir" fetch --all --quiet
+	& git -C "$pathToRepo" fetch --all --quiet
 	if ($lastExitCode -ne "0") { throw "'git fetch' failed" }
 	Write-Progress -Completed "Done."
 
-	if ($Format -eq "pretty") {
+	if ($format -eq "pretty") {
 		""
-		& git -C "$RepoDir" log --graph --format=format:'%C(bold yellow)%s%C(reset)%d by %an 🕘%cs 🔗%h' --all
-	} elseif ($Format -eq "list") {
+		& git -C "$pathToRepo" log --graph --format=format:'%C(bold yellow)%s%C(reset)%d by %an 🕘%cs 🔗%h' --all
+	} elseif ($format -eq "list") {
 		""
 		"Hash            Date            Author                  Description"
 		"----            ----            ------                  -----------"
 		& git log --pretty=format:"%h%x09%cs%x09%an%x09%s"
-	} elseif ($Format -eq "compact") {
+	} elseif ($format -eq "compact") {
 		""
 		"List of Git Commits"
 		"-------------------"
-		& git -C "$RepoDir" log --graph --pretty=format:'%Cred%h%Creset%C(yellow)%d%Creset %s %C(bold blue)by %an %cr%Creset' --abbrev-commit
+		& git -C "$pathToRepo" log --graph --pretty=format:'%Cred%h%Creset%C(yellow)%d%Creset %s %C(bold blue)by %an %cr%Creset' --abbrev-commit
 		if ($lastExitCode -ne "0") { throw "'git log' failed" }
-	} elseif ($Format -eq "JSON") {
-		& git -C "$RepoDir" log --pretty=format:'{%n  "commit": "%H",%n  "abbreviated_commit": "%h",%n  "tree": "%T",%n  "abbreviated_tree": "%t",%n  "parent": "%P",%n  "abbreviated_parent": "%p",%n  "refs": "%D",%n  "encoding": "%e",%n  "subject": "%s",%n  "sanitized_subject_line": "%f",%n  "body": "%b",%n  "commit_notes": "%N",%n  "verification_flag": "%G?",%n  "signer": "%GS",%n  "signer_key": "%GK",%n  "author": {%n    "name": "%aN",%n    "email": "%aE",%n    "date": "%aD"%n  },%n  "commiter": {%n    "name": "%cN",%n    "email": "%cE",%n    "date": "%cD"%n  }%n},'
+	} elseif ($format -eq "JSON") {
+		& git -C "$pathToRepo" log --pretty=format:'{%n  "commit": "%H",%n  "abbreviated_commit": "%h",%n  "tree": "%T",%n  "abbreviated_tree": "%t",%n  "parent": "%P",%n  "abbreviated_parent": "%p",%n  "refs": "%D",%n  "encoding": "%e",%n  "subject": "%s",%n  "sanitized_subject_line": "%f",%n  "body": "%b",%n  "commit_notes": "%N",%n  "verification_flag": "%G?",%n  "signer": "%GS",%n  "signer_key": "%GK",%n  "author": {%n    "name": "%aN",%n    "email": "%aE",%n    "date": "%aD"%n  },%n  "commiter": {%n    "name": "%cN",%n    "email": "%cE",%n    "date": "%cD"%n  }%n},'
 	} else {
 		""
 		"List of Git Commits"
 		"-------------------"
-		& git -C "$RepoDir" log
+		& git -C "$pathToRepo" log
 		if ($lastExitCode -ne "0") { throw "'git log' failed" }
 	}
 	exit 0 # success
diff --git a/scripts/watch-commits.ps1 b/scripts/watch-commits.ps1
index 2da50012..73c32d85 100755
--- a/scripts/watch-commits.ps1
+++ b/scripts/watch-commits.ps1
@@ -1,8 +1,8 @@
 <#
 .SYNOPSIS
-	Watch commits live.
+	Watch Git commits live.
 .DESCRIPTION
-	This PowerShell script continuously lists the latest commit in a Git repository in real-time.
+	This PowerShell script continuously lists the latest commits in a Git repository in real-time.
 .PARAMETER pathToRepo
 	Specifies the file path to the local Git repository.
 .EXAMPLE