From debbugs-submit-bounces@debbugs.gnu.org Mon Nov 01 01:30:46 2021 Received: (at submit) by debbugs.gnu.org; 1 Nov 2021 05:30:47 +0000 Received: from localhost ([127.0.0.1]:33536 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mhPuA-00005d-Bv for submit@debbugs.gnu.org; Mon, 01 Nov 2021 01:30:46 -0400 Received: from lists.gnu.org ([209.51.188.17]:33648) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mhKgh-00085i-2X for submit@debbugs.gnu.org; Sun, 31 Oct 2021 19:56:31 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:59116) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mhKgg-0001sx-Qt for guix-patches@gnu.org; Sun, 31 Oct 2021 19:56:30 -0400 Received: from mail-0301.mail-europe.com ([188.165.51.139]:37335) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mhKge-0002up-CP for guix-patches@gnu.org; Sun, 31 Oct 2021 19:56:30 -0400 Date: Sun, 31 Oct 2021 23:56:13 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail; t=1635724574; bh=ij0Ar8lk5XBTGUH5at4yfzTJE1bXVlB8I4WVwQDsL04=; h=Date:To:From:Reply-To:Subject:From; b=JPy4CQRFfRORSIcye+Yfrh0QYT731iJZxHVBwStMZk5w1qweiZk3Vc4Zspis+2Mvj vE4fpDcTDnsSz15XgVEZCmezrJCG+VPrenhq6Uw+aI3bLzaKvxWZX4fqRwpitlbSdS /d3/FkErtk45NnKLnILj2P8/9HsEJPg+oIpFAyH8= To: "guix-patches@gnu.org" From: Disseminate Dissent Subject: First Patch Submit Ever: Additions to the Cookbook Documentation Message-ID: MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="b1_OtZv9Dpu3E1F1q381IRna7jRWJgTCqHHxu45GlSigM" X-Spam-Status: No, score=-1.2 required=10.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,HTML_MESSAGE shortcircuit=no autolearn=disabled version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on mailout.protonmail.ch Received-SPF: pass client-ip=188.165.51.139; envelope-from=disseminatedissent@protonmail.com; helo=mail-0301.mail-europe.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, HTML_MESSAGE=0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Mon, 01 Nov 2021 01:30:44 -0400 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: , Reply-To: Disseminate Dissent Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) This is a multi-part message in MIME format. --b1_OtZv9Dpu3E1F1q381IRna7jRWJgTCqHHxu45GlSigM Content-Type: multipart/alternative; boundary="b2_OtZv9Dpu3E1F1q381IRna7jRWJgTCqHHxu45GlSigM" --b2_OtZv9Dpu3E1F1q381IRna7jRWJgTCqHHxu45GlSigM Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: base64 SGV5IHRoZXJlLCB0YWtpbmcgbXkgZmlyc3Qgc3RlcCBpbnRvIGEgbGFyZ2VyIHdvcmxkLgoKQXR0 YWNoZWQgaXMganVzdCBhIHBhdGNoIHRvIHRoZSBHTlUgR3VpeCBDb29rYm9vayB0aGF0IGFkZHMg YSBGQVEgd2l0aCBpdCdzIGZpcnN0IGVudHJ5LiBUaGUgVG9DIHdpbGwgbmVlZCB0byBiZSBlZGl0 ZWQgaW4gb3JkZXIgdG8gcmVmbGVjdCB0aGF0IHRob3VnaC4KClBlYWNlLApEaXNzZW50 --b2_OtZv9Dpu3E1F1q381IRna7jRWJgTCqHHxu45GlSigM Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: base64 PGRpdj5IZXkgdGhlcmUsIHRha2luZyBteSBmaXJzdCBzdGVwIGludG8gYSBsYXJnZXIgd29ybGQu PGJyPjwvZGl2PjxkaXY+PGJyPjwvZGl2PjxkaXY+QXR0YWNoZWQgaXMganVzdCBhIHBhdGNoIHRv IHRoZSBHTlUgR3VpeCBDb29rYm9vayB0aGF0IGFkZHMgYSBGQVEgd2l0aCBpdCdzIGZpcnN0IGVu dHJ5LiBUaGUgVG9DIHdpbGwgbmVlZCB0byBiZSBlZGl0ZWQgaW4gb3JkZXIgdG8gcmVmbGVjdCB0 aGF0IHRob3VnaC48YnI+PC9kaXY+PGRpdj48YnI+PC9kaXY+PGRpdj5QZWFjZSw8YnI+PC9kaXY+ PGRpdj5EaXNzZW50PGJyPjwvZGl2Pg== --b2_OtZv9Dpu3E1F1q381IRna7jRWJgTCqHHxu45GlSigM-- --b1_OtZv9Dpu3E1F1q381IRna7jRWJgTCqHHxu45GlSigM Content-Type: text/x-patch; name=0001-doc-Added-FAQ-section-with-entry-on-using-clear.patch Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename=0001-doc-Added-FAQ-section-with-entry-on-using-clear.patch RnJvbSA5YWYyNWViZGUzYmFhYTc2YjI4YmJkZTk3YmM0ODY0MDQ3NjkxMWY1IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBkaXNzZW50IDxkaXNzZW1pbmF0ZWRpc3NlbnRAcHJvdG9ubWFp bC5jb20+CkRhdGU6IFNhdCwgMzAgT2N0IDIwMjEgMTc6MDA6MDIgLTA0MDAKU3ViamVjdDogW1BB VENIXSBkb2M6IEFkZGVkIEZBUSBzZWN0aW9uIHdpdGggZW50cnkgb24gdXNpbmcgY2xlYXIuCgoq IGRvYy9ndWl4LWNvb2tib29rLnRleGk6IEFkZGVkIEZBUSBzZWN0aW9uLgotLS0KIGRvYy9ndWl4 LWNvb2tib29rLnRleGkgfCAxNSArKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCAxNSBp bnNlcnRpb25zKCspCgpkaWZmIC0tZ2l0IGEvZG9jL2d1aXgtY29va2Jvb2sudGV4aSBiL2RvYy9n dWl4LWNvb2tib29rLnRleGkKaW5kZXggZGM1MmY2ZDM4Yy4uYmRiZjgzZjkwMCAxMDA2NDQKLS0t IGEvZG9jL2d1aXgtY29va2Jvb2sudGV4aQorKysgYi9kb2MvZ3VpeC1jb29rYm9vay50ZXhpCkBA IC0yOTY0LDYgKzI5NjQsMjEgQEAgd2lsbCBoYXZlIHByZWRlZmluZWQgZW52aXJvbm1lbnQgdmFy aWFibGVzIGFuZCBwcm9jZWR1cmVzLgogCiBSdW4gQGNvbW1hbmR7ZGlyZW52IGFsbG93fSB0byBz ZXR1cCB0aGUgZW52aXJvbm1lbnQgZm9yIHRoZSBmaXJzdCB0aW1lLgogCitAYyAqKioqKioqKioq KioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioq KioKK0Bub2RlIEZBUQorQGNoYXB0ZXIgRkFRCisKK1RoaXMgY2hhcHRlciBjb2xsZWN0cyBzb21l IGZyZXF1ZW50bHkgYXNrZWQgcXVlc3Rpb25zIHRoYXQgbWlnaHQgYXJpc2UgZm9yIG5ldyB1c2Vy cy4KKworQG1lbnUKKyogSG93IGRvIEkgY2xlYXIgbXkgdGVybWluYWwgc2NyZWVuPworQGVuZCBt ZW51CisKK0Bub2RlIEhvdyBkbyBJIGNsZWFyIG15IHRlcm1pbmFsIHNjcmVlbj8KK0BzZWN0aW9u IEhvdyBkbyBJIGNsZWFyIG15IHRlcm1pbmFsIHNjcmVlbj8KKworVGhlIEBjb21tYW5ke2NsZWFy fSBjb21tYW5kIGlzIGZvdW5kIGluIHRoZSBAY29tbWFuZHtuY3Vyc2VzfSBwYWNrYWdlLiAKKwog QGMgKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioq KioqKioqKioqKioqKioqCiBAbm9kZSBBY2tub3dsZWRnbWVudHMKIEBjaGFwdGVyIEFja25vd2xl ZGdtZW50cwotLSAKMi4yMC4xCgo= --b1_OtZv9Dpu3E1F1q381IRna7jRWJgTCqHHxu45GlSigM-- From debbugs-submit-bounces@debbugs.gnu.org Mon Nov 01 11:10:29 2021 Received: (at 51538) by debbugs.gnu.org; 1 Nov 2021 15:10:29 +0000 Received: from localhost ([127.0.0.1]:35869 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mhYx7-0005N1-Ez for submit@debbugs.gnu.org; Mon, 01 Nov 2021 11:10:29 -0400 Received: from mx1.dismail.de ([78.46.223.134]:41279) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mhYx4-0005Mk-LV for 51538@debbugs.gnu.org; Mon, 01 Nov 2021 11:10:23 -0400 Received: from mx1.dismail.de (localhost [127.0.0.1]) by mx1.dismail.de (OpenSMTPD) with ESMTP id bdb0733f for <51538@debbugs.gnu.org>; Mon, 1 Nov 2021 16:10:15 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=dismail.de; h=date :message-id:from:to:subject:references:mime-version:content-type :content-transfer-encoding; s=20190914; bh=+9vF9kg7HfJ/w1JZA/HrN x8uJLFC7PpCpNkSnDmk9fs=; b=IRMqGH0hS66XrGFRLnmKi6SFBRGMwfIux9ZG1 gH65XlPFmLvKtw/JWtKzcpPRPredvCp+xtg+T8HsOVLsa//xOheJqCQ8xRNdd2II z5gur2hTQ/9aAcLoYTrnKAKRQKPi1tUIfttn66p6VO/NyiZ3gnmqeuTHRcew0yAN NksD/pnl9n7m+rUP0tN/KgygdJPqZ5GwQ20h6hdbKJTtSTIK1AxxUjpigIcXvDZf gfb8WCuHPeuF0Mls7mKAZqgAsyDLvPS4P9hVfBz4RCk9+GwchFaV5VcinqWlZomh pifLfOLEMwVnEqO+gEHlzuneDAs5g+ZsJCUkzKyjDR5CilPxg== Received: from smtp2.dismail.de ( [10.240.26.12]) by mx1.dismail.de (OpenSMTPD) with ESMTP id 8e46233d for <51538@debbugs.gnu.org>; Mon, 1 Nov 2021 16:10:15 +0100 (CET) Received: from smtp2.dismail.de (localhost [127.0.0.1]) by smtp2.dismail.de (OpenSMTPD) with ESMTP id a8f988d5 for <51538@debbugs.gnu.org>; Mon, 1 Nov 2021 16:10:15 +0100 (CET) Received: by dismail.de (OpenSMTPD) with ESMTPSA id bc7d1b54 (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO) for <51538@debbugs.gnu.org>; Mon, 1 Nov 2021 16:10:14 +0100 (CET) Date: Mon, 1 Nov 2021 11:10:12 -0400 Message-ID: <20211101111012.GB4399@gac.attlocal.net> From: jgart To: 51538@debbugs.gnu.org Subject: TOC References: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 51538 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.7 (-) Hi Dissent, Great to see that you sent the patch that we worked on from the guix packaging meetup. To add more stuff to your commit I recommend the following workflow: 1. Make additional changes to the cookbook file. 2. guix shell texi2html -- texi2html doc/guix-cookbook.texi 3. Open and check the generated html file with your web browser. 4. git add doc/guix-cookbook.texi 5. git commit --amend --no-edit 6. git format-patch -1 7. email patch again to 51538@debbugs.gnu.org With the above workflow I recommend adding an entry in the TOC for the FAQ section. Note that `git format-patch -1` only takes the last commit so if you add more commits you'll need to adjust that command. `git commit --amend --no-edit` does not open your editor to modify your commit message. If you'd like to then remove `--no-edit`. Another guix contributor might prefer that section to be called something else or not so let's wait to hear from others. I don't have commit access so someone else will have to review your changes also and merge them. all best, jgart From debbugs-submit-bounces@debbugs.gnu.org Thu Nov 04 11:18:01 2021 Received: (at submit) by debbugs.gnu.org; 4 Nov 2021 15:18:01 +0000 Received: from localhost ([127.0.0.1]:43219 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mieV7-0005t2-CQ for submit@debbugs.gnu.org; Thu, 04 Nov 2021 11:18:01 -0400 Received: from lists.gnu.org ([209.51.188.17]:41136) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mieV5-0005sp-OW for submit@debbugs.gnu.org; Thu, 04 Nov 2021 11:18:00 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35728) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mieV5-00054X-KA for guix-patches@gnu.org; Thu, 04 Nov 2021 11:17:59 -0400 Received: from mail-4324.protonmail.ch ([185.70.43.24]:48163) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mieV1-0007rf-KT for guix-patches@gnu.org; Thu, 04 Nov 2021 11:17:59 -0400 Date: Thu, 04 Nov 2021 15:17:48 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail; t=1636039071; bh=uASVPM05k5sX+M8+upUNyv5iJs0QT9mMw3ili/sL/Gc=; h=Date:To:From:Reply-To:Subject:In-Reply-To:References:From; b=JsYKpelvWJQxEZPqu7ytIn18llv5XVOgQB81mqyojbcUH0eAklMCkrq9u+DDfJLw8 NhK1X2Zxk3ssDzHcebqDLsCen96+yMRSeSTst6USKkmdVm924NLd5/YeJuifcHoO2g ueNxSDds04kPjxsJpBQYWoaylXj2S9SnTZAxejUg= To: "guix-patches@gnu.org" From: Disseminate Dissent Subject: Re: First Patch Submit Ever: Additions to the Cookbook Documentation Message-ID: In-Reply-To: References: MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="b1_Xlo8ut5Luc9y10HyVTVjgpbJxnL66Xu3uE57RtosjI" X-Spam-Status: No, score=-1.2 required=10.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,HTML_MESSAGE shortcircuit=no autolearn=disabled version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on mailout.protonmail.ch Received-SPF: pass client-ip=185.70.43.24; envelope-from=disseminatedissent@protonmail.com; helo=mail-4324.protonmail.ch 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, HTML_MESSAGE=0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit 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: , Reply-To: Disseminate Dissent Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) This is a multi-part message in MIME format. --b1_Xlo8ut5Luc9y10HyVTVjgpbJxnL66Xu3uE57RtosjI Content-Type: multipart/alternative; boundary="b2_Xlo8ut5Luc9y10HyVTVjgpbJxnL66Xu3uE57RtosjI" --b2_Xlo8ut5Luc9y10HyVTVjgpbJxnL66Xu3uE57RtosjI Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: base64 Rml4ZWQgdGhlIHByZXZpb3VzIGNvbW1pdCBieSBhZGRpbmcgdGhlIGNvcnJlc3BvbmRpbmcgVG9D IGhlYWRpbmcgdG8gdGhlIG5ldyBGQVEgc2VjdGlvbi4KCkRpc3NlbWluYXRlLCBQZWFjZS4KCuKA kOKAkOKAkOKAkOKAkOKAkOKAkCBPcmlnaW5hbCBNZXNzYWdlIOKAkOKAkOKAkOKAkOKAkOKAkOKA kApPbiBTdW5kYXksIE9jdG9iZXIgMzFzdCwgMjAyMSBhdCAxMTo1NiBQTSwgRGlzc2VtaW5hdGUg RGlzc2VudCA8ZGlzc2VtaW5hdGVkaXNzZW50QHByb3Rvbm1haWwuY29tPiB3cm90ZToKCj4gSGV5 IHRoZXJlLCB0YWtpbmcgbXkgZmlyc3Qgc3RlcCBpbnRvIGEgbGFyZ2VyIHdvcmxkLgo+Cj4gQXR0 YWNoZWQgaXMganVzdCBhIHBhdGNoIHRvIHRoZSBHTlUgR3VpeCBDb29rYm9vayB0aGF0IGFkZHMg YSBGQVEgd2l0aCBpdCdzIGZpcnN0IGVudHJ5LiBUaGUgVG9DIHdpbGwgbmVlZCB0byBiZSBlZGl0 ZWQgaW4gb3JkZXIgdG8gcmVmbGVjdCB0aGF0IHRob3VnaC4KPgo+IFBlYWNlLAo+IERpc3NlbnQ= --b2_Xlo8ut5Luc9y10HyVTVjgpbJxnL66Xu3uE57RtosjI Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: base64 PGRpdiBzdHlsZT0iZm9udC1mYW1pbHk6IG1lbmxvLCBjb25zb2xhcywgY291cmllciBuZXcsIG1v bm9zcGFjZTsgZm9udC1zaXplOiAxNHB4OyI+PGRpdj5GaXhlZCB0aGUgcHJldmlvdXMgY29tbWl0 IGJ5IGFkZGluZyB0aGUgY29ycmVzcG9uZGluZyBUb0MgaGVhZGluZyB0byB0aGUgbmV3IEZBUSBz ZWN0aW9uLjxicj48L2Rpdj48ZGl2Pjxicj48L2Rpdj48ZGl2PkRpc3NlbWluYXRlLCBQZWFjZS48 YnI+PC9kaXY+PGRpdj48YnI+PC9kaXY+PC9kaXY+PGRpdj48YnI+PC9kaXY+PGRpdiBjbGFzcz0i cHJvdG9ubWFpbF9xdW90ZSI+DQogICAgICAgIOKAkOKAkOKAkOKAkOKAkOKAkOKAkCBPcmlnaW5h bCBNZXNzYWdlIOKAkOKAkOKAkOKAkOKAkOKAkOKAkDxicj4NCiAgICAgICAgT24gU3VuZGF5LCBP Y3RvYmVyIDMxc3QsIDIwMjEgYXQgMTE6NTYgUE0sIERpc3NlbWluYXRlIERpc3NlbnQgJmx0O2Rp c3NlbWluYXRlZGlzc2VudEBwcm90b25tYWlsLmNvbSZndDsgd3JvdGU6PGJyPg0KICAgICAgICA8 YmxvY2txdW90ZSBjbGFzcz0icHJvdG9ubWFpbF9xdW90ZSIgdHlwZT0iY2l0ZSI+DQogICAgICAg ICAgICA8ZGl2PkhleSB0aGVyZSwgdGFraW5nIG15IGZpcnN0IHN0ZXAgaW50byBhIGxhcmdlciB3 b3JsZC48YnI+PC9kaXY+PGRpdj48YnI+PC9kaXY+PGRpdj5BdHRhY2hlZCBpcyBqdXN0IGEgcGF0 Y2ggdG8gdGhlIEdOVSBHdWl4IENvb2tib29rIHRoYXQgYWRkcyBhIEZBUSB3aXRoIGl0J3MgZmly c3QgZW50cnkuIFRoZSBUb0Mgd2lsbCBuZWVkIHRvIGJlIGVkaXRlZCBpbiBvcmRlciB0byByZWZs ZWN0IHRoYXQgdGhvdWdoLjxicj48L2Rpdj48ZGl2Pjxicj48L2Rpdj48ZGl2PlBlYWNlLDxicj48 L2Rpdj48ZGl2PkRpc3NlbnQ8YnI+PC9kaXY+DQogICAgICAgIDwvYmxvY2txdW90ZT48YnI+DQog ICAgPC9kaXY+ --b2_Xlo8ut5Luc9y10HyVTVjgpbJxnL66Xu3uE57RtosjI-- --b1_Xlo8ut5Luc9y10HyVTVjgpbJxnL66Xu3uE57RtosjI Content-Type: text/x-patch; name=0001-doc-Added-FAQ-section-with-entry-on-using-clear.patch Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename=0001-doc-Added-FAQ-section-with-entry-on-using-clear.patch RnJvbSBmY2UyMzlhMzExNzI0ZTM4OTg3NjQwYWYwMjEyNzE3OWQ1NjlkODhlIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBkaXNzZW50IDxkaXNzZW1pbmF0ZWRpc3NlbnRAcHJvdG9ubWFp bC5jb20+CkRhdGU6IFNhdCwgMzAgT2N0IDIwMjEgMTc6MDA6MDIgLTA0MDAKU3ViamVjdDogW1BB VENIXSBkb2M6IEFkZGVkIEZBUSBzZWN0aW9uIHdpdGggZW50cnkgb24gdXNpbmcgY2xlYXIuCgoq IGRvYy9ndWl4LWNvb2tib29rLnRleGk6IEFkZGVkIEZBUSBzZWN0aW9uLgotLS0KIGRvYy9ndWl4 LWNvb2tib29rLnRleGkgfCAxNiArKysrKysrKysrKysrKysrCiAxIGZpbGUgY2hhbmdlZCwgMTYg aW5zZXJ0aW9ucygrKQoKZGlmZiAtLWdpdCBhL2RvYy9ndWl4LWNvb2tib29rLnRleGkgYi9kb2Mv Z3VpeC1jb29rYm9vay50ZXhpCmluZGV4IGRjNTJmNmQzOGMuLjE0YzU1OTI2YzIgMTAwNjQ0Ci0t LSBhL2RvYy9ndWl4LWNvb2tib29rLnRleGkKKysrIGIvZG9jL2d1aXgtY29va2Jvb2sudGV4aQpA QCAtNzAsNiArNzAsNyBAQCBXZWJsYXRlfSAoQHB4cmVme1RyYW5zbGF0aW5nIEd1aXgsLCwgZ3Vp eCwgR05VIEd1aXggcmVmZXJlbmNlIG1hbnVhbH0pLgogKiBTeXN0ZW0gQ29uZmlndXJhdGlvbjo6 ICAgICAgICBDdXN0b21pemluZyB0aGUgR05VIFN5c3RlbQogKiBBZHZhbmNlZCBwYWNrYWdlIG1h bmFnZW1lbnQ6OiBQb3dlciB0byB0aGUgdXNlcnMhCiAqIEVudmlyb25tZW50IG1hbmFnZW1lbnQ6 OiAgICAgIENvbnRyb2wgZW52aXJvbm1lbnQKKyogRkFROjogICAgICAgICAgICAgICAgICAgICAg ICAgQ29tbW9ubHkgYXNrZWQgcXVlc3Rpb25zCiAKICogQWNrbm93bGVkZ21lbnRzOjogICAgICAg ICAgICAgVGhhbmtzIQogKiBHTlUgRnJlZSBEb2N1bWVudGF0aW9uIExpY2Vuc2U6OiAgVGhlIGxp Y2Vuc2Ugb2YgdGhpcyBkb2N1bWVudC4KQEAgLTI5NjQsNiArMjk2NSwyMSBAQCB3aWxsIGhhdmUg cHJlZGVmaW5lZCBlbnZpcm9ubWVudCB2YXJpYWJsZXMgYW5kIHByb2NlZHVyZXMuCiAKIFJ1biBA Y29tbWFuZHtkaXJlbnYgYWxsb3d9IHRvIHNldHVwIHRoZSBlbnZpcm9ubWVudCBmb3IgdGhlIGZp cnN0IHRpbWUuCiAKK0BjICoqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioq KioqKioqKioqKioqKioqKioqKioqKioqKioqKgorQG5vZGUgRkFRCitAY2hhcHRlciBGQVEKKwor VGhpcyBjaGFwdGVyIGNvbGxlY3RzIHNvbWUgZnJlcXVlbnRseSBhc2tlZCBxdWVzdGlvbnMgdGhh dCBtaWdodCBhcmlzZSBmb3IgbmV3IHVzZXJzLgorCitAbWVudQorKiBIb3cgZG8gSSBjbGVhciBt eSB0ZXJtaW5hbCBzY3JlZW4/CitAZW5kIG1lbnUKKworQG5vZGUgSG93IGRvIEkgY2xlYXIgbXkg dGVybWluYWwgc2NyZWVuPworQHNlY3Rpb24gSG93IGRvIEkgY2xlYXIgbXkgdGVybWluYWwgc2Ny ZWVuPworCitUaGUgQGNvbW1hbmR7Y2xlYXJ9IGNvbW1hbmQgaXMgZm91bmQgaW4gdGhlIEBjb21t YW5ke25jdXJzZXN9IHBhY2thZ2UuIAorCiBAYyAqKioqKioqKioqKioqKioqKioqKioqKioqKioq KioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioKIEBub2RlIEFja25vd2xl ZGdtZW50cwogQGNoYXB0ZXIgQWNrbm93bGVkZ21lbnRzCi0tIAoyLjMzLjEKCg== --b1_Xlo8ut5Luc9y10HyVTVjgpbJxnL66Xu3uE57RtosjI-- From debbugs-submit-bounces@debbugs.gnu.org Mon Nov 08 04:29:11 2021 Received: (at 51538) by debbugs.gnu.org; 8 Nov 2021 09:29:11 +0000 Received: from localhost ([127.0.0.1]:56335 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk0xj-0004az-0u for submit@debbugs.gnu.org; Mon, 08 Nov 2021 04:29:11 -0500 Received: from pelzflorian.de ([5.45.111.108]:57658 helo=mail.pelzflorian.de) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk0xg-0004aq-PD for 51538@debbugs.gnu.org; Mon, 08 Nov 2021 04:29:09 -0500 Received: from pelzflorian.localdomain (unknown [5.45.111.108]) by mail.pelzflorian.de (Postfix) with ESMTPSA id 88BFB3606F5; Mon, 8 Nov 2021 10:29:07 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=pelzflorian.de; s=mail; t=1636363747; bh=m3CfuiJaU8PCo3A3jOCWQQYeOK33hayEnj60NwrPw5A=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=yxbIkDqBSuZnZvlZswd/Nv/cvcFCsVJnhJgP0SK+YYhVPMHePqAPn0WvbQljMVz4T YPJfxBzWVlg+jFHop8kELIzYgfR6JrRQisfk0iFidBtKv9UBTKKhorxj1NgS1nvrF6 S8+pwDeKkSK7nm8xsXyJCoiqaoMWJE33+QM+yzT4= Date: Mon, 8 Nov 2021 10:29:00 +0100 From: "pelzflorian (Florian Pelz)" To: Disseminate Dissent Subject: Re: [bug#51538] First Patch Submit Ever: Additions to the Cookbook Documentation Message-ID: <20211108092900.ldk4lkh3p7wl7msd@pelzflorian.localdomain> References: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 51538 Cc: 51538@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 (-) Hello Disseminate. On Thu, Nov 04, 2021 at 03:17:48PM +0000, Disseminate Dissent via Guix-patches via wrote: > Fixed the previous commit by adding the corresponding ToC heading to the new FAQ section. > > Disseminate, Peace. Thank you for your contribution! It is good you add what you are missing. I’d prefer if someone else commented, though here are my thoughts. A FAQ seems like a good idea, however see below. On Thu, Nov 04, 2021 at 03:17:48PM +0000, Disseminate Dissent via Guix-patches via wrote: > From fce239a311724e38987640af02127179d569d88e Mon Sep 17 00:00:00 2001 > From: dissent > Date: Sat, 30 Oct 2021 17:00:02 -0400 > Subject: [PATCH] doc: Added FAQ section with entry on using clear. For the commit message, Guix uses the active voice “Add a FAQ section with …”. > * doc/guix-cookbook.texi: Added FAQ section. Here too. > --- > doc/guix-cookbook.texi | 16 ++++++++++++++++ > 1 file changed, 16 insertions(+) > > diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi > index dc52f6d38c..14c55926c2 100644 > --- a/doc/guix-cookbook.texi > +++ b/doc/guix-cookbook.texi > @@ -70,6 +70,7 @@ Weblate} (@pxref{Translating Guix,,, guix, GNU Guix reference manual}). > * System Configuration:: Customizing the GNU System > * Advanced package management:: Power to the users! > * Environment management:: Control environment > +* FAQ:: Commonly asked questions > > * Acknowledgments:: Thanks! > * GNU Free Documentation License:: The license of this document. Menu comments like “Commonly asked questions” usually end in a period, although the surrounding menu comments are missing the period as well. Could you add a period for “Commonly asked questions”? But see below. > @@ -2964,6 +2965,21 @@ will have predefined environment variables and procedures. > > Run @command{direnv allow} to setup the environment for the first time. > > +@c ********************************************************************* > +@node FAQ > +@chapter FAQ > + > +This chapter collects some frequently asked questions that might arise for new users. > + > +@menu > +* How do I clear my terminal screen? > +@end menu > + > +@node How do I clear my terminal screen? > +@section How do I clear my terminal screen? > + > +The @command{clear} command is found in the @command{ncurses} package. > + > @c ********************************************************************* > @node Acknowledgments > @chapter Acknowledgments > -- > 2.33.1 I am uncertain if this tip should be in the cookbook, because I think GNU Bash’s C-l (control+L) keyboard shortcutis easier to use and is available in a default setup. (Actually it may be GNU Readline’s keyboard shortcut and Bash just uses Readline?) Now indeed users may not know about it. I do not know how to help Guix users learn about features of programs that Guix offers but are not part of Guix. Nitpick: you have added an unnecessary space character at the end of the line > +The @command{clear} command is found in the @command{ncurses} package. You should configure your editor to display those. Regards, Florian From debbugs-submit-bounces@debbugs.gnu.org Mon Nov 08 04:54:03 2021 Received: (at 51538) by debbugs.gnu.org; 8 Nov 2021 09:54:03 +0000 Received: from localhost ([127.0.0.1]:56478 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk1Ln-0005Kf-Gw for submit@debbugs.gnu.org; Mon, 08 Nov 2021 04:54:03 -0500 Received: from pelzflorian.de ([5.45.111.108]:57684 helo=mail.pelzflorian.de) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk1Ll-0005KF-Ca for 51538@debbugs.gnu.org; Mon, 08 Nov 2021 04:54:02 -0500 Received: from pelzflorian.localdomain (unknown [5.45.111.108]) by mail.pelzflorian.de (Postfix) with ESMTPSA id 1B8F63606F5; Mon, 8 Nov 2021 10:54:00 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=pelzflorian.de; s=mail; t=1636365240; bh=7wXjFFs2hYfZKJZRx1dU7nj7nGsw3GKHh+XjeM/KXEE=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=i9Wwr/aADE8L3X4jC+0c5WUf83STA5I4+DIKOOuSOOg8KGgWWyLYt8JdkHfpTqAC2 PbyCkmnkZhJBKCuWmQIcMqiZnGHVn9//DovQqCbAd5LuXjQ9G8zaCOo7RGtc0yVaAs cwymlvEfjhF1RKYBuilWu3UXwcjn2VQ14WfIlg8o= Date: Mon, 8 Nov 2021 10:53:52 +0100 From: "pelzflorian (Florian Pelz)" To: Disseminate Dissent Subject: Re: [bug#51538] First Patch Submit Ever: Additions to the Cookbook Documentation Message-ID: <20211108095352.syl232hqnswukkxn@pelzflorian.localdomain> References: <20211108092900.ldk4lkh3p7wl7msd@pelzflorian.localdomain> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20211108092900.ldk4lkh3p7wl7msd@pelzflorian.localdomain> X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 51538 Cc: 51538@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 (-) P.S. I tried your patch with the commands described by `info "(guix)Building from Git"` and I get the following error: ./doc/guix-cookbook.texi:2978: warning: node `FAQ' is up for `How do I clear my terminal screen?' in sectioning but not in menu ./doc/guix-cookbook.texi:2969: node `FAQ' lacks menu item for `How do I clear my terminal screen?' despite being its Up target make[2]: *** [Makefile:5331: doc/guix-cookbook.info] Error 1 make[1]: *** [Makefile:6268: all-recursive] Error 1 make: *** [Makefile:3916: all] Error 2 I’m not sure what that means, but please test building it before you submit a patch. Regards, Florian From debbugs-submit-bounces@debbugs.gnu.org Mon Nov 08 08:50:47 2021 Received: (at submit) by debbugs.gnu.org; 8 Nov 2021 13:50:47 +0000 Received: from localhost ([127.0.0.1]:56873 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk52t-0003r9-9L for submit@debbugs.gnu.org; Mon, 08 Nov 2021 08:50:47 -0500 Received: from lists.gnu.org ([209.51.188.17]:40004) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk52r-0003r1-Sd for submit@debbugs.gnu.org; Mon, 08 Nov 2021 08:50:46 -0500 Received: from eggs.gnu.org ([209.51.188.92]:46170) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mk52q-0000w7-HV for guix-patches@gnu.org; Mon, 08 Nov 2021 08:50:44 -0500 Received: from mail-40130.protonmail.ch ([185.70.40.130]:22324) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mk52k-00054E-Us for guix-patches@gnu.org; Mon, 08 Nov 2021 08:50:41 -0500 Date: Mon, 08 Nov 2021 13:50:20 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail; t=1636379421; bh=zpGiJ5YvdaBP8e9e+07fV9h6dUbqtFP53qWaLtWgVTw=; h=Date:To:From:Reply-To:Subject:In-Reply-To:References:From; b=sI6QV/GQqqCOYP30fqQUion5AkVMX6vclLjgwRb5FtIC7SKNcobBbVh+LHT+HVpqR JteIFROST5bOGTkwSxBIj6l2dtCphcxYgWUMLE9mIA8yYNYYIPYsaU+rpHG7NPcDKc 4hwkf7IcLdEFLntDxfGBK3G6pCWPfAt5UjeNhFdU= To: "guix-patches@gnu.org" From: Disseminate Dissent Subject: Re: First Patch Submit Ever: Additions to the Cookbook Documentation Message-ID: In-Reply-To: References: MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="b1_ldfB0NYOksXxGYfsOydddOBQmC68nk04emKOPe5qI" X-Spam-Status: No, score=-1.2 required=10.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,HTML_MESSAGE shortcircuit=no autolearn=disabled version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on mailout.protonmail.ch Received-SPF: pass client-ip=185.70.40.130; envelope-from=disseminatedissent@protonmail.com; helo=mail-40130.protonmail.ch 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, HTML_MESSAGE=0.001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit 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: , Reply-To: Disseminate Dissent Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) This is a multi-part message in MIME format. --b1_ldfB0NYOksXxGYfsOydddOBQmC68nk04emKOPe5qI Content-Type: multipart/alternative; boundary="b2_ldfB0NYOksXxGYfsOydddOBQmC68nk04emKOPe5qI" --b2_ldfB0NYOksXxGYfsOydddOBQmC68nk04emKOPe5qI Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: base64 Q29ycmVjdGVkIG1pc3NpbmcgcGVyaW9kcyBhbmQgd2hpdGVzcGFjZS4KCkRpc3NlbWluYXRlLApQ ZWFjZQoK4oCQ4oCQ4oCQ4oCQ4oCQ4oCQ4oCQIE9yaWdpbmFsIE1lc3NhZ2Ug4oCQ4oCQ4oCQ4oCQ 4oCQ4oCQ4oCQCk9uIFRodXJzZGF5LCBOb3ZlbWJlciA0dGgsIDIwMjEgYXQgMzoxNyBQTSwgRGlz c2VtaW5hdGUgRGlzc2VudCA8ZGlzc2VtaW5hdGVkaXNzZW50QHByb3Rvbm1haWwuY29tPiB3cm90 ZToKCj4gRml4ZWQgdGhlIHByZXZpb3VzIGNvbW1pdCBieSBhZGRpbmcgdGhlIGNvcnJlc3BvbmRp bmcgVG9DIGhlYWRpbmcgdG8gdGhlIG5ldyBGQVEgc2VjdGlvbi4KPgo+IERpc3NlbWluYXRlLCBQ ZWFjZS4KPgo+IOKAkOKAkOKAkOKAkOKAkOKAkOKAkCBPcmlnaW5hbCBNZXNzYWdlIOKAkOKAkOKA kOKAkOKAkOKAkOKAkAo+IE9uIFN1bmRheSwgT2N0b2JlciAzMXN0LCAyMDIxIGF0IDExOjU2IFBN LCBEaXNzZW1pbmF0ZSBEaXNzZW50IDxkaXNzZW1pbmF0ZWRpc3NlbnRAcHJvdG9ubWFpbC5jb20+ IHdyb3RlOgo+Cj4+IEhleSB0aGVyZSwgdGFraW5nIG15IGZpcnN0IHN0ZXAgaW50byBhIGxhcmdl ciB3b3JsZC4KPj4KPj4gQXR0YWNoZWQgaXMganVzdCBhIHBhdGNoIHRvIHRoZSBHTlUgR3VpeCBD b29rYm9vayB0aGF0IGFkZHMgYSBGQVEgd2l0aCBpdCdzIGZpcnN0IGVudHJ5LiBUaGUgVG9DIHdp bGwgbmVlZCB0byBiZSBlZGl0ZWQgaW4gb3JkZXIgdG8gcmVmbGVjdCB0aGF0IHRob3VnaC4KPj4K Pj4gUGVhY2UsCj4+IERpc3NlbnQ= --b2_ldfB0NYOksXxGYfsOydddOBQmC68nk04emKOPe5qI Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: base64 PGRpdiBzdHlsZT0iZm9udC1mYW1pbHk6IG1lbmxvLCBjb25zb2xhcywgY291cmllciBuZXcsIG1v bm9zcGFjZTsgZm9udC1zaXplOiAxNHB4OyI+PGRpdj5Db3JyZWN0ZWQgbWlzc2luZyBwZXJpb2Rz IGFuZCB3aGl0ZXNwYWNlLjxicj48L2Rpdj48ZGl2Pjxicj48L2Rpdj48ZGl2IGNsYXNzPSJwcm90 b25tYWlsX3NpZ25hdHVyZV9ibG9jayI+PGRpdiBjbGFzcz0icHJvdG9ubWFpbF9zaWduYXR1cmVf YmxvY2stdXNlciI+PGRpdj5EaXNzZW1pbmF0ZSw8YnI+PC9kaXY+PGRpdj5QZWFjZTxicj48L2Rp dj48L2Rpdj48L2Rpdj48ZGl2Pjxicj48L2Rpdj48L2Rpdj48ZGl2Pjxicj48L2Rpdj48ZGl2IGNs YXNzPSJwcm90b25tYWlsX3F1b3RlIj4NCiAgICAgICAg4oCQ4oCQ4oCQ4oCQ4oCQ4oCQ4oCQIE9y aWdpbmFsIE1lc3NhZ2Ug4oCQ4oCQ4oCQ4oCQ4oCQ4oCQ4oCQPGJyPg0KICAgICAgICBPbiBUaHVy c2RheSwgTm92ZW1iZXIgNHRoLCAyMDIxIGF0IDM6MTcgUE0sIERpc3NlbWluYXRlIERpc3NlbnQg Jmx0O2Rpc3NlbWluYXRlZGlzc2VudEBwcm90b25tYWlsLmNvbSZndDsgd3JvdGU6PGJyPg0KICAg ICAgICA8YmxvY2txdW90ZSBjbGFzcz0icHJvdG9ubWFpbF9xdW90ZSIgdHlwZT0iY2l0ZSI+DQog ICAgICAgICAgICA8ZGl2IHN0eWxlPSJmb250LWZhbWlseTogbWVubG8sIGNvbnNvbGFzLCBjb3Vy aWVyIG5ldywgbW9ub3NwYWNlOyBmb250LXNpemU6IDE0cHg7Ij48ZGl2PkZpeGVkIHRoZSBwcmV2 aW91cyBjb21taXQgYnkgYWRkaW5nIHRoZSBjb3JyZXNwb25kaW5nIFRvQyBoZWFkaW5nIHRvIHRo ZSBuZXcgRkFRIHNlY3Rpb24uPGJyPjwvZGl2PjxkaXY+PGJyPjwvZGl2PjxkaXY+RGlzc2VtaW5h dGUsIFBlYWNlLjxicj48L2Rpdj48ZGl2Pjxicj48L2Rpdj48L2Rpdj48ZGl2Pjxicj48L2Rpdj48 ZGl2IGNsYXNzPSJwcm90b25tYWlsX3F1b3RlIj4NCiAgICAgICAg4oCQ4oCQ4oCQ4oCQ4oCQ4oCQ 4oCQIE9yaWdpbmFsIE1lc3NhZ2Ug4oCQ4oCQ4oCQ4oCQ4oCQ4oCQ4oCQPGJyPg0KICAgICAgICBP biBTdW5kYXksIE9jdG9iZXIgMzFzdCwgMjAyMSBhdCAxMTo1NiBQTSwgRGlzc2VtaW5hdGUgRGlz c2VudCAmbHQ7ZGlzc2VtaW5hdGVkaXNzZW50QHByb3Rvbm1haWwuY29tJmd0OyB3cm90ZTo8YnI+ DQogICAgICAgIDxibG9ja3F1b3RlIHR5cGU9ImNpdGUiIGNsYXNzPSJwcm90b25tYWlsX3F1b3Rl Ij4NCiAgICAgICAgICAgIDxkaXY+SGV5IHRoZXJlLCB0YWtpbmcgbXkgZmlyc3Qgc3RlcCBpbnRv IGEgbGFyZ2VyIHdvcmxkLjxicj48L2Rpdj48ZGl2Pjxicj48L2Rpdj48ZGl2PkF0dGFjaGVkIGlz IGp1c3QgYSBwYXRjaCB0byB0aGUgR05VIEd1aXggQ29va2Jvb2sgdGhhdCBhZGRzIGEgRkFRIHdp dGggaXQncyBmaXJzdCBlbnRyeS4gVGhlIFRvQyB3aWxsIG5lZWQgdG8gYmUgZWRpdGVkIGluIG9y ZGVyIHRvIHJlZmxlY3QgdGhhdCB0aG91Z2guPGJyPjwvZGl2PjxkaXY+PGJyPjwvZGl2PjxkaXY+ UGVhY2UsPGJyPjwvZGl2PjxkaXY+RGlzc2VudDxicj48L2Rpdj4NCiAgICAgICAgPC9ibG9ja3F1 b3RlPjxicj4NCiAgICA8L2Rpdj4NCiAgICAgICAgPC9ibG9ja3F1b3RlPjxicj4NCiAgICA8L2Rp dj4= --b2_ldfB0NYOksXxGYfsOydddOBQmC68nk04emKOPe5qI-- --b1_ldfB0NYOksXxGYfsOydddOBQmC68nk04emKOPe5qI Content-Type: text/x-patch; name=0001-doc-Add-a-FAQ-section-with-entry-on-using-clear.patch Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename=0001-doc-Add-a-FAQ-section-with-entry-on-using-clear.patch RnJvbSA2Njk0N2Y3NjZjNTlhMWVjYmY3Y2IxZmM5MWY0MDQ2NTNlNzRkN2U1IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBkaXNzZW50IDxkaXNzZW1pbmF0ZWRpc3NlbnRAcHJvdG9ubWFp bC5jb20+CkRhdGU6IFNhdCwgMzAgT2N0IDIwMjEgMTc6MDA6MDIgLTA0MDAKU3ViamVjdDogW1BB VENIXSBkb2M6IEFkZCBhIEZBUSBzZWN0aW9uIHdpdGggZW50cnkgb24gdXNpbmcgY2xlYXIuCgoq IGRvYy9ndWl4LWNvb2tib29rLnRleGk6IEFkZGVkIEZBUSBzZWN0aW9uLgotLS0KIGRvYy9ndWl4 LWNvb2tib29rLnRleGkgfCAyMiArKysrKysrKysrKysrKysrKysrLS0tCiAxIGZpbGUgY2hhbmdl ZCwgMTkgaW5zZXJ0aW9ucygrKSwgMyBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9kb2MvZ3Vp eC1jb29rYm9vay50ZXhpIGIvZG9jL2d1aXgtY29va2Jvb2sudGV4aQppbmRleCBkYzUyZjZkMzhj Li4wNzE4YTY3MTFkIDEwMDY0NAotLS0gYS9kb2MvZ3VpeC1jb29rYm9vay50ZXhpCisrKyBiL2Rv Yy9ndWl4LWNvb2tib29rLnRleGkKQEAgLTY2LDEwICs2NiwxMSBAQCBXZWJsYXRlfSAoQHB4cmVm e1RyYW5zbGF0aW5nIEd1aXgsLCwgZ3VpeCwgR05VIEd1aXggcmVmZXJlbmNlIG1hbnVhbH0pLgog CiBAbWVudQogKiBTY2hlbWUgdHV0b3JpYWxzOjogICAgICAgICAgICBNZWV0IHlvdXIgbmV3IGZh dm9yaXRlIGxhbmd1YWdlIQotKiBQYWNrYWdpbmc6OiAgICAgICAgICAgICAgICAgICBQYWNrYWdp bmcgdHV0b3JpYWxzCi0qIFN5c3RlbSBDb25maWd1cmF0aW9uOjogICAgICAgIEN1c3RvbWl6aW5n IHRoZSBHTlUgU3lzdGVtCisqIFBhY2thZ2luZzo6ICAgICAgICAgICAgICAgICAgIFBhY2thZ2lu ZyB0dXRvcmlhbHMuCisqIFN5c3RlbSBDb25maWd1cmF0aW9uOjogICAgICAgIEN1c3RvbWl6aW5n IHRoZSBHTlUgU3lzdGVtLgogKiBBZHZhbmNlZCBwYWNrYWdlIG1hbmFnZW1lbnQ6OiBQb3dlciB0 byB0aGUgdXNlcnMhCi0qIEVudmlyb25tZW50IG1hbmFnZW1lbnQ6OiAgICAgIENvbnRyb2wgZW52 aXJvbm1lbnQKKyogRW52aXJvbm1lbnQgbWFuYWdlbWVudDo6ICAgICAgQ29udHJvbCBlbnZpcm9u bWVudC4KKyogRkFROjogICAgICAgICAgICAgICAgICAgICAgICAgQ29tbW9ubHkgYXNrZWQgcXVl c3Rpb25zLgogCiAqIEFja25vd2xlZGdtZW50czo6ICAgICAgICAgICAgIFRoYW5rcyEKICogR05V IEZyZWUgRG9jdW1lbnRhdGlvbiBMaWNlbnNlOjogIFRoZSBsaWNlbnNlIG9mIHRoaXMgZG9jdW1l bnQuCkBAIC0yOTY0LDYgKzI5NjUsMjEgQEAgd2lsbCBoYXZlIHByZWRlZmluZWQgZW52aXJvbm1l bnQgdmFyaWFibGVzIGFuZCBwcm9jZWR1cmVzLgogCiBSdW4gQGNvbW1hbmR7ZGlyZW52IGFsbG93 fSB0byBzZXR1cCB0aGUgZW52aXJvbm1lbnQgZm9yIHRoZSBmaXJzdCB0aW1lLgogCitAYyAqKioq KioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioq KioqKioqKioKK0Bub2RlIEZBUQorQGNoYXB0ZXIgRkFRCisKK1RoaXMgY2hhcHRlciBjb2xsZWN0 cyBzb21lIGZyZXF1ZW50bHkgYXNrZWQgcXVlc3Rpb25zIHRoYXQgbWlnaHQgYXJpc2UgZm9yIG5l dyB1c2Vycy4KKworQG1lbnUKKyogSG93IGRvIEkgY2xlYXIgbXkgdGVybWluYWwgc2NyZWVuPwor QGVuZCBtZW51CisKK0Bub2RlIEhvdyBkbyBJIGNsZWFyIG15IHRlcm1pbmFsIHNjcmVlbj8KK0Bz ZWN0aW9uIEhvdyBkbyBJIGNsZWFyIG15IHRlcm1pbmFsIHNjcmVlbj8KKworVGhlIEBjb21tYW5k e2NsZWFyfSBjb21tYW5kIGlzIGZvdW5kIGluIHRoZSBAY29tbWFuZHtuY3Vyc2VzfSBwYWNrYWdl LgorCiBAYyAqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioq KioqKioqKioqKioqKioqKioqKioKIEBub2RlIEFja25vd2xlZGdtZW50cwogQGNoYXB0ZXIgQWNr bm93bGVkZ21lbnRzCi0tIAoyLjMzLjEKCg== --b1_ldfB0NYOksXxGYfsOydddOBQmC68nk04emKOPe5qI-- From debbugs-submit-bounces@debbugs.gnu.org Mon Nov 08 08:52:30 2021 Received: (at 51538) by debbugs.gnu.org; 8 Nov 2021 13:52:30 +0000 Received: from localhost ([127.0.0.1]:56878 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk54X-0003uN-P4 for submit@debbugs.gnu.org; Mon, 08 Nov 2021 08:52:29 -0500 Received: from mail-4325.protonmail.ch ([185.70.43.25]:15977) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk54V-0003u8-Vj for 51538@debbugs.gnu.org; Mon, 08 Nov 2021 08:52:28 -0500 Date: Mon, 08 Nov 2021 13:52:20 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail; t=1636379541; bh=qbxgohqmuhGDSB/ekXdkgyggYKyfvcWAFF+rhgQcFjw=; h=Date:To:From:Reply-To:Subject:From; b=kptUxzoSeZIIpmiZR6Qn+6Cu90/OBpa2qn9b+J/QUUcJfPkpKZwIP1REn30ln/MSn eSK+lTTaIS+BhTAU4c3qRk767GquLwnkwhcEhT+P+sSGqnjuzOY3LFYulY27LUT2mC fKJdwbJPg8DGYJEnVA8mrkwZhixkXob/ZKBZO3Ik= To: "51538@debbugs.gnu.org" <51538@debbugs.gnu.org> From: Disseminate Dissent Subject: First Patch Submit Ever: Additions to the Cookbook Documentation Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Status: No, score=-1.2 required=10.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM shortcircuit=no autolearn=disabled version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on mailout.protonmail.ch X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 51538 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: , Reply-To: Disseminate Dissent Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Thanks for the comments Florian, Added periods and removed whitespace. In my initial Guix setup I was unable to clear the terminal with neither `c= lear` nor C-l. Installing ncurses solved that issue and is listed as a depe= ndency for GNU Readline. I was able to build the html just fine before I submitted it. Upon rebuildi= ng, the html appears fine but still getting those errors. I then decided to= just clone the guix repo again without making any changes to the .texi but= attempting to create the html still produced those errors. It seems this is the issue: Unescaped left brace in regex is deprecated here (and will be fatal in Perl= 5.32), passed through in regex; marked by <-- HERE in m/^\s+@([^\s\{\}\@]+= )({ <-- HERE })?\s*/ at /gnu/store/nxqw880l3r5z0dl6nrlf75mr0z0v70vp-profile= /bin/texi2html line 33246. Not sure how to proceed from here. The new patch has been submited Disseminate, Peace From debbugs-submit-bounces@debbugs.gnu.org Mon Nov 08 12:19:05 2021 Received: (at 51538) by debbugs.gnu.org; 8 Nov 2021 17:19:05 +0000 Received: from localhost ([127.0.0.1]:59301 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk8IT-00045m-FZ for submit@debbugs.gnu.org; Mon, 08 Nov 2021 12:19:05 -0500 Received: from pelzflorian.de ([5.45.111.108]:58076 helo=mail.pelzflorian.de) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk8IP-00045J-Hb for 51538@debbugs.gnu.org; Mon, 08 Nov 2021 12:19:03 -0500 Received: from pelzflorian.localdomain (unknown [5.45.111.108]) by mail.pelzflorian.de (Postfix) with ESMTPSA id 5D8473606B4; Mon, 8 Nov 2021 18:18:59 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=pelzflorian.de; s=mail; t=1636391939; bh=a8t13jMyhpF6s316CAs3tqTMJ07UxwDRDAlSUW/3Chs=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=uR1L5rnKSw9iE+PPTw5FFX0ZpExW9ZOSV9vSu9Dty5Yma4cePZ75yi5K3Nz0GXEYu jHpn9PFteemkPlBg//lCyEuRIlo8hBSc4OpTU7aTgyu3BGnRacoCktsuBjFwKQs1KJ DPA5Sn1kuzbgkbzau0/ETPTidW7zak4YwFtD50Ts= Date: Mon, 8 Nov 2021 18:18:50 +0100 From: "pelzflorian (Florian Pelz)" To: Disseminate Dissent Subject: Re: [bug#51538] First Patch Submit Ever: Additions to the Cookbook Documentation Message-ID: <20211108171850.q6pqyiv4g5q2oktr@pelzflorian.localdomain> References: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 51538 Cc: 51538@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 (-) Disseminate, thank you for your work. On Mon, Nov 08, 2021 at 01:48:39PM +0000, Disseminate Dissent wrote: > Thanks for the comments Florian, > > Added periods and removed whitespace. > > In my initial Guix setup I was unable to clear the terminal with > neither `clear` nor C-l. Installing ncurses solved that issue and is > listed as a dependency for GNU Readline. Bash always enables readline as far as I can see. Perhaps you used a system that disabled C-l in the ~/.inputrc file, which would also disable it for a Guix-installed bash? Some Slackware users complain about non-working C-l on stackoverflow. Anyway I will leave this patch for experienced guix commiters to decide; IMHO the clear command should not be needed with Guix and the cookbook so far contains only what can be done with Guix itself. Even though I like the idea of a FAQ section and am happy about new Guix contributors such as you. As for the patch: On Mon, Nov 08, 2021 at 01:50:20PM +0000, Disseminate Dissent via Guix-patches via wrote: > Corrected missing periods and whitespace. > You have not addressed this latter passive Added instead of Add: On Mon, Nov 08, 2021 at 10:29:00AM +0100, pelzflorian (Florian Pelz) wrote: > For the commit message, Guix uses the active voice “Add a FAQ section > with …”. > > > > * doc/guix-cookbook.texi: Added FAQ section. > > Here too. Then: On Mon, Nov 08, 2021 at 01:50:20PM +0000, Disseminate Dissent via Guix-patches via wrote: > @menu > * Scheme tutorials:: Meet your new favorite language! > -* Packaging:: Packaging tutorials > -* System Configuration:: Customizing the GNU System > +* Packaging:: Packaging tutorials. > +* System Configuration:: Customizing the GNU System. > * Advanced package management:: Power to the users! > -* Environment management:: Control environment > +* Environment management:: Control environment. > +* FAQ:: Commonly asked questions. Your commit should only add the period to your sentence; other sentences should remain untouched (fixing them belongs in a separate commit). I should fix such things myself in other commits; probably I won’t do it. Other than that, it is a nicely written patch. It seems the issue when running the commands from `info "(guix)Building from Git"` is that the other menu > +@menu > +* How do I clear my terminal screen? > +@end menu does not contain double colons followed by a sentence like the other @menu. Regards, Florian From debbugs-submit-bounces@debbugs.gnu.org Mon Nov 08 14:04:38 2021 Received: (at submit) by debbugs.gnu.org; 8 Nov 2021 19:04:38 +0000 Received: from localhost ([127.0.0.1]:59494 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk9wc-0002q8-34 for submit@debbugs.gnu.org; Mon, 08 Nov 2021 14:04:38 -0500 Received: from lists.gnu.org ([209.51.188.17]:48622) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mk9wa-0002pz-9t for submit@debbugs.gnu.org; Mon, 08 Nov 2021 14:04:36 -0500 Received: from eggs.gnu.org ([209.51.188.92]:56862) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mk9wa-0003uV-66 for guix-patches@gnu.org; Mon, 08 Nov 2021 14:04:36 -0500 Received: from lepiller.eu ([89.234.186.109]:36068) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mk9wX-0001U7-JQ for guix-patches@gnu.org; Mon, 08 Nov 2021 14:04:35 -0500 Received: from lepiller.eu (localhost [127.0.0.1]) by lepiller.eu (OpenSMTPD) with ESMTP id 7466d97d; Mon, 8 Nov 2021 19:04:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=lepiller.eu; h=date:from :to:cc:subject:in-reply-to:references:message-id:mime-version :content-type:content-transfer-encoding; s=dkim; bh=fUlTImwpBU6w TMs81l+V/5+93SWUS3eLssWxXQr6XY0=; b=dgK5lBCMW/qTPIQMHkCU17gRQJCO 5NXimiHMDctp2jHV3W0CH8ZJoCewGt74a8HVO6NlTYKl3SqH5KAqUDtUZLAgfyuX BxWPDVehqRRbyXR2R9sILK8rAPVhz5aLYFJPPm2PWo9KZR442AVkuewm4bPxg3N0 1cYkMKUaNFcf1c5yuMV7d+5WE1YqdKy+Nrf5erfVCdEBVL+E8tW07RzQvf8bIC/s N3tFWx+5uzvCorStSNErzfNsoN4AJePtL1nq/UyAVSXRwkhQvZxkxXsjbRJ0s9Xy zfiAF9s69vTuqeWRv2Bfmwahx3SHCX5CNcAbikRHMonFstxH+ez3JL1Khg== Received: by lepiller.eu (OpenSMTPD) with ESMTPSA id 6d6ce7af (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO); Mon, 8 Nov 2021 19:04:25 +0000 (UTC) Date: Mon, 08 Nov 2021 14:04:12 -0500 From: Julien Lepiller To: guix-patches@gnu.org, "pelzflorian (Florian Pelz)" , Disseminate Dissent Subject: =?US-ASCII?Q?Re=3A_=5Bbug=2351538=5D_First_Patch_Submit_Ever=3A?= =?US-ASCII?Q?_Additions_to_the_Cookbook_Documentation?= User-Agent: K-9 Mail for Android In-Reply-To: <20211108171850.q6pqyiv4g5q2oktr@pelzflorian.localdomain> References: <20211108171850.q6pqyiv4g5q2oktr@pelzflorian.localdomain> Message-ID: MIME-Version: 1.0 Content-Type: multipart/alternative; boundary=----YS9O4FDVDMP6HDWL535UWDK16IITY8 Content-Transfer-Encoding: 7bit Received-SPF: pass client-ip=89.234.186.109; envelope-from=julien@lepiller.eu; helo=lepiller.eu 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, HTML_MESSAGE=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit Cc: 51538@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: -2.3 (--) ------YS9O4FDVDMP6HDWL535UWDK16IITY8 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable I think this is fine=2E The cookbook should recommend using Ctrl-L and sugg= est you can install clear with the ncurses package=2E We get that question = from time to time, so I think it belongs to a FAQ :) Le 8 novembre 2021 12:18:50 GMT-05:00, "pelzflorian (Florian Pelz)" a =C3=A9crit=C2=A0: >Disseminate, thank you for your work=2E > >On Mon, Nov 08, 2021 at 01:48:39PM +0000, Disseminate Dissent wrote: >> Thanks for the comments Florian, >>=20 >> Added periods and removed whitespace=2E >>=20 >> In my initial Guix setup I was unable to clear the terminal with >> neither `clear` nor C-l=2E Installing ncurses solved that issue and is >> listed as a dependency for GNU Readline=2E > >Bash always enables readline as far as I can see=2E Perhaps you used a >system that disabled C-l in the ~/=2Einputrc file, which would also >disable it for a Guix-installed bash? Some Slackware users complain >about non-working C-l on stackoverflow=2E Anyway I will leave this >patch for experienced guix commiters to decide; IMHO the clear command >should not be needed with Guix and the cookbook so far contains only >what can be done with Guix itself=2E Even though I like the idea of a >FAQ section and am happy about new Guix contributors such as you=2E > >As for the patch: > >On Mon, Nov 08, 2021 at 01:50:20PM +0000, Disseminate Dissent via Guix-pa= tches via wrote: >> Corrected missing periods and whitespace=2E >> > >You have not addressed this latter passive Added instead of Add: > >On Mon, Nov 08, 2021 at 10:29:00AM +0100, pelzflorian (Florian Pelz) wrot= e: >> For the commit message, Guix uses the active voice =E2=80=9CAdd a FAQ s= ection >> with =E2=80=A6=E2=80=9D=2E >>=20 >>=20 >> > * doc/guix-cookbook=2Etexi: Added FAQ section=2E >>=20 >> Here too=2E > >Then: > >On Mon, Nov 08, 2021 at 01:50:20PM +0000, Disseminate Dissent via Guix-pa= tches via wrote: >> @menu >> * Scheme tutorials:: Meet your new favorite language! >> -* Packaging:: Packaging tutorials >> -* System Configuration:: Customizing the GNU System >> +* Packaging:: Packaging tutorials=2E >> +* System Configuration:: Customizing the GNU System=2E >> * Advanced package management:: Power to the users! >> -* Environment management:: Control environment >> +* Environment management:: Control environment=2E >> +* FAQ:: Commonly asked questions=2E > >Your commit should only add the period to your sentence; other >sentences should remain untouched (fixing them belongs in a separate >commit)=2E I should fix such things myself in other commits; probably I >won=E2=80=99t do it=2E > >Other than that, it is a nicely written patch=2E > >It seems the issue when running the commands from >`info "(guix)Building from Git"` is that the other menu > >> +@menu >> +* How do I clear my terminal screen? >> +@end menu > >does not contain double colons followed by a sentence like the other >@menu=2E > >Regards, >Florian > > > > ------YS9O4FDVDMP6HDWL535UWDK16IITY8 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable I think this is fine=2E The cookbook should recomm= end using Ctrl-L and suggest you can install clear with the ncurses package= =2E We get that question from time to time, so I think it belongs to a FAQ = :)

Le 8 novembre 2021 12:18:50 GMT-05:00,= "pelzflorian (Florian Pelz)" <pelzflorian@pelzflorian=2Ede> a =C3=A9= crit=C2=A0:
Disseminate, thank you for your work=2E=


On Mon, Nov 08, 2021 at 01:48:39PM +0000, Disseminate Dissent wrote=
:
Thanks for the commen=
ts Florian,

Added periods and removed whitespace=2E

In my ini=
tial Guix setup I was unable to clear the terminal with
neither `clear` =
nor C-l=2E Installing ncurses solved that issue and is
listed as a depen=
dency for GNU Readline=2E

Bash always enables readline =
as far as I can see=2E  Perhaps you used a
system that disabled C-l in t=
he ~/=2Einputrc file, which would also
disable it for a Guix-installed b=
ash?  Some Slackware users complain
about non-working C-l on stackoverfl=
ow=2E  Anyway I will leave this
patch for experienced guix commiters to =
decide; IMHO the clear command
should not be needed with Guix and the co=
okbook so far contains only
what can be done with Guix itself=2E  Even t=
hough I like the idea of a
FAQ section and am happy about new Guix contr=
ibutors such as you=2E

As for the patch:

On Mon, Nov 08, 2021=
 at 01:50:20PM +0000, Disseminate Dissent via Guix-patches via wrote:
 Corrected missing periods a=
nd whitespace=2E


You have not addressed this latter= passive Added instead of Add:

On Mon, Nov 08, 2021 at 10:29:00AM +0= 100, pelzflorian (Florian Pelz) wrote:
For the commit message, Guix uses the active voice =E2=80= =9CAdd a FAQ section
with =E2=80=A6=E2=80=9D=2E


* doc/guix-cookbook=2Etexi: Added FAQ s= ection=2E

Here too=2E

Then:

= On Mon, Nov 08, 2021 at 01:50:20PM +0000, Disseminate Dissent via Guix-patc= hes via wrote:
@menu * Scheme tutorials:: Meet your new favorite language!
-* P= ackaging:: Packaging tutorials
-* System Configuration= :: Customizing the GNU System
+* Packaging:: Pa= ckaging tutorials=2E
+* System Configuration:: Customizing the GN= U System=2E
* Advanced package management:: Power to the users!
-* E= nvironment management:: Control environment
+* Environment manageme= nt:: Control environment=2E
+* FAQ:: Common= ly asked questions=2E

Your commit should only add the p= eriod to your sentence; other
sentences should remain untouched (fixing = them belongs in a separate
commit)=2E I should fix such things myself i= n other commits; probably I
won=E2=80=99t do it=2E

Other than tha= t, it is a nicely written patch=2E

It seems the issue when running t= he commands from
`info "(guix)Building from Git"` is that the other menu=

+@menu
+* How d= o I clear my terminal screen?
+@end menu

does not co= ntain double colons followed by a sentence like the other
@menu=2E
Regards,
Florian




------YS9O4FDVDMP6HDWL535UWDK16IITY8-- From debbugs-submit-bounces@debbugs.gnu.org Mon Nov 08 19:21:35 2021 Received: (at 51538) by debbugs.gnu.org; 9 Nov 2021 00:21:35 +0000 Received: from localhost ([127.0.0.1]:59938 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mkEtK-0004y6-VU for submit@debbugs.gnu.org; Mon, 08 Nov 2021 19:21:35 -0500 Received: from mx1.dismail.de ([78.46.223.134]:10577) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mkEtJ-0004xr-Gq for 51538@debbugs.gnu.org; Mon, 08 Nov 2021 19:21:34 -0500 Received: from mx1.dismail.de (localhost [127.0.0.1]) by mx1.dismail.de (OpenSMTPD) with ESMTP id 986b63e9; Tue, 9 Nov 2021 01:21:25 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=dismail.de; h=date :message-id:from:to:cc:references:mime-version:content-type :content-transfer-encoding; s=20190914; bh=XpO3bgDDR83XSVwpY4gKD 12Jh8HxiMZcrJbjElxDifs=; b=oGZZUobv5vNYMgO26fls2S6Q/nUd/OuS1YO9E 5+DuLH2sQ3irionNeTqK7N9AWlcCuuvyX8k2yiOQ+1lo05mkTuITWkFw0yA0G1Ar boASEQpogjL4G1BZyJ1ICInX1183fFdhEmNvkxzASdDyoLI0RvrQ5pg4eRse8p3m A/qqYr7LtGfxFbC1sbMBdc/9n2PKp5JsDf8P4IEdbQ95mS3vwL56GS3MlJEPBCYo VCqJyGufvjcBFIZJxl/99SYjdetQKtntzBzq2ZSwmEN7asYqJgYlsnMLOGOYgdDe 4Mhwzyl1GcC3Ng/vw86OpBPo1uZ4MqdU88s89zgOs8NZGeYvA== Received: from smtp2.dismail.de ( [10.240.26.12]) by mx1.dismail.de (OpenSMTPD) with ESMTP id a040d00f; Tue, 9 Nov 2021 01:21:24 +0100 (CET) Received: from smtp2.dismail.de (localhost [127.0.0.1]) by smtp2.dismail.de (OpenSMTPD) with ESMTP id b15b1192; Tue, 9 Nov 2021 01:21:24 +0100 (CET) Received: by dismail.de (OpenSMTPD) with ESMTPSA id 7eabe59a (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO); Tue, 9 Nov 2021 01:21:23 +0100 (CET) Date: Mon, 8 Nov 2021 19:21:22 -0500 Message-ID: <20211108192122.GB20058@gac.attlocal.net> From: jgart To: 51538@debbugs.gnu.org References: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit X-Spam-Score: 1.3 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: I just wanted to mention that roptat added a nice entry for texinfo in learnxinyminutes series of sites: https://github.com/adambard/learnxinyminutes-docs/pull/4263 Hopefully it will get merged soon. Content analysis details: (1.3 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 SPF_PASS SPF: sender matches SPF record -0.7 RCVD_IN_DNSWL_LOW RBL: Sender listed at https://www.dnswl.org/, low trust [78.46.223.134 listed in list.dnswl.org] 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 1.8 MISSING_SUBJECT Missing Subject: header 0.2 NO_SUBJECT Extra score for no subject X-Debbugs-Envelope-To: 51538 Cc: Disseminate Dissent 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: 0.3 (/) I just wanted to mention that roptat added a nice entry for texinfo in learnxinyminutes series of sites: https://github.com/adambard/learnxinyminutes-docs/pull/4263 Hopefully it will get merged soon. I think this will help with lowering the barrier to entry for learning Texinfo as well as serve as a quick TLDR reference. From debbugs-submit-bounces@debbugs.gnu.org Thu Nov 11 12:04:20 2021 Received: (at 51538) by debbugs.gnu.org; 11 Nov 2021 17:04:20 +0000 Received: from localhost ([127.0.0.1]:42129 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mlDUp-00044W-Td for submit@debbugs.gnu.org; Thu, 11 Nov 2021 12:04:20 -0500 Received: from pelzflorian.de ([5.45.111.108]:33762 helo=mail.pelzflorian.de) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mlDUn-00044N-BY for 51538@debbugs.gnu.org; Thu, 11 Nov 2021 12:04:18 -0500 Received: from pelzflorian.localdomain (unknown [5.45.111.108]) by mail.pelzflorian.de (Postfix) with ESMTPSA id E7D643606B4; Thu, 11 Nov 2021 18:04:14 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=pelzflorian.de; s=mail; t=1636650256; bh=9l1BigQVEsddXUeMY0RNGF016hTAXeVb4re2uz8+uy4=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=SSjBTsxlpw9UXdUkJK7sD9fyUWzWu7R9JAskRtbg5gFO7SiwihYF8odBuJP0Sx9Jo 703dYWjgEzbexm4sBegl2o6vKHiMCvgShhQQ0nH2041Yxw7dIuiCb0T5wRB6N4ItT2 4BEGbfMwyGgovK9S//hE/jEBPDxqXT+eOq3wyY48= Date: Thu, 11 Nov 2021 18:04:06 +0100 From: "pelzflorian (Florian Pelz)" To: Julien Lepiller Subject: Re: [bug#51538] First Patch Submit Ever: Additions to the Cookbook Documentation Message-ID: <20211111170354.5hf57jssxoh2yg5s@pelzflorian.localdomain> References: <20211108171850.q6pqyiv4g5q2oktr@pelzflorian.localdomain> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 51538 Cc: Disseminate Dissent , 51538@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 (-) On Mon, Nov 08, 2021 at 02:04:12PM -0500, Julien Lepiller wrote: > Le 8 novembre 2021 12:18:50 GMT-05:00, "pelzflorian (Florian Pelz)" a écrit : > >Bash always enables readline as far as I can see. Perhaps you used a > >system that disabled C-l in the ~/.inputrc file, which would also > >disable it for a Guix-installed bash? Some Slackware users complain > >about non-working C-l on stackoverflow. Anyway I will leave this > >patch for experienced guix commiters to decide; IMHO the clear command > >should not be needed with Guix and the cookbook so far contains only > >what can be done with Guix itself. Even though I like the idea of a > >FAQ section and am happy about new Guix contributors such as you. > I think this is fine. The cookbook should recommend using Ctrl-L and > suggest you can install clear with the ncurses package. We get that > question from time to time, so I think it belongs to a FAQ :) One might expect terminal clearing with C-l or clear in an operating system manual, but is role of Guix to be an operating system? I’d think not, the manual/cookbook would blow up too much. A command to search what package provides the program clear is what belongs in the manual. Regards, Florian