unofficial mirror of guix-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: Matt <matt@excalamus.com>
To: "Philip McGrath" <philip@philipmcgrath.com>
Cc: "guix-devel" <guix-devel@gnu.org>
Subject: Re: git send-email
Date: Sun, 19 Nov 2023 18:30:02 +0100	[thread overview]
Message-ID: <18be8a1d637.f14ae7c03485097.4515500602051837697@excalamus.com> (raw)
In-Reply-To: <441f7ab5-8e71-4579-bb9a-034f3b0cb9f1@app.fastmail.com>


 ---- On Sun, 19 Nov 2023 17:22:47 +0100  Philip McGrath  wrote --- 

 >  2. I wish there were a Guix package I could install to read the HTML documentation locally.

This is probably the simplest way:

1. guix shell wget
2. wget https://guix.gnu.org/manual/en/guix.html

According to the docs (https://guix.gnu.org/en/manual/devel/en/html_node/Writing-Documentation.html), the following should work (but doesn't for me):

1. git clone https://git.savannah.gnu.org/git/guix.git
2. cd guix
3. guix shell -D guix --pure
4. ./bootstrap
5. ./configure --localstatedir=/var --sysconfdir=/etc
6. make doc/guix.html

It fails with:

 MAKEINFO doc/guix.html
guix.texi:16880: @include: could not find os-config-bare-bones.texi
guix.texi:17057: @include: could not find os-config-desktop.texi
guix.texi:17064: @include: could not find os-config-lightweight-desktop.texi
make: *** [Makefile:4988: doc/guix.html] Error 1

It's worth noting that the Writing Documentation page links to Running Guix Before It Is Installed (https://guix.gnu.org/en/manual/devel/en/html_node/Running-Guix-Before-It-Is-Installed.html) when it probably meant to link the previous section Building from Git (https://guix.gnu.org/en/manual/devel/en/html_node/Building-from-Git.html) since it mentions needing to run ./configure first.

My guess is that the above steps will work if you run make before running make doc/guix.html.


      parent reply	other threads:[~2023-11-19 17:30 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-11-18 13:58 git send-email Nicolas Débonnaire
2023-11-18 17:26 ` Jack Hill
2023-11-19 15:59   ` Nicolas Débonnaire
2023-11-19 16:22     ` Philip McGrath
2023-11-19 17:27       ` Felix Lechner via Development of GNU Guix and the GNU System distribution.
2023-11-19 17:30         ` Philip McGrath
2023-11-19 17:30       ` Matt [this message]

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=18be8a1d637.f14ae7c03485097.4515500602051837697@excalamus.com \
    --to=matt@excalamus.com \
    --cc=guix-devel@gnu.org \
    --cc=philip@philipmcgrath.com \
    /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).