* bug#63036: -v or --verbose CLI argument input is undocumented in the CLI
@ 2023-04-23 15:27 jgart via Bug reports for GNU Guix
2023-04-25 12:36 ` Simon Tournier
0 siblings, 1 reply; 2+ messages in thread
From: jgart via Bug reports for GNU Guix @ 2023-04-23 15:27 UTC (permalink / raw)
To: 63036
User story:
jgart tries to build a currently broken Python music package:
$ guix build -v 6 music21
Hmmm, what is the allowed input range for -v/--verbosity command line flag?
$ guix build --help
-v, --verbosity=LEVEL use the given verbosity LEVEL
Hmmm, what is the type and/or range of inputs that are valid for LEVEL?
Darn, I have to go find what the underlying implementation function takes as a valid verbosity level in the source code instead of just reading the documentation output of `guix build --help`.
...but I just want to know everything that I need to know from just using the CLI and its help system as the user.
jgart adds TODO to document the valid levels in the CLI verbosity option itself
jgart thinks but what if the help message on the valid levels is too long once added?
jgart goes to get ice cream
^ permalink raw reply [flat|nested] 2+ messages in thread
* bug#63036: -v or --verbose CLI argument input is undocumented in the CLI
2023-04-23 15:27 bug#63036: -v or --verbose CLI argument input is undocumented in the CLI jgart via Bug reports for GNU Guix
@ 2023-04-25 12:36 ` Simon Tournier
0 siblings, 0 replies; 2+ messages in thread
From: Simon Tournier @ 2023-04-25 12:36 UTC (permalink / raw)
To: jgart, 63036
[-- Attachment #1: Type: text/plain, Size: 200 bytes --]
Hi,
On Sun, 23 Apr 2023 at 15:27, "jgart" via Bug reports for GNU Guix <bug-guix@gnu.org> wrote:
> Hmmm, what is the type and/or range of inputs that are valid for
> LEVEL?
What about this patch?
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: p.patch --]
[-- Type: text/x-diff, Size: 796 bytes --]
diff --git a/guix/scripts/build.scm b/guix/scripts/build.scm
index 72a24f91ac..35cb888c3b 100644
--- a/guix/scripts/build.scm
+++ b/guix/scripts/build.scm
@@ -452,8 +452,10 @@ (define (show-help)
-r, --root=FILE make FILE a symlink to the result, and register it
as a garbage collector root"))
(display (G_ "
- -v, --verbosity=LEVEL use the given verbosity LEVEL"))
- (display (G_ "
+ -v, --verbosity=LEVEL use the given verbosity LEVEL, range 0-3
+ 0 = no output, 1 = quiet, 2 = 1 + download URLs,
+ 3 = all on standard error"))
+ (display (G_ "
-q, --quiet do not show the build log"))
(display (G_ "
--log-file return the log file names for the given derivations"))
[-- Attachment #3: Type: text/plain, Size: 16 bytes --]
Cheers,
simon
^ permalink raw reply related [flat|nested] 2+ messages in thread
end of thread, other threads:[~2023-04-27 13:21 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-04-23 15:27 bug#63036: -v or --verbose CLI argument input is undocumented in the CLI jgart via Bug reports for GNU Guix
2023-04-25 12:36 ` Simon Tournier
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/guix.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).