From mboxrd@z Thu Jan  1 00:00:00 1970
From: Ludovic =?UTF-8?Q?Court=C3=A8s?= <ludo@gnu.org>
Subject: bug#33673: "guix system --help" does not detail how to use
	--on-error=strategy
Date: Sun, 09 Dec 2018 00:16:47 +0100
Message-ID: <87ftv7623k.fsf@gnu.org>
References: <87pnuccuk2.fsf@gmail.com>
	<74aa65394c92165fbf4c2f777099eab3@riseup.net>
	<2a004926090617e0227252136dc35dab@riseup.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:50491)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1gVlqK-0005yZ-FE
	for bug-guix@gnu.org; Sat, 08 Dec 2018 18:17:05 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1gVlqJ-00081I-RH
	for bug-guix@gnu.org; Sat, 08 Dec 2018 18:17:04 -0500
Received: from debbugs.gnu.org ([208.118.235.43]:34651)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
	id 1gVlqJ-00081C-Mr
	for bug-guix@gnu.org; Sat, 08 Dec 2018 18:17:03 -0500
Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1gVlqJ-00086N-Fj
	for bug-guix@gnu.org; Sat, 08 Dec 2018 18:17:03 -0500
Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-Message-ID: <handler.33673.B33673.154431101831128@debbugs.gnu.org>
In-Reply-To: <2a004926090617e0227252136dc35dab@riseup.net> (swedebugia's
	message of "Sat, 08 Dec 2018 00:30:54 -0800")
List-Id: Bug reports for GNU Guix <bug-guix.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-guix/>
List-Post: <mailto:bug-guix@gnu.org>
List-Help: <mailto:bug-guix-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=subscribe>
Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org
Sender: "bug-Guix" <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
To: swedebugia@riseup.net
Cc: 33673@debbugs.gnu.org

Hi,

swedebugia@riseup.net skribis:

> The current output is:
>
> --on-error=3DSTRATEGY    apply STRATEGY when an error occurs while reading
> FILE

FWIW I think it=E2=80=99s reasonable for =E2=80=98--help=E2=80=99 to be gen=
erally 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=E2=80=99s best to discuss what you have in mind first?

Thank you,
Ludo=E2=80=99.