| |
@@ -562,9 +562,13 @@
|
| |
help="Wait on the build, even if running in the background")
|
| |
parser.add_option("--nowait", action="store_false", dest="wait", help="Don't wait on build")
|
| |
parser.add_option("--wait-repo", action="store_true",
|
| |
- help="Wait for a current repo for the build tag")
|
| |
+ help="Wait for a current repo for the build tag before "
|
| |
+ "building")
|
| |
parser.add_option("--wait-build", metavar="NVR", action="append", dest="wait_builds",
|
| |
- default=[], help="Wait for the given nvr to appear in buildroot repo")
|
| |
+ default=[],
|
| |
+ help="Wait for the given NVR to appear, and refresh the "
|
| |
+ "buildroot repo if needed to include the NVR before "
|
| |
+ "building")
|
| |
parser.add_option("--quiet", action="store_true",
|
| |
help="Do not print the task information", default=options.quiet)
|
| |
parser.add_option("--arch-override", help="Override build arches")
|
| |
@@ -7275,9 +7279,11 @@
|
| |
parser.add_option("--target", action="store_true",
|
| |
help="Interpret the argument as a build target name")
|
| |
parser.add_option("--request", action="store_true",
|
| |
- help="Create a repo request (requires auth)")
|
| |
+ help="Request refreshing the repo and wait until the "
|
| |
+ "refresh is done (requires auth)")
|
| |
parser.add_option("--no-request", action="store_false", dest="request",
|
| |
- help="Do not create a repo request (the default)")
|
| |
+ help="Do not request refreshing the repo, just wait for "
|
| |
+ "it to happen (the default)")
|
| |
parser.add_option("--timeout", type="int", default=120,
|
| |
help="Amount of time to wait (in minutes) before giving up "
|
| |
"(default: 120)")
|
| |
rombobeorn
commented 4 months ago
This improves the help texts for a few options, based on explanations posted to the Fedora devel mailing list, so that users don't need to divine what the options do.
To a user who isn't a Koji admin it's not clear what a "repo request" is or why anyone would want to create one. I reworded two descriptions in words that a user can understand.
The description of --wait-build should state explicitly that it will refresh the repo, not just wait for it to happen, and that it does so before building the package.
It's still unclear to me what --wait-repo actually does. It was said in the email thread that it does nothing if the repo is less than one hour old, and refreshes the repo if it's older than that, but it was also said that Koji will refresh the repo anyway if it's older than one hour, which would make --wait-repo meaningless. Anyway, it was clearly stated that whatever --wait-repo does, it does it before the package build, not after, so the help text should say so.
Please check that these descriptions are true, as I'm only going by what I've been told.