Merge pull request #1191 from xexyl/usage

Improve mkiocccentry usage string

Author: lcn2

CHANGES.md

@@ -27,6 +27,9 @@ defeat the purpose of the answers file). The use of `-Y` is highly discouraged
 unless you are **certain** you're good to go and it is mostly used for
 `mkiocccentry_test.sh` which needs to be non-interactive.
 
+Improve usage string about `workdir` and `topdir` to make certain things a bit
+clearer.
+
 Updated `MKIOCCCENTRY_VERSION` to `"1.2.35 2025-02-27"`.
 Updated `MKIOCCCENTRY_TEST_VERSION` to` "1.0.15 2025-02-26"`.
 

mkiocccentry.c

@@ -131,7 +131,7 @@ static const char * const usage_msg1 =
     "\t-t tar\t\tpath to tar(1) that supports the -J (xz) option (def: %s)\n"
     "\t-l ls\t\tpath to ls(1) (def: %s)\n"
     "\t-T txzchk\tpath to txzchk(1) (def: %s)\n"
-    "\t-e\t\tentertainment mode\n"
+    "\t-e\t\tentertainment mode (for txzchk)\n"
     "\t-f feathers\tdefine how many feathers is feathery (for -e)\n"
     "\t-F fnamchk\tpath to fnamchk(1) (used by txzchk) (def: %s)";
 static const char * const usage_msg2 =
@@ -152,8 +152,9 @@ static const char * const usage_msg3 =
     "\t\t\t    NOTE: you can ignore more than one file or directory with multiple -I args\n";
 static const char * const usage_msg4 =
     "\tworkdir\t\tdirectory where the submission directory and tarball are formed\n"
+    "\t\t\t    NOTE: the submission directory under this directory must NOT exist\n"
     "\ttopdir\t\tdirectory with required, optional and extra files and/or directories\n"
-    "\t\t\t    to be copied to tarball\n";
+    "\t\t\t    NOTE: the topdir MUST have your prog.c, Makefile and remarks.md\n";
 static const char * const usage_msg5 =
     "\n"
     "Exit codes:\n"