From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id 6KcTGxFrT18UDAAA0tVLHw (envelope-from ) for ; Wed, 02 Sep 2020 09:51:13 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id yJLjFhFrT1/PYQAAB5/wlQ (envelope-from ) for ; Wed, 02 Sep 2020 09:51:13 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id A816B9404D8 for ; Wed, 2 Sep 2020 09:51:12 +0000 (UTC) Received: from localhost ([::1]:57626 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kDPQ5-0000NY-Tk for larch@yhetil.org; Wed, 02 Sep 2020 05:51:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:40826) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kDPPy-0000Lk-6u for guix-patches@gnu.org; Wed, 02 Sep 2020 05:51:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:46826) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kDPPx-0007D3-T5 for guix-patches@gnu.org; Wed, 02 Sep 2020 05:51:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kDPPx-0007FS-R3 for guix-patches@gnu.org; Wed, 02 Sep 2020 05:51:01 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#43159] [PATCH 0/2] Make 'guix help' helpful Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 02 Sep 2020 09:51:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 43159 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Efraim Flashner Cc: 43159@debbugs.gnu.org Received: via spool by 43159-submit@debbugs.gnu.org id=B43159.159904023027787 (code B ref 43159); Wed, 02 Sep 2020 09:51:01 +0000 Received: (at 43159) by debbugs.gnu.org; 2 Sep 2020 09:50:30 +0000 Received: from localhost ([127.0.0.1]:58364 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kDPPR-0007E5-N5 for submit@debbugs.gnu.org; Wed, 02 Sep 2020 05:50:30 -0400 Received: from eggs.gnu.org ([209.51.188.92]:58814) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kDPPP-0007Di-AZ for 43159@debbugs.gnu.org; Wed, 02 Sep 2020 05:50:28 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:42365) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kDPPJ-00075b-CU; Wed, 02 Sep 2020 05:50:21 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=53528 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kDPPI-0005gD-Ki; Wed, 02 Sep 2020 05:50:21 -0400 From: Ludovic =?UTF-8?Q?Court=C3=A8s?= References: <20200901203520.21103-1-ludo@gnu.org> <20200902080622.GI856@E5400> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 17 Fructidor an 228 de la =?UTF-8?Q?R=C3=A9volution?= X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu Date: Wed, 02 Sep 2020 11:50:17 +0200 In-Reply-To: <20200902080622.GI856@E5400> (Efraim Flashner's message of "Wed, 2 Sep 2020 11:06:22 +0300") Message-ID: <87a6y87bja.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Spam-Score: -3.3 (---) X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Spam-Score: -1.01 X-TUID: zmgjSWyTFlUo Hi, Efraim Flashner skribis: > On Tue, Sep 01, 2020 at 10:35:20PM +0200, Ludovic Court=C3=A8s wrote: >> Hey Guix! >>=20 >> Here=E2=80=99s another long-overdue change that was brought to my >> attention: making =E2=80=98guix help=E2=80=99 show a synopsis of each co= mmand. >> While at it, it also groups them in categories (I more or >> less followed the manual, but there=E2=80=99s prolly room for >> improvement, like a =E2=80=98packaging=E2=80=99 category maybe?): >>=20 > > I dislike the idea that some commands are only for developers and some > commands are "too advanced for the common user" (my words, not yours). Yeah, I=E2=80=99m ambivalent about this as well. > Before bikeshedding about where the options should be, how about: > commands for developers -> commands related to building Rather, =E2=80=9Ccommands for development=E2=80=9C, because that=E2=80=99s = really what =E2=80=98guix environment=E2=80=99 is about, for instance, but saying =E2=80=98developmen= t=E2=80=99 rather than =E2=80=98developers=E2=80=99 is probably wise. > advanced usage -> commands related to verification Well that only works for =E2=80=98challenge=E2=80=99 (which I=E2=80=99d lik= e to put in the hands of =E2=80=98normal=E2=80=99 users, so I=E2=80=99m not comfortable with the = =E2=80=98advanced=E2=80=99 label, but OTOH, it=E2=80=99s clearly not one of the commands you=E2=80=99d begin with= .) What about archive, copy, download, etc.? > This way they're still "commands for everybody" and they're more > descriptive than just "advanced" "expert" and "debug" style headers. Understood. Thanks for your feedback! Ludo=E2=80=99.