From mboxrd@z Thu Jan 1 00:00:00 1970 From: Vincent Legoll Subject: Re: Documentation Date: Fri, 2 Sep 2016 18:45:37 +0200 Message-ID: References: <20160902160834.GA24996@jasmine> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:59069) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bfrb3-0001cL-Em for help-guix@gnu.org; Fri, 02 Sep 2016 12:45:42 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bfrb1-00052k-90 for help-guix@gnu.org; Fri, 02 Sep 2016 12:45:40 -0400 Received: from mail-qt0-x22d.google.com ([2607:f8b0:400d:c0d::22d]:34026) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bfrb1-00052d-1W for help-guix@gnu.org; Fri, 02 Sep 2016 12:45:39 -0400 Received: by mail-qt0-x22d.google.com with SMTP id 38so22316745qte.1 for ; Fri, 02 Sep 2016 09:45:38 -0700 (PDT) In-Reply-To: <20160902160834.GA24996@jasmine> List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org Sender: "Help-Guix" To: Leo Famulari Cc: help-guix Thanks for the answers, still no joy for me... On Fri, Sep 2, 2016 at 6:08 PM, Leo Famulari wrote: > On Fri, Sep 02, 2016 at 05:45:02PM +0200, Vincent Legoll wrote: >> when & how is the documentation here : >> https://www.gnu.org/software/guix/manual/guix.html >> updated ? > > I'm not sure, but I think it's updated whenever we make a new release. > >> Then I searched how to build the doc, and found in README: >> >> See the manual for the installation instructions, either by running >> >> info -f doc/guix.info "(guix) Installation" >> >> but... >> >> info: doc/guix.info: No such file or directory > > 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... >> 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` I don't have guix installed on this system, see below: > Similarly, you can do `make doc/guix.html`. $ make doc/guix.html make: *** No rule to make target `doc/guix.html'. Stop. The configure script is not working here (ubuntu 14.04) bare git checkout, see below... > If the Git checkout is new, you will need to run the ./configure script > first. And if so, you almost always want to do it like this: > > `./configure --localstatedir=/var`. $ git status On branch master Your branch is up-to-date with 'origin/master'. nothing to commit, working directory clean $ ./configure --localstatedir=/var configure: error: cannot find install-sh, install.sh, or shtool in build-aux "."/build-aux -- Vincent Legoll