unofficial mirror of guix-patches@gnu.org 
 help / color / mirror / code / Atom feed
From: Steven vanZyl <rushsteve1@rushsteve1.us>
To: 40648@debbugs.gnu.org
Cc: Steven vanZyl <rushsteve1@rushsteve1.us>
Subject: [bug#40648] [PATCH] Add subsections to the Binary Installation section
Date: Wed, 15 Apr 2020 15:52:10 -0400	[thread overview]
Message-ID: <20200415195210.30157-1-rushsteve1@rushsteve1.us> (raw)

Break the Binary Installation section of the manual into two
subsections: Installation Script, and Manual Installation. With an
example for the Installation Script.

This serves to highlight the existence of the installation script as
the recommended way of installing Guix and provide an example of its
usage for users.

Additionally altered an example systemd command in the Manual
Installation section to turn two commands into one by using the --now
flag instead of calling start then enable.

Signed-off-by: Steven vanZyl <rushsteve1@rushsteve1.us>
---
This is my first patch submission to Guix so I am rather new at this.
If I have made any mistakes please let me know and I will endeavor to
correct them as soon as possible.

 doc/guix.texi | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index ef5f68db24..8490977bd9 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -77,6 +77,7 @@ Copyright @copyright{} 2020 Jakub Kądziołka@*
 Copyright @copyright{} 2020 Jack Hill@*
 Copyright @copyright{} 2020 Naga Malleswari@*
 Copyright @copyright{} 2020 Brice Waegeneire@*
+Copyright @copyright{} 2020 Steven vanZyl@*
 
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -542,13 +543,25 @@ is described in the next sections.  The only requirement is to have
 GNU@tie{}tar and Xz.
 
 @c Note duplicated from the ``Installation'' node.
-@quotation Note
+@subsection Installation Script
+
 We recommend the use of this
 @uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh,
 shell installer script}.  The script automates the download, installation, and
 initial configuration steps described below.  It should be run as the root
 user.
-@end quotation
+
+@example
+# cd /tmp/
+# wget https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh
+# chmod +x guix-install.sh
+# ./guix-install.sh
+@end example
+
+The script will then proceede to download and install GNU Guix,
+occasionally prompting you for confirmation of settings.
+
+@subsection Manual Installation
 
 Installing goes along these lines:
 
@@ -651,7 +664,7 @@ with these commands:
 @example
 # cp ~root/.config/guix/current/lib/systemd/system/guix-daemon.service \
      /etc/systemd/system/
-# systemctl start guix-daemon && systemctl enable guix-daemon
+# systemctl enable --now guix-daemon
 @end example
 
 If your host distro uses the Upstart init system:
-- 
2.26.0

             reply	other threads:[~2020-04-15 20:05 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-04-15 19:52 Steven vanZyl [this message]
2020-04-19 11:27 ` bug#40648: [PATCH] Add subsections to the Binary Installation section Ludovic Courtès

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://guix.gnu.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20200415195210.30157-1-rushsteve1@rushsteve1.us \
    --to=rushsteve1@rushsteve1.us \
    --cc=40648@debbugs.gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).