From d9997184fdc9dca6d057ff56a8ed861c43a76439 Mon Sep 17 00:00:00 2001
From: anth64 <anth64@protonmail.com>
Date: Tue, 15 Sep 2026 12:44:58 +0200
Subject: [PATCH] feat: add -h/--help with full option descriptions to
 fpack/funpack

---
 tools/fpack.c   | 22 +++++++++++++++++++++-
 tools/funpack.c | 33 ++++++++++++++++++++++++++++++---
 2 files changed, 51 insertions(+), 4 deletions(-)

diff --git a/tools/fpack.c b/tools/fpack.c
index c7b80f0..30e4ff5 100644
--- a/tools/fpack.c
+++ b/tools/fpack.c
@@ -34,6 +34,7 @@ static struct option long_opts[] = {
 	{"progress", no_argument,       NULL, 'p'},
 	{"quiet",    no_argument,       NULL, 'q'},
 	{"verbose",  no_argument,       NULL, 'v'},
+	{"help",     no_argument,       NULL, 'h'},
 	{NULL, 0, NULL, 0}
 };
 
@@ -230,9 +231,25 @@ static int add_dir(struct fpk_writer *w, const char *dir, size_t base_len)
 static void usage(void)
 {
 	fprintf(stderr, "usage: %s [-o output.fpk] [-p] [-q] [-v] input_dir\n", PROGRAM_NAME);
+	fprintf(stderr, "try '%s --help' for more information\n", PROGRAM_NAME);
 	exit(1);
 }
 
+static void help(void)
+{
+	printf("usage: %s [options] input_dir\n", PROGRAM_NAME);
+	printf("\n");
+	printf("Pack a directory tree into an fpk archive.\n");
+	printf("\n");
+	printf("options:\n");
+	printf("  -o, --output=FILE  write the archive to FILE instead of the derived name\n");
+	printf("  -p, --progress     print packing progress\n");
+	printf("  -q, --quiet        suppress the final summary line\n");
+	printf("  -v, --verbose      print each packed entry\n");
+	printf("  -h, --help         show this help and exit\n");
+	exit(0);
+}
+
 int main(int argc, char **argv)
 {
 	const char *output_arg = NULL;
@@ -242,7 +259,7 @@ int main(int argc, char **argv)
 	struct fpk_writer *w;
 	int c;
 
-	while ((c = getopt_long(argc, argv, "o:pqv", long_opts, NULL)) != -1) {
+	while ((c = getopt_long(argc, argv, "o:pqvh", long_opts, NULL)) != -1) {
 		switch (c) {
 		case 'o':
 			output_arg = optarg;
@@ -256,6 +273,9 @@ int main(int argc, char **argv)
 		case 'v':
 			flags |= FPACK_VERBOSE;
 			break;
+		case 'h':
+			help();
+			break;
 		default:
 			usage();
 		}
diff --git a/tools/funpack.c b/tools/funpack.c
index 0283331..ebaeda6 100644
--- a/tools/funpack.c
+++ b/tools/funpack.c
@@ -32,6 +32,7 @@ static struct option long_opts[] = {
 	{"progress", no_argument,       NULL, 'p'},
 	{"quiet",    no_argument,       NULL, 'q'},
 	{"verbose",  no_argument,       NULL, 'v'},
+	{"help",     no_argument,       NULL, 'h'},
 	{NULL, 0, NULL, 0}
 };
 
@@ -57,17 +58,23 @@ static char *join_path(const char *dir, const char *name)
 	return out;
 }
 
+#ifdef _WIN32
+#define IS_PATH_SEP(c) ((c) == '/' || (c) == '\\')
+#else
+#define IS_PATH_SEP(c) ((c) == '/')
+#endif
+
 static char *basename_dup(const char *path)
 {
 	size_t end = strlen(path);
 	size_t start;
 	char *out;
 
-	while (end > 0 && path[end - 1] == '/')
+	while (end > 0 && IS_PATH_SEP(path[end - 1]))
 		end--;
 
 	start = end;
-	while (start > 0 && path[start - 1] != '/')
+	while (start > 0 && !IS_PATH_SEP(path[start - 1]))
 		start--;
 
 	out = malloc(end - start + 1);
@@ -155,9 +162,26 @@ static int extract_entry(const char *out_dir, const fpk_entry_t *entry,
 static void usage(void)
 {
 	fprintf(stderr, "usage: %s [-d output_dir] [-l] [-p] [-q] [-v] input.fpk\n", PROGRAM_NAME);
+	fprintf(stderr, "try '%s --help' for more information\n", PROGRAM_NAME);
 	exit(1);
 }
 
+static void help(void)
+{
+	printf("usage: %s [options] input.fpk\n", PROGRAM_NAME);
+	printf("\n");
+	printf("Extract files from an fpk archive.\n");
+	printf("\n");
+	printf("options:\n");
+	printf("  -d, --dir=DIR      extract into DIR instead of the archive's derived name\n");
+	printf("  -l, --list         list archive entries and exit, without extracting\n");
+	printf("  -p, --progress     print extraction progress\n");
+	printf("  -q, --quiet        suppress the final summary line\n");
+	printf("  -v, --verbose      print each extracted entry\n");
+	printf("  -h, --help         show this help and exit\n");
+	exit(0);
+}
+
 int main(int argc, char **argv)
 {
 	const char *dir_arg = NULL;
@@ -168,7 +192,7 @@ int main(int argc, char **argv)
 	uint64_t i;
 	int c;
 
-	while ((c = getopt_long(argc, argv, "d:lpqv", long_opts, NULL)) != -1) {
+	while ((c = getopt_long(argc, argv, "d:lpqvh", long_opts, NULL)) != -1) {
 		switch (c) {
 		case 'd':
 			dir_arg = optarg;
@@ -185,6 +209,9 @@ int main(int argc, char **argv)
 		case 'v':
 			flags |= FUNPACK_VERBOSE;
 			break;
+		case 'h':
+			help();
+			break;
 		default:
 			usage();
 		}