From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mathieu Lirzin Subject: Re: 2 (possible) problems in documentation Date: Sun, 01 Nov 2015 16:30:47 +0100 Message-ID: <87611lg2jc.fsf@gnu.org> References: <87wpu2kaa3.fsf@gmail.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:48337) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zsuat-0002vl-5x for guix-devel@gnu.org; Sun, 01 Nov 2015 10:30:56 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Zsuao-0005Pw-5G for guix-devel@gnu.org; Sun, 01 Nov 2015 10:30:55 -0500 In-Reply-To: (Alex Vong's message of "Sun, 1 Nov 2015 11:22:00 +0800") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: Alex Vong Cc: guix-devel@gnu.org, Alex Kost --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi, Alex Vong writes: > On 01/11/2015, Alex Kost wrote: >> I think this on-line manual is for the current version (0.8.3). The >> typo you mention was fixed in the git repo: >> >> > Thanks! I wasn't aware that the web version not being up to date. The online manual is up to date with the current release but not with the master branch. Maybe we could provide a link to it like Guile: https://www.gnu.org/software/guile/docs/docs.html > What I mean is "guix pull" only works after Guix is installed, so what > the documentation says, "To that end, all the command-line tools can > be used even if you have not run make install", is inaccurate. Should > we note this in the documentation? I think you mean that =E2=80=98pre-inst-env guix pull=E2=80=99 does not wor= k if you have not run =E2=80=98make install=E2=80=99 before? What do you think of the fo= llowing patch? --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-doc-Add-an-exception-in-Running-Guix-Before-It-Is-In.patch >From ee2f4467d84ad9516b14c7bd14f821e4bec443cc Mon Sep 17 00:00:00 2001 From: Mathieu Lirzin Date: Sun, 1 Nov 2015 16:27:07 +0100 Subject: [PATCH] doc: Add an exception in "Running Guix Before It Is Installed". * doc/contributing.texi (Running Guix Before It Is Installed): Add an exception footnote for `guix pull'. Suggested-by: Alex Vong --- doc/contributing.texi | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index f855daf..d033b1f 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -72,8 +72,9 @@ test the changes made in your local source tree checkout without actually installing them. So that you can distinguish between your ``end-user'' hat and your ``motley'' costume. -To that end, all the command-line tools can be used even if you have not -run @code{make install}. To do that, prefix each command with +To that end, all the command-line tools@footnote{@code{guix pull} is an +exception (@pxref{Invoking guix pull}).} can be used even if you have +not run @code{make install}. To do that, prefix each command with @command{./pre-inst-env} (the @file{pre-inst-env} script lives in the top build tree of Guix), as in: -- 2.6.1 --=-=-= Content-Type: text/plain Thanks, -- Mathieu Lirzin --=-=-=--