From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id SK5jFEZxWGfFbgEAe85BDQ:P1 (envelope-from ) for ; Tue, 10 Dec 2024 16:50:14 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id SK5jFEZxWGfFbgEAe85BDQ (envelope-from ) for ; Tue, 10 Dec 2024 17:50:14 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=Gsr1tgm1; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1733849414; a=rsa-sha256; cv=none; b=uBIe5nJMKsEzrifotRZqo7thsJmkZs46REwLpv3ph8fpChNFmDl1Ucb8mL3l909k7B3cdg ia+Y/+QBAh+ObwrsYuJUMsBxSVM2DhvZAUzl7jpq/XiWmFL1xasCRUJN7m7jKtivQOVoDD Ot+k4utZg/Gn2Rl4NXkEBwEGt5PPUjFyIkuVmKNybVynFoh+diQ9uqG1PNd0hW2DDAkr1t cZ1Q+q6J25c13DhhquUb/lZD+uY6uKBh1ah/c/iHY7N5CzUwYY8+L0hbaY/2XGP6x60svl NNGqOirCVl+xHYwNVRAkuaWq9PckTR0bMvUV+cS5LtdmT0Ph0VqAOTT4xTxL6Q== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=Gsr1tgm1; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1733849414; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=GoBor/c/pRZ5pW/aTFmBtZ7FcjPOLFpAzT1hVYCmbgw=; b=Ufva0GXmCUmh68UN3pgp6Y6a36eYEdr87AnmAV9PauxDMkx4cBKHj6AN+NVIiC4T6OuVyR xhQmDaTAUQY5bozPIye7zT6DpuHJjRpB4wEljWY3D57RQSRocTnteVKgKAdXhzqVd4EOga aKaSyQwDRLUm+1V68byRfpr6hkyz5XFcpOc2Z48Z3YwLYUWh5q/5cYSYq/9Ph0Ut1kOIeN pXWeh+YJztclxveIXSpglx2dqCvckIOb6yQAlY2KoG9WGoIRqNaG1XzPgPr3Ox5VTO/gkm a9Mrsp22lRamAktfGN81q5OikZKfEDFYkTsMYMFegfg2DsT88c//+/DjTMaEAg== 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 36F1663DA0 for ; Tue, 10 Dec 2024 17:50:14 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tL3Qz-0001Fg-46; Tue, 10 Dec 2024 11:50:05 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tL3Qu-00019i-UP for guix-devel@gnu.org; Tue, 10 Dec 2024 11:50:01 -0500 Received: from mail-wm1-x331.google.com ([2a00:1450:4864:20::331]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tL3Qt-0003tw-Fg for guix-devel@gnu.org; Tue, 10 Dec 2024 11:50:00 -0500 Received: by mail-wm1-x331.google.com with SMTP id 5b1f17b1804b1-434a742481aso51979515e9.3 for ; Tue, 10 Dec 2024 08:49:59 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1733849398; x=1734454198; darn=gnu.org; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=GoBor/c/pRZ5pW/aTFmBtZ7FcjPOLFpAzT1hVYCmbgw=; b=Gsr1tgm1L+oe+kgIMVpyaFP3T/3dymziRoys3XDEW6r7tRBZSWhy7hvURV2tljGWwh AsdcgLDPZuwI14VgW505rd/pXazrG3LeJkkUsBb7lbhBWdQ3J+bzYFe3/QwMbg729qzD j+9euW/0kMJjjCE+GaDD40q0HfLLoA7iZThuCNonm8HLZ0F/POB+umIiGbh6b+WcPkKH vT/Q9ZNr+7EIeMPcNDV54hLDtPlHSJafY1A1RuJpdwBxKJPpmtaL3U2Yh2E5zniYqdlM +HzIlhd69TxPpfAlnML462asqUHvxZzUPlZNYUbnr1axYBB/sAGPHVntxFok2PbTFwXx ph8w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1733849398; x=1734454198; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:to:from:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to; bh=GoBor/c/pRZ5pW/aTFmBtZ7FcjPOLFpAzT1hVYCmbgw=; b=epRyNuLRzbUYBhAjYH63q2r5hChOYnL8RzDf+5YBESKQLPJq73L7VTaih1zVmJYIsl 72gQRDdMf8aOooVtWzfMfkUfQLZ6w+kfZ3siRz6FKxJNbH/MJVUSDVuK6CjWiYijQMzf xeGyemlOIqsa7gEvfxIzr1tDKweN0w2KyRAWITwmyEnmQhroTEHAaylZS6TqdP+2+bjl BzKV5XCaq/Mom9FBYg4oVxILacdvaaimx7v2juY8K/6MpypfIoLhP8vAmmViQO4U76hp l5ujPk2vulZErCoejsuUAbZ+D0JB8VkSXevhINOxZoXIVgGAXtGslseRNV76X4r1lrQQ vytg== X-Forwarded-Encrypted: i=1; AJvYcCUdJDAPwtc56bj8USbQQhzPLBmhYriTT4PeksIP6C9dh3i2SmNt1GAMkgQ+EX2FIUcNEu30XEZ4+FMJ@gnu.org X-Gm-Message-State: AOJu0Yysux/ZrTHFZxtAmjcNlVTpBIXBqDmzBu3+BDMXbA9UG1N3Sm2M rKVnxaeONkkvmSDFXXj8AhKUND8dvsWoljAweM6NNNCD8utcl9lpYFiuHg== X-Gm-Gg: ASbGncv6wm0uck9EhQf7R7woWhy0Bqzg5DXIO05Fykm7e3BAVC1cR56z/o3xP8vYSGi GQwh5h1FvNAS5RrFnrh8MSFtNRH7kY8Llncl8BF2OJnYVvi8yagbvuewcjTAo5TzXEV6i0Umy+o WB+QAu2CS57KU2kUHes+L4iZ2beUHwSycMS+W39ciEf7uXqaLzmRQkOzVoMgUzgjTBcOm//449h PZfeTgdTVR4AZsJk0YUmtm0raaNZuPcirqXGDMBcg+1DoqKBg== X-Google-Smtp-Source: AGHT+IEax4iU0fYmJtA316cYcEuindcCqdqZ/VJo5Giw2jGsfWRhKQKTgyjTqVviofXIH+mb2CdpAA== X-Received: by 2002:a05:600c:4fc9:b0:42f:7e87:3438 with SMTP id 5b1f17b1804b1-434dde6b9d3mr158578955e9.0.1733849397960; Tue, 10 Dec 2024 08:49:57 -0800 (PST) Received: from lili ([148.60.59.223]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4350159f6a4sm38678315e9.21.2024.12.10.08.49.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 10 Dec 2024 08:49:57 -0800 (PST) From: Simon Tournier To: Ricardo Wurmus , guix-devel@gnu.org Subject: Re: Unhelpful "--help" output In-Reply-To: <877c98egqi.fsf@elephly.net> References: <877c98egqi.fsf@elephly.net> Date: Tue, 10 Dec 2024 17:44:34 +0100 Message-ID: <87a5d3xzbh.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2a00:1450:4864:20::331; envelope-from=zimon.toutoune@gmail.com; helo=mail-wm1-x331.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: guix-devel-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -1.50 X-Spam-Score: -1.50 X-Migadu-Queue-Id: 36F1663DA0 X-Migadu-Scanner: mx12.migadu.com X-TUID: K5S0hjPg6NeP Hi Ricardo, On Tue, 12 Nov 2024 at 14:14, Ricardo Wurmus wrote: > Note that this is the same output as for "guix system --help". Yes, that=E2=80=99s because the command-line parser is poorly implemented. = :-) > - In the case of commands that offer sub-commands, remove *all* the > options from the help output of the main command (e.g. "guix system > --help"), and only showing the list of available sub-commands. Yes. Well, let start with =E2=80=9Cguix system=E2=80=9D. :-) > - For "guix [command] [sub-command] --help" show only options to this > sub-command. Yes. > - optionally, group all generic options (e.g. --system, --help, > --version, etc) under a single heading. Yes. It appears to me the easiest. ;-) Cheers, simon PS: I think it might be an =E2=80=9Ceasy=E2=80=9D contribution for Google S= ummer of Code candidate=E2=80=A6 But maybe it could be nice to improve before the ne= xt round.