From debbugs-submit-bounces@debbugs.gnu.org Wed Sep 02 07:10:45 2020 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 To: Ludovic =?utf-8?Q?Court=C3=A8s?= Subject: Re: [bug#43159] [PATCH 0/2] Make 'guix help' helpful 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-Debbugs-Envelope-To: 43159 Cc: 43159@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --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--