From mboxrd@z Thu Jan  1 00:00:00 1970
From: Leo Famulari <leo@famulari.name>
Subject: Re: Documentation
Date: Fri, 2 Sep 2016 13:09:41 -0400
Message-ID: <20160902170941.GA29674@jasmine>
References: <CAEwRq=rMnT55mFVXEbvsgFGobmXd+ij5RWdXJ2ODzNmvqfDT2w@mail.gmail.com>
	<20160902160834.GA24996@jasmine>
	<CAEwRq=r562f9APrOP1m=nYUH_Rb7-RMsOmyc-3NcVkDqDr+Uhg@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Return-path: <help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:35356)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <leo@famulari.name>) id 1bfryY-0003IX-1b
	for help-guix@gnu.org; Fri, 02 Sep 2016 13:09:59 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <leo@famulari.name>) id 1bfryT-0001ZU-KH
	for help-guix@gnu.org; Fri, 02 Sep 2016 13:09:56 -0400
Received: from out4-smtp.messagingengine.com ([66.111.4.28]:46246)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <leo@famulari.name>) id 1bfryR-0001W5-Ix
	for help-guix@gnu.org; Fri, 02 Sep 2016 13:09:53 -0400
Content-Disposition: inline
In-Reply-To: <CAEwRq=r562f9APrOP1m=nYUH_Rb7-RMsOmyc-3NcVkDqDr+Uhg@mail.gmail.com>
List-Id: <help-guix.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/help-guix>,
	<mailto:help-guix-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/help-guix/>
List-Post: <mailto:help-guix@gnu.org>
List-Help: <mailto:help-guix-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/help-guix>,
	<mailto:help-guix-request@gnu.org?subject=subscribe>
Errors-To: help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org
Sender: "Help-Guix" <help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org>
To: Vincent Legoll <vincent.legoll@gmail.com>
Cc: help-guix <help-guix@gnu.org>

On Fri, Sep 02, 2016 at 06:45:37PM +0200, Vincent Legoll wrote:
> > On GuixSD, `info guix` should work. On other systems...
> 
> That works, but I cannot find what I'm searching for: libressl, that
> I can see with (in a current git checkout) :
> 
> $ git grep libressl
> [...]
> doc/guix.texi:(define libressl-instead-of-openssl
> doc/guix.texi:  (package-input-rewriting `((,openssl . ,libressl))))
> doc/guix.texi:(define git-with-libressl
> doc/guix.texi:  (libressl-instead-of-openssl git))
> doc/guix.texi:with @var{libressl}.  Then we use it to define a
> @dfn{variant} of the
> doc/guix.texi:@var{git} package that uses @var{libressl} instead of
> @var{openssl}.
> 
> What am I missing ?
> Or maybe I'm very bad at info, always found its interface weird...

I'm not sure, I actually don't use `info` very much either. Maybe your
GuixSD installation has not been updated since the relevant text was
added to the manual?

> >> So how do I make that doc so that I can read the "installation
> >> instructions" which will tell me how to make the doc...
> >
> > ... from a checkout of our Git repo, you can do:
> >
> > `guix environment guix -- make doc/guix.info`

> nothing to commit, working directory clean
> $ ./configure --localstatedir=/var
> configure: error: cannot find install-sh, install.sh, or shtool in
> build-aux "."/build-aux

Sorry, I forgot the first step, `./bootstrap`, which is mentioned here:

https://www.gnu.org/software/guix/manual/html_node/Building-from-Git.html#Building-from-Git