From mboxrd@z Thu Jan  1 00:00:00 1970
From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=)
Subject: Re: FAQ
Date: Wed, 10 Jul 2013 15:28:28 +0200
Message-ID: <87vc4icznn.fsf@gnu.org>
References: <51D71116.3080403@BlueT.org> <87txk8sqc6.fsf@gnu.org>
	<51D768DE.90403@BlueT.org> <878v1jstco.fsf@gnu.org>
	<51D9F8EF.5050806@BlueT.org> <87li5hb71f.fsf@gnu.org>
	<51DAF2F0.5020100@BlueT.org> <871u78ahzj.fsf@gnu.org>
	<87ppusu3sv.fsf_-_@karetnikov.org> <87y59g6krw.fsf@gnu.org>
	<87bo6ba79m.fsf@karetnikov.org> <878v1fijqb.fsf@gnu.org>
	<87k3kzxyx7.fsf@karetnikov.org> <878v1fgxxl.fsf@gnu.org>
	<87ppuq2a7u.fsf@karetnikov.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:42183)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1UwuWS-0003P6-VN
	for guix-devel@gnu.org; Wed, 10 Jul 2013 09:33:35 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1UwuWR-0007Yp-Cc
	for guix-devel@gnu.org; Wed, 10 Jul 2013 09:33:32 -0400
Received: from hera.aquilenet.fr ([141.255.128.1]:60677)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <ludo@gnu.org>)
	id 1UwuWR-0007YX-7V
	for guix-devel@gnu.org; Wed, 10 Jul 2013 09:33:31 -0400
In-Reply-To: <87ppuq2a7u.fsf@karetnikov.org> (Nikita Karetnikov's message of
	"Wed, 10 Jul 2013 10:35:49 +0400")
List-Id: <guix-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/guix-devel>
List-Post: <mailto:guix-devel@gnu.org>
List-Help: <mailto:guix-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=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: Nikita Karetnikov <nikita@karetnikov.org>
Cc: guix-devel@gnu.org

Nikita Karetnikov <nikita@karetnikov.org> skribis:

> +* Building from Git
> +
> +The following errors might appear if you are building from Git.  Also,
> +take a look at the [[https://gnu.org/software/guix/manual/guix.html#Inst=
allation]["Installation"]] section of the manual and the
> +[[http://git.savannah.gnu.org/cgit/guix.git/tree/README]["Installing Gui=
x from Guix"]] section in 'README'.

Sorry if I wasn=E2=80=99t clear.  What I meant is: instead of presenting it=
 as a
trial-and-error approach, I would rather present it as a sequence of
instructions to build from Git.

Something like:

  First, make sure Autoconf (>=3D 2.69), Automake, pkg-config, etc. are
  installed.  If you get an error like this:

    ./configure: line 6755: `PKG_CHECK_MODULES(GUILE, guile-2.0 >=3D 2.0.5)'

  then it probably means that pkg-config=E2=80=99s pkg.m4 file was not foun=
d by
  Automake.  Make sure pkg.m4 is available, and possibly add its
  directory to the ACLOCAL_PATH environment variable (info "(automake)
  Macro Search Path").

  Second, run ./bootstrap.  Among other things, this will run =E2=80=98git
  submodule update=E2=80=99.  If you get an error like this:

    ...

Also, when referring to a GNU manual, please show the info command (as I
did above) rather than giving a hyperlink.  This will ensure that users
read the right version of the manual.

For the link to README, just use [[./README][README]] (info "(org)
Hyperlinks").


It may look like I=E2=80=99m being picky, and indeed that=E2=80=99s what I =
am ;-), but I
think it=E2=80=99s important to agree on how to present information.

Thanks for your help!

Ludo=E2=80=99.