From patchwork Thu Oct 24 03:50:54 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kyle Andrews X-Patchwork-Id: 15812 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 886A61764C; Thu, 24 Oct 2019 04:52:10 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_MSPIKE_H2,T_DKIM_INVALID,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.0 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTP id 4416417648 for ; Thu, 24 Oct 2019 04:52:10 +0100 (BST) Received: from localhost ([::1]:57866 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iNUAT-0001BB-Lt for patchwork@mira.cbaines.net; Wed, 23 Oct 2019 23:52:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54727) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iNUAN-0001AP-K3 for guix-patches@gnu.org; Wed, 23 Oct 2019 23:52:04 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iNUAM-0003iz-G1 for guix-patches@gnu.org; Wed, 23 Oct 2019 23:52:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:54642) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iNUAM-0003is-Ct for guix-patches@gnu.org; Wed, 23 Oct 2019 23:52:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iNUAM-0001UP-9V for guix-patches@gnu.org; Wed, 23 Oct 2019 23:52:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#37898] [PATCH] small improvement to documentation Resent-From: Kyle Andrews Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 24 Oct 2019 03:52:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 37898 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 37898@debbugs.gnu.org X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.15718890715655 (code B ref -1); Thu, 24 Oct 2019 03:52:02 +0000 Received: (at submit) by debbugs.gnu.org; 24 Oct 2019 03:51:11 +0000 Received: from localhost ([127.0.0.1]:35230 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iNU9V-0001T7-1E for submit@debbugs.gnu.org; Wed, 23 Oct 2019 23:51:11 -0400 Received: from lists.gnu.org ([209.51.188.17]:52058) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iNU9Q-0001Sw-5L for submit@debbugs.gnu.org; Wed, 23 Oct 2019 23:51:07 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54040) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iNU9O-0000JW-KA for guix-patches@gnu.org; Wed, 23 Oct 2019 23:51:03 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iNU9M-0002vp-Tk for guix-patches@gnu.org; Wed, 23 Oct 2019 23:51:02 -0400 Received: from mail-il1-x12b.google.com ([2607:f8b0:4864:20::12b]:43669) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iNU9K-0002tZ-Vm for guix-patches@gnu.org; Wed, 23 Oct 2019 23:50:59 -0400 Received: by mail-il1-x12b.google.com with SMTP id t5so21015801ilh.10 for ; Wed, 23 Oct 2019 20:50:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=user-agent:from:to:subject:date:message-id:mime-version; bh=gf+Uax3NE74F0rQtpkRC1N5/oig1/BNkD6eXG+NlmMs=; b=c0p6sfZhjACTNwXB0Udv9y0xuV9lvIUL6DkJ7LSwa+aHl6v0j5weADEgzZ0L10Y7r/ GZidsb8z7rjkxAKp/z67+9Cu5BPMd4q/vfdx2Oqbi5cOfAi4Ws2vHCQ6zumilfeNPeMi oSjVYzVFB7wS4R0mjKNoiTZT+fpPf4e9YFXywUAfuQ7+Norkx+B2mC/PjIdywirzuUcD E2g9n0vPMrfw+aLvOvuiQ1yR7zxRYzMcfX9X5fr58f513tYAxDrep6FLhdqT5FvaOLkE iawlEdm3NErewlm52f9sc4v6gTR/lg3/Cjp03ieMoWnRRLcKq2ew4jRwOT0O7lErAncs kWoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:user-agent:from:to:subject:date:message-id :mime-version; bh=gf+Uax3NE74F0rQtpkRC1N5/oig1/BNkD6eXG+NlmMs=; b=R1ywhUeiRAW127EGh8/7ORW9DAkDMQnKL8Fzr0TfgrtzhqieoyZdip1zLC85z5jUrO uMKyWN7tV4DrVUHL/x4MspaJhKpuLnf1Ck+Bub6uz276rcgnpDDpZYKhuV4zEON+hURp jjsCEWpm8NT3vu7jKrvZy2XmFjDlN+JtrTB0tsiXYwFHFNFOixTOWfVdMkc+817WTxlb klzyLYhv4t77hLfAiVnTGgsgtqGLWi8TkHzM6qQkR1VNDZRIZOnMHm2ES6HyINq4wF81 0MRDBatrp84HUKbMTSlg99nUAxdXvjgggj/WHbj9WQlrs1cyvXp21PEMmu9GPvP5Gi+A bNIw== X-Gm-Message-State: APjAAAUz2K9V7MTrV9bH0CbpU5wcbDHmjaQTTrxs48ER+UvFrXx8QKvI pVmIRn7P7+IDLaTJccdOrXWdTrMv878= X-Google-Smtp-Source: APXvYqwd/24GinR1yidwGObOESlKzZisXFHc7exa/5tg6pFPkHNah10sLljKLawU9rxMbAJFO2fJUA== X-Received: by 2002:a92:c80b:: with SMTP id v11mr39079867iln.62.1571889056090; Wed, 23 Oct 2019 20:50:56 -0700 (PDT) Received: from x1 (71-82-69-114.dhcp.bycy.mi.charter.com. [71.82.69.114]) by smtp.gmail.com with ESMTPSA id k17sm4175059ioh.49.2019.10.23.20.50.55 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 23 Oct 2019 20:50:55 -0700 (PDT) User-agent: mu4e 1.2.0; emacs 26.3 From: Kyle Andrews Date: Wed, 23 Oct 2019 23:50:54 -0400 Message-ID: <871rv2er8h.fsf@gmail.com> MIME-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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 Hi Guix, I am working my way through installing Guix on a system using the "manual" method and wanted to help improve the documentation. I find it difficult to read bash commands which make use of cryptic short argument flags, so I have taken the liberty of replacing one such instance of that in the manual with a human readable equivalent. Also, following, the principle of parallel construction I included an example of how to bring a network device up using ip in addition to ifconfig. Please see the patch below: --8<---------------cut here---------------start------------->8--- From ff3c71cad60c50812bdf6d561a24ed59fb2e26bc Mon Sep 17 00:00:00 2001 From: Kyle Andrews Date: Wed, 23 Oct 2019 23:24:11 -0400 Subject: [PATCH] * doc/guix: Use human readable arguments for ip command. --- doc/guix.texi | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) -- 2.23.0 --8<---------------cut here---------------end--------------->8--- diff --git a/doc/guix.texi b/doc/guix.texi index 6703c2756c..ff12a1bb51 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -66,6 +66,7 @@ Copyright @copyright{} 2019 Josh Holland@* Copyright @copyright{} 2019 Diego Nicola Barbato@* Copyright @copyright{} 2019 Ivan Petkov@* Copyright @copyright{} 2019 Jakob L. Kreuze@* +Copyright @copyright{} 2019 Kyle Andrews@* Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -2110,7 +2111,7 @@ ifconfig -a @dots{} or, using the GNU/Linux-specific @command{ip} command: @example -ip a +ip address @end example @c https://cgit.freedesktop.org/systemd/systemd/tree/src/udev/udev-builtin-net_id.c#n20 @@ -2128,6 +2129,13 @@ To configure a wired network run the following command, substituting ifconfig @var{interface} up @end example +@noindent +@dots{} or, using the GNU/Linux-specific @command{ip} command: + +@example +ip link set @var{interface} up +@end example + @item Wireless connection @cindex wireless @cindex WiFi