From patchwork Thu Apr 17 22:04:43 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: nomike X-Patchwork-Id: 41750 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 79FA927BC4A; Thu, 17 Apr 2025 23:09:31 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-6.4 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,MAILING_LIST_MULTI,RCVD_IN_DNSWL_BLOCKED, RCVD_IN_VALIDITY_CERTIFIED,RCVD_IN_VALIDITY_RPBL,RCVD_IN_VALIDITY_SAFE, SPF_HELO_PASS,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 788D727BC49 for ; Thu, 17 Apr 2025 23:09:29 +0100 (BST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1u5XPw-0003pw-C7; Thu, 17 Apr 2025 18:09:08 -0400 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 1u5XPu-0003pb-IX for guix-patches@gnu.org; Thu, 17 Apr 2025 18:09:06 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1u5XPu-0007R9-1l for guix-patches@gnu.org; Thu, 17 Apr 2025 18:09:06 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:From:To:Subject; bh=bBHF5SNWfob5JmHKXqWLpzgDQ5oUr9QM3aWWW2C9qYg=; b=XS6/xwIMtPI27ck0l0allhBYeT7cOHdlcRbvXTYRjcCndRpKwUn+AHC1AGx4ZXtzBAj80p07jfQWVx+6eTMF3z+IQnQMAfP8QbtsxU6wypSe5hHrYbUEdmRRwebTyvuMYYYyOSxNAiddyEDe+vDm4BeFufhHzDlBbZBOKmsBSSwraGS2mjULG2fS+5tIc2rNRdYT0HqvuDf08d7PIan7R+gZbOZMi7zlVnT22LjS5dxTYGLrspBBnUIBSsDeHk76vFyx2R9xDIm22aeOgZmkBMWvZOe+WV2vIjatR6DMGMFPgH4nYzjkVav3BWva2hGKFxJ6H1mZDGQO2f5EiIeK1A==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1u5XPt-0000y1-RB for guix-patches@gnu.org; Thu, 17 Apr 2025 18:09:05 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#77879] [PATCH] doc: contributing: Use long options as they are easier to understand. Resent-From: nomike Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 17 Apr 2025 22:09:05 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 77879 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 77879@debbugs.gnu.org Cc: nomike X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.17449277293549 (code B ref -1); Thu, 17 Apr 2025 22:09:05 +0000 Received: (at submit) by debbugs.gnu.org; 17 Apr 2025 22:08:49 +0000 Received: from localhost ([127.0.0.1]:48761 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u5XPa-0000uu-Ni for submit@debbugs.gnu.org; Thu, 17 Apr 2025 18:08:48 -0400 Received: from lists.gnu.org ([2001:470:142::17]:45550) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u5XPX-0000t7-8t for submit@debbugs.gnu.org; Thu, 17 Apr 2025 18:08:44 -0400 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 1u5XPR-0003mc-LC for guix-patches@gnu.org; Thu, 17 Apr 2025 18:08:37 -0400 Received: from iguana.tulip.relay.mailchannels.net ([23.83.218.253]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1u5XPP-0007O9-VB for guix-patches@gnu.org; Thu, 17 Apr 2025 18:08:37 -0400 X-Sender-Id: dreamhost|x-authsender|nomike@nomike.com Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id 9A47B160B36; Thu, 17 Apr 2025 22:08:33 +0000 (UTC) Received: from pdx1-sub0-mail-a254.dreamhost.com (100-107-106-146.trex-nlb.outbound.svc.cluster.local [100.107.106.146]) (Authenticated sender: dreamhost) by relay.mailchannels.net (Postfix) with ESMTPA id 370D7160F59; Thu, 17 Apr 2025 22:08:33 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1744927713; a=rsa-sha256; cv=none; b=RA5iCLLWToaje/hXEYJtWBPh9OM758q++y5CB1z/dxD1xXxm611A4uztNw7G0Pz5FNJ5T6 2B1h8eHxOCdD1e4fpXVPkwsL8J5UVKMbE0QWko6qSISlRPZ7JL9K7JBoCe6jgthD3ncos3 GuvuI3B2EnPOOniprXAf11wa8Gs6CperHZOK7akEhcU5oVFO5WEUJcuJLOIXQFzHuuHosL JaoywukymxXoH6RHnc5hD2aKoMSO5QSVUHxfV7TH8ar9KrZdY6SnKmO/jLfzGjHV6QGbR4 XW2O8Co6PjbF3j8Gub4xkk5u/yFw4wmCwj62GSNWgXz3TbNkX/XBrXc3sk5M6Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1744927713; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding:dkim-signature; bh=bBHF5SNWfob5JmHKXqWLpzgDQ5oUr9QM3aWWW2C9qYg=; b=QSsXn157MveVXCtb7OnBy/Fd3UzwPx+CjaYLPSd9WI1q3s6xR4Kp6zeAdL1Ey/j2mzxi0O U1hrA8EHpfaS8ZJH82jk0BRzfMJbMFRhDvS7ian7ROEVGuGbl3xNaEe5qcfUBr55Pi3kWn YpjiqvkfujpnaI/XAbjYk8CxLXClTvDfaqW8lW66WGX9Xtr7BNzJi2EnTTqMFAiwXllOak FsKOS4OHqCBoNTgXnSpzsNI/eu/D+viO5JXaxxk5oEDJqx+uNeyBPycy3uATpocZD6C9xM 1VLXL6Jtze83utHVsgqEixlAlEP3DKiBHZ3y+RbvPy4ssArcBe/xQnYsX1GqBw== ARC-Authentication-Results: i=1; rspamd-7bd9ff6c58-nbb74; auth=pass smtp.auth=dreamhost smtp.mailfrom=nomike@nomike.com X-Sender-Id: dreamhost|x-authsender|nomike@nomike.com X-MC-Relay: Neutral X-MailChannels-SenderId: dreamhost|x-authsender|nomike@nomike.com X-MailChannels-Auth-Id: dreamhost X-Spicy-Broad: 18c18b070edb7fe2_1744927713431_2082856923 X-MC-Loop-Signature: 1744927713431:324650716 X-MC-Ingress-Time: 1744927713431 Received: from pdx1-sub0-mail-a254.dreamhost.com (pop.dreamhost.com [64.90.62.162]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.107.106.146 (trex/7.0.3); Thu, 17 Apr 2025 22:08:33 +0000 Received: from localhost (84-112-221-106.cable.dynamic.surfer.at [84.112.221.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: nomike@nomike.com) by pdx1-sub0-mail-a254.dreamhost.com (Postfix) with ESMTPSA id 4ZdsV85HTszCg; Thu, 17 Apr 2025 15:08:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nomike.com; s=dreamhost; t=1744927713; bh=bBHF5SNWfob5JmHKXqWLpzgDQ5oUr9QM3aWWW2C9qYg=; h=From:To:Cc:Subject:Date:Content-Transfer-Encoding; b=Q9fXvG6ge4By9TNp6tsBPT9C42m0hiJOd62qV2ttipPSForbCj+TylRMqYzmjL8YJ EFJhqOSF0WPWrRR4Wv7RCuR6EJyEZrikUlytTatbBm48Rb4jMQntT8ZkoJGMIWSWHd Cx5SyEc2dfHRXQwj7qmlaj69Fz3J3BAhdE0OKye8nCkb88N2v3eB0HJ2kaapPC6ZTA rUTOb9q8JKUiRTaVf748mCmuacALqAmBN4cxW18MevIxIF/QQCPGZu08ct6kZNLrTL ppQ2esSTYAQm27izGENGDcSLG78Gb+nMQv5Yda+2K9S5qKvieO/aRmGXRba5stdO8y UgZgakhqOr0+A== From: nomike Date: Fri, 18 Apr 2025 00:04:43 +0200 Message-ID: <20250417220818.2141183-1-nomike@nomike.com> X-Mailer: git-send-email 2.49.0 MIME-Version: 1.0 Received-SPF: pass client-ip=23.83.218.253; envelope-from=nomike@nomike.com; helo=iguana.tulip.relay.mailchannels.net 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, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches Change-Id: Id58d84cb9eef17e29f67ce957f07756287f87471 --- Especially for newbies it's much easiet to understand what's happening when long options are used. They are easier to remember and easier to lookup in the documentation as well. doc/contributing.texi | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index ab4f30d54b..b9559d41b5 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -171,17 +171,17 @@ all the dependencies and appropriate environment variables are set up to hack on Guix: @example -guix shell -D guix -CPW +guix shell --development guix --container --link-profile --nesting @end example or even, from within a Git worktree for Guix: @example -guix shell -CPW +guix shell --container --link-profile --nesting @end example -If @option{-C} (short for @option{--container}) is not supported on your -system, try @command{--pure} instead of @option{-CPW}. +If @option{--container} is not supported on your +system, try @command{--pure} instead of @option{--container --link-profile --nesting}. @xref{Invoking guix shell}, for more information on that command. If you are unable to use Guix when building Guix from a checkout, the