From patchwork Mon Nov 15 13:10:20 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rostislav Svoboda X-Patchwork-Id: 34497 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 04C5627BBE3; Mon, 15 Nov 2021 14:26:42 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H2, SPF_HELO_PASS,T_DKIM_INVALID autolearn=unavailable autolearn_force=no version=3.4.2 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 9445627BBE1 for ; Mon, 15 Nov 2021 14:26:41 +0000 (GMT) Received: from localhost ([::1]:43128 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mmcwS-0003i9-Hq for patchwork@mira.cbaines.net; Mon, 15 Nov 2021 09:26:40 -0500 Received: from eggs.gnu.org ([209.51.188.92]:56534) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mmblG-0001Fl-Jk for guix-patches@gnu.org; Mon, 15 Nov 2021 08:11:02 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:41407) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mmblG-00082v-AS for guix-patches@gnu.org; Mon, 15 Nov 2021 08:11:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mmblG-0007UO-6G for guix-patches@gnu.org; Mon, 15 Nov 2021 08:11:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#51868] [PATCH] doc: Improve wording for param spec of `./configure`. Resent-From: Rostislav Svoboda Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 15 Nov 2021 13:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 51868 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 51868@debbugs.gnu.org Cc: Rostislav Svoboda X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.163698184928763 (code B ref -1); Mon, 15 Nov 2021 13:11:02 +0000 Received: (at submit) by debbugs.gnu.org; 15 Nov 2021 13:10:49 +0000 Received: from localhost ([127.0.0.1]:52953 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mmbl3-0007Tq-Kd for submit@debbugs.gnu.org; Mon, 15 Nov 2021 08:10:49 -0500 Received: from lists.gnu.org ([209.51.188.17]:57442) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mmbl1-0007Tg-WE for submit@debbugs.gnu.org; Mon, 15 Nov 2021 08:10:48 -0500 Received: from eggs.gnu.org ([209.51.188.92]:56452) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mmbl0-0000oB-Sc for guix-patches@gnu.org; Mon, 15 Nov 2021 08:10:46 -0500 Received: from [2a00:1450:4864:20::336] (port=44967 helo=mail-wm1-x336.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mmbkt-0007yX-I9 for guix-patches@gnu.org; Mon, 15 Nov 2021 08:10:46 -0500 Received: by mail-wm1-x336.google.com with SMTP id c71-20020a1c9a4a000000b0032cdcc8cbafso12412938wme.3 for ; Mon, 15 Nov 2021 05:10:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=MKEluG4TMQk9Tb11mFyorxA9B5nyl31PoBFakj6jwfo=; b=KPV8nAgP6e5whLfD3NPkoNlAlQweBniVeBIGXE9VRveUsdkjJrQ7/FsOD61B2ul3SV x0HjqT4Nk9xV9qMl/lP2D2a98KiP7/mJrEw9Z+MQCuFoU4A/W1R5UUCfNYePS7aZDSNM 7VyHoqS8CeR5jUFtBHTpEGdjKekZg9h3+4z9YNkcVt6VK3ufwj5WqnlgR9RdWl2Qr9gE YS5Ki9X7er+KL3EYXfLq6t4Wh7MS9NcgEol5Z4cJBhyBgJGOC8B4hcdAU89hkGwCFw4D Xc07kuiKMVXMDAAXLZTkpeyccmqnti1e3Q0Lqso4Q1tJUpS0bobwg4Fr876e0a3R3nA3 lGYQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=MKEluG4TMQk9Tb11mFyorxA9B5nyl31PoBFakj6jwfo=; b=DthZnGhZ9v4LVWQmOeKTFYyTcmAtUZMVl+HPMzIAQggFsaroghjKCJ+0GUvLGvVgXU lEAH36hno04E4wwgXaDvATZEnTVOoK77dQykdVmbGSfvtCKi7/sGXlRRatO2ke8trsrV 14bdxUOJWCqedJIvscf8otnURhQNcDMgeteIpFHDw7IOEdhZqyslLjxArEsk7LEc/foW b8kWmFSWBcMpTMwrvDY3YoCrj8+2c0VY5LDwOzhb00V3+IMLVyolOfyvg/4svodmPDyo 8rCxwsy01jhZGNt4p3olfOFCk854sjzzd+HPahdgNc5nx7l3YHKHoHSFZ/bV/k2GLWN/ LKFw== X-Gm-Message-State: AOAM530Hg2sGBPBqvSzwgCAwrz9udgBR2uqYNN/Hz88uZRzF0SQiDOIJ VZsjDAlBalbTFi4x8k6y7uOJkG7ZGF4= X-Google-Smtp-Source: ABdhPJwcCSx5d9FgCbAYXTnt0AUgCsr8Bw+27u2nBJjHlNMLF7oynpBULbwzmhifdylm3Zd9bH0bpA== X-Received: by 2002:a05:600c:3505:: with SMTP id h5mr58561394wmq.22.1636981835986; Mon, 15 Nov 2021 05:10:35 -0800 (PST) Received: from ecke.fritz.box (x4db62eb5.dyn.telefonica.de. [77.182.46.181]) by smtp.googlemail.com with ESMTPSA id f3sm19578645wmb.12.2021.11.15.05.10.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 15 Nov 2021 05:10:35 -0800 (PST) From: Rostislav Svoboda X-Google-Original-From: Rostislav Svoboda Date: Mon, 15 Nov 2021 14:10:20 +0100 Message-Id: <20211115131019.13656-1-Rostislav.Svoboda@gmail.com> X-Mailer: git-send-email 2.33.1 MIME-Version: 1.0 X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a00:1450:4864:20::336 (failed) Received-SPF: pass client-ip=2a00:1450:4864:20::336; envelope-from=rostislav.svoboda@gmail.com; helo=mail-wm1-x336.google.com X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 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, PDS_HP_HELO_NORDNS=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, SPF_PASS=-0.001, T_SPF_HELO_TEMPERROR=0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Mailman-Approved-At: Mon, 15 Nov 2021 09:26:25 -0500 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" X-getmail-retrieved-from-mailbox: Patches * doc/contributing.texi (Running Guix Before It Is Installed): Writing "Do . But it won't work unless ..." is a bad practice. --- doc/contributing.texi | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index db0f836157..aa6bfc2e65 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -120,12 +120,12 @@ Building from Git @xref{Macro Search Path,,, automake, The GNU Automake Manual}, for more information. -Then, run @command{./configure} as usual. Make sure to pass -@code{--localstatedir=@var{directory}} where @var{directory} is the -@code{localstatedir} value used by your current installation (@pxref{The -Store}, for information about this), usually @file{/var}. Note that you -will probably not run @command{make install} at the end (you don't have -to) but it's still important to pass the right @code{localstatedir}. +Then, run @command{./configure --localstatedir=@var{directory}}, where +@var{directory} is the @code{localstatedir} value used by your current +installation (@pxref{The Store}, for information about this), usually +@file{/var}. Note that you will probably not run @command{make install} +at the end (you don't have to) but it's still important to pass the +right @code{localstatedir}. Finally, you have to invoke @code{make && make check} to build Guix and run the tests (@pxref{Running the Test Suite}). If anything fails, take