From a83d7087f232c0848b0ad1cd18faf19bd0daabb2 Mon Sep 17 00:00:00 2001 From: Rongsong Shen Date: Thu, 10 Sep 2026 08:39:05 +0000 Subject: [PATCH] docs(xce-test-cli-ux): document jobsub -n's min,max task-range format The hand-written per-flag description explaining -n's [,] format was dropped when task 3.5 moved the flag list to the generated flagspec block (which only shows short/long/required/default, with no room for a flag's value-format semantics). Restore the explanation as prose in USAGE_JOBSUB_HEAD, following the same pattern already used by resupdate's HEAD (-n/-v pairing, -t's conditional meaning). Co-Authored-By: Claude Sonnet 5 Claude-Session: https://claude.ai/code/session_019jaMf9QEwpugH2W9KAuc7f --- src/controller/testsuite/test.c | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/src/controller/testsuite/test.c b/src/controller/testsuite/test.c index 1bf6bbbe..45a45195 100644 --- a/src/controller/testsuite/test.c +++ b/src/controller/testsuite/test.c @@ -607,9 +607,12 @@ static const char USAGE_JOBRUN_TAIL[] = static const char USAGE_JOBSUB_HEAD[] = "jobsub -u -q -c [-R ]\n" " [-n [,]] [-x ] [-a ]\n" - " Submits a new job to the cluster under the given user and queue;\n" - " -x's exdata JSON, when given, overrides the command's built-in\n" - " PATH env instead of the default.\n"; + " Submits a new job to the cluster under the given user and queue.\n" + " -n accepts either a single task count, or a comma-separated\n" + " , pair to request an elastic task count the scheduler\n" + " may dispatch anywhere in that range; -x's exdata JSON, when\n" + " given, overrides the command's built-in PATH env instead of the\n" + " default.\n"; static const char USAGE_JOBSUB_TAIL[] = " On success, captures the submitted JobId into the $jobid\n"