From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id 6L21MNN9T1/QBQAA0tVLHw (envelope-from ) for ; Wed, 02 Sep 2020 11:11:15 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id aIKOLNN9T1/EXQAA1q6Kng (envelope-from ) for ; Wed, 02 Sep 2020 11:11:15 +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 2B333940539 for ; Wed, 2 Sep 2020 11:11:15 +0000 (UTC) Received: from localhost ([::1]:35174 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kDQfZ-0004HH-WB for larch@yhetil.org; Wed, 02 Sep 2020 07:11:14 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35350) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kDQfO-0004Gv-IP for guix-patches@gnu.org; Wed, 02 Sep 2020 07:11:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:46944) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kDQfO-0001NW-96 for guix-patches@gnu.org; Wed, 02 Sep 2020 07:11:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kDQfO-0000sd-5F for guix-patches@gnu.org; Wed, 02 Sep 2020 07:11:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#43159] [PATCH 0/2] Make 'guix help' helpful Resent-From: Efraim Flashner Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 02 Sep 2020 11:11:02 +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: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 43159@debbugs.gnu.org Received: via spool by 43159-submit@debbugs.gnu.org id=B43159.15990450453359 (code B ref 43159); Wed, 02 Sep 2020 11:11:02 +0000 Received: (at 43159) by debbugs.gnu.org; 2 Sep 2020 11:10:45 +0000 Received: from localhost ([127.0.0.1]:58490 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kDQf7-0000s7-Bb for submit@debbugs.gnu.org; Wed, 02 Sep 2020 07:10:45 -0400 Received: from flashner.co.il ([178.62.234.194]:41796) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kDQf4-0000rs-Kc for 43159@debbugs.gnu.org; Wed, 02 Sep 2020 07:10:44 -0400 Received: from localhost (unknown [31.210.181.177]) by flashner.co.il (Postfix) with ESMTPSA id 7F6A3403E0; Wed, 2 Sep 2020 11:10:36 +0000 (UTC) Date: Wed, 2 Sep 2020 14:09:53 +0300 From: Efraim Flashner Message-ID: <20200902110953.GB24305@E5400> References: <20200901203520.21103-1-ludo@gnu.org> <20200902080622.GI856@E5400> <87a6y87bja.fsf@gnu.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="NtwzykIc2mflq5ck" Content-Disposition: inline In-Reply-To: <87a6y87bja.fsf@gnu.org> X-PGP-Key-ID: 0x41AAE7DCCA3D8351 X-PGP-Key: https://flashner.co.il/~efraim/efraim_flashner.asc X-PGP-Fingerprint: A28B F40C 3E55 1372 662D 14F7 41AA E7DC CA3D 8351 X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Spam-Score: -1.0 (-) 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: -2.61 X-TUID: VlEK3CrqSWIT --NtwzykIc2mflq5ck Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Sep 02, 2020 at 11:50:17AM +0200, Ludovic Court=C3=A8s wrote: > Hi, >=20 > Efraim Flashner skribis: >=20 > > 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 = command. > >> 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). >=20 > Yeah, I=E2=80=99m ambivalent about this as well. >=20 > > Before bikeshedding about where the options should be, how about: > > commands for developers -> commands related to building >=20 > Rather, =E2=80=9Ccommands for development=E2=80=9C, because that=E2=80=99= s really what =E2=80=98guix > environment=E2=80=99 is about, for instance, but saying =E2=80=98developm= ent=E2=80=99 rather > than =E2=80=98developers=E2=80=99 is probably wise. >=20 > > advanced usage -> commands related to verification >=20 > Well that only works for =E2=80=98challenge=E2=80=99 (which I=E2=80=99d l= ike to put in the hands > of =E2=80=98normal=E2=80=99 users, so I=E2=80=99m not comfortable with th= e =E2=80=98advanced=E2=80=99 label, but > OTOH, it=E2=80=99s clearly not one of the commands you=E2=80=99d begin wi= th.) >=20 > What about archive, copy, download, etc.? >=20 It seemed loosely related. If you're running 'guix pull; guix upgrade' you're not first running 'guix download https://path/to/source.tar.xz' or copying packages between machines or challenging the reproducibility of the packages. That's for after you have the packages you want in your profile or environment. > > This way they're still "commands for everybody" and they're more > > descriptive than just "advanced" "expert" and "debug" style headers. >=20 > Understood. >=20 > Thanks for your feedback! >=20 > Ludo=E2=80=99. --=20 Efraim Flashner =D7=90=D7=A4=D7=A8=D7=99=D7=9D = =D7=A4=D7=9C=D7=A9=D7=A0=D7=A8 GPG key =3D A28B F40C 3E55 1372 662D 14F7 41AA E7DC CA3D 8351 Confidentiality cannot be guaranteed on emails sent or received unencrypted --NtwzykIc2mflq5ck Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCgAdFiEEoov0DD5VE3JmLRT3Qarn3Mo9g1EFAl9PfXwACgkQQarn3Mo9 g1HJjQ//Z2rWEJhi8x0bG4hr0TZ6wQHuRkMaXBAh3SypSk3QEmn6LeGC96qBDnh1 N2oVpg519U5lVkOsnbwQWy8XiKq72Itd04+DE07mfoqn3JpzaVRdQz2Mc+l0MOZM A2/ZqO1Ikw5GinoPnq441WlI+XkkbN4tB0pdeNv83P4QTv1AIZIq4fj6SLCRi41D k61l7mcUUEjniLniUmFQOi6ge7e6iscgs6j/cG2oL6dvH0cL/LNAnz4aQ877DswA Pop2anp3MzPrK1EMKpuUfIu9cKI2C8i1kNByGGvdBnCA6yr31Sfd9wCa8/qQf/6i sfsb3CAxjp2fJL4Q5hEGQ73kR0r5mfgwbw35wAVMF0hA4p8VOCIiiO5n5nOqZLGh k6ylLE4wY7KPgDAo2zZRrFb+NM5SKFwpZlYI/l1/lkeGBL0DVKcnRy/NDpjGrqnO Ee2C2jeCyQrIbZaZvPbLoXRA3bR99A2i5tvVDSp5bFXHug7fi8fqWwiW/RiwPxef LaAnfgLXQMck2iUG8YCeMuz2acRaPctYItPIuYdU1ci5VIVzM6Y0O5aynWQBaDvR gYH2Z189p98/ye+dkGNPdx7wX8yAwrtW2Ef740qmWouc4T14g8iPY76MfelzBe9O QeFGpl04RRweZgFgeGD4woFrCkZP3DGt58VLwIusav3Zveg1Dgk= =iORf -----END PGP SIGNATURE----- --NtwzykIc2mflq5ck--