From mboxrd@z Thu Jan 1 00:00:00 1970 From: swedebugia@riseup.net Subject: bug#33673: "guix system --help" does not detail how to use --on-error=strategy Date: Mon, 10 Dec 2018 23:27:48 -0800 Message-ID: References: <87pnuccuk2.fsf@gmail.com> <74aa65394c92165fbf4c2f777099eab3@riseup.net> <2a004926090617e0227252136dc35dab@riseup.net> <87ftv7623k.fsf@gnu.org> <20181211071841.GC1323@macbook41> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57456) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gWcSi-0001J1-Ap for bug-guix@gnu.org; Tue, 11 Dec 2018 02:28:13 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gWcSb-00082o-Ex for bug-guix@gnu.org; Tue, 11 Dec 2018 02:28:11 -0500 Received: from debbugs.gnu.org ([208.118.235.43]:38464) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gWcSY-000819-DP for bug-guix@gnu.org; Tue, 11 Dec 2018 02:28:03 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gWcSY-0007lD-5h for bug-guix@gnu.org; Tue, 11 Dec 2018 02:28:02 -0500 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: <20181211071841.GC1323@macbook41> List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org Sender: "bug-Guix" To: Efraim Flashner Cc: 33673@debbugs.gnu.org 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@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