Re: -v, --verbosity=LEVEL use the given verbosity LEVEL

2023-10-01 Thread jgart
Hi Maxim,

Thanks for the reply and info.

I don't mind doing the work to find out exactly what is being logged with deep 
understanding of Guile/Guix's logging mechanism. A bird's eye view while still 
understanding the low level and commenting on it.

It will require some time to do that research and write a good explanation.

I'm in no rush so I will try unless someone else gets to it first.

Might be good to talk with the person who wrote that logging to discuss the 
information and concepts involved in the context of guile and guix.

all best,

jgart



Re: -v, --verbosity=LEVEL use the given verbosity LEVEL

2023-10-01 Thread Maxim Cournoyer
Hi,

"jgart"  writes:

>> 1 is for quiet output; 2 is similar to 1 but it additionally displays 
>> download URLs; 
>
>> it additionally displays
>
> I think it is confusing to use the word "additionally" here as there is 
> nothing that we know about the quiet output for the description that let's us 
> then conceptualize what will be added to it.
>
> In other words, level 1 should be described with more detail than "1 is for 
> quiet output". 
>
> What should we expect to see in the content of verbosity level 1 in general.
>
> I would have to find the time to conduct some empirical usages with the 
> --verbosity flag to answer that question succinctly and in the general across 
> guix subcommands beyond just describing it as "quiet output".
>
> WDYT, nitpick? maybe/maybenot

I agree it can be improved, but I'd also have to read the code to know
what each level exactly do.

I think it could make things simpler to use nouns for the level, as they
could mean something without having to be explained to verbosely, e.g.:

debug (very verbose)
info (include some extra messages)
warning (warnings and errors -- the default level)
error (errors only)

Basically like what the levels of the 'logging' Python library are
expected to do, which the logging library included with guile-lib is
inspired by.

-- 
Thanks,
Maxim