GNU bug report logs - #33673
"guix system --help" does not detail how to use --on-error=strategy

Previous Next

Full log

Message #14 received at 33673 <at> debbugs.gnu.org (full text, mbox):

From: swedebugia <at> riseup.net
To: Efraim Flashner <efraim <at> flashner.co.il>
Cc: 33673 <at> debbugs.gnu.org, Ludovic Courtès <ludo <at> gnu.org>
Subject: Re: bug#33673: "guix system --help" does not detail how to use
 --on-error=strategy
Date: Mon, 10 Dec 2018 23:27:48 -0800

On 2018-12-11 08:18, Efraim Flashner wrote:
> On Sun, Dec 09, 2018 at 12:16:47AM +0100, Ludovic Courtès wrote:
>> Hi,
>>
>> swedebugia <at> riseup.net skribis:
>>
>> > The current output is:
>> >
>> > --on-error=STRATEGY    apply STRATEGY when an error occurs while reading
>> > FILE
>>
>> FWIW I think it’s reasonable for ‘--help’ to be generally more concise
>> than the manual.  We could list the possible strategies here, but that
>> might clutter the output more than is desirable.
>>
>> > Additionally we now have so many commands in the help pages of guix
>> > system and guix build that it would be nice to present them in a more
>> > readable/categorized way.
>> >
>> > Would a patches for improvement in these areas be accepted?
>>
>> Improvements are always welcome of course.  The main criterion would be
>> to remain consistent with the rest of Guix and with GNU conventions that
>> we follow.  Maybe it’s best to discuss what you have in mind first?
>>
>> Thank you,
>> Ludo’.
>>
> 
> I'd go with (one of: nothing-special, backtrace, debug)
> with the assumption that for more information the manual is more
> verbose.

Sounds good to me. Clutter is a problem we already have it seems so lets
not make it worse.

> 
> I also just noticed that we have 'man guix-system', which could be more
> verbose on the subject without needing to fit in a concise output.

Where do I edit this man-page?

-- 
Cheers 
Swedebugia

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.