GNU bug report logs - #77512
Bug in documentation on building from git

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 77512 in the body.
You can then email your comments to 77512 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "nomike (they/them)" <nomike <at> nomike.com>
To: bug-guix <at> gnu.org
Subject: Bug in documentation on building from git
Date: Fri, 4 Apr 2025 00:58:58 +0200

Hi!

I'm relatively new to guix and I'm walking trough [Building from git](0) 
right now.

It says to run `make authenticate` towards the end, but this only leads 
into make complaining:

> make: *** No rule to make target 'authenticate'.  Stop.

In `NEWS` it is stated that the is the "new" `guix git authenticate` has 
been added in version 1.2.0, which seems to have been released ~ 5 years 
ago.
So I guess the documentation is just outdated.

cheers

nomike

(0) https://guix.gnu.org/manual/en/html_node/Building-from-Git.html

Message #10 received at 77512-done <at> debbugs.gnu.org (full text, mbox):

From: John Kehayias <john.kehayias <at> protonmail.com>
To: "nomike (they/them)" <nomike <at> nomike.com>
Cc: 77512-done <at> debbugs.gnu.org
Subject: Re: bug#77512: Bug in documentation on building from git
Date: Fri, 04 Apr 2025 00:46:05 +0000

Hello,

On Fri, Apr 04, 2025 at 12:58 AM, nomike (they/them) wrote:

> Hi!
>
> I'm relatively new to guix and I'm walking trough [Building from
> git](0) right now.
>
> It says to run `make authenticate` towards the end, but this only
> leads into make complaining:
>
>> make: *** No rule to make target 'authenticate'.  Stop.
>
> In `NEWS` it is stated that the is the "new" `guix git authenticate`
> has been added in version 1.2.0, which seems to have been released ~ 5
> years ago.
> So I guess the documentation is just outdated.
>
> cheers
>
> nomike
>
> (0) https://guix.gnu.org/manual/en/html_node/Building-from-Git.html

Yes, you are reading the old manual (corresponding to the 1.4.0 release
of Guix). Once you run 'guix pull' you are on the latest commit of Guix.
The manual is then
<https://guix.gnu.org/manual/devel/en/html_node/Building-from-Git.html>.
Note the "devel" which you will also get to by following the "GNU Guix
Manual (latest)" link from the Help menu on the project webpage.

Yes, this is confusing, and yes it is known, but unfortunately not made
clear on the documentation site.

Sorry about that!

I'll go ahead and close this in favor of other instances of this problem
and I think some possible patches that we need to revive (but I don't
have the number off the top of my head).

John

Message #13 received at 77512 <at> debbugs.gnu.org (full text, mbox):

From: Tomas Volf <~@wolfsden.cz>
To: "nomike (they/them)" <nomike <at> nomike.com>
Cc: 77512 <at> debbugs.gnu.org
Subject: Re: bug#77512: Bug in documentation on building from git
Date: Sun, 06 Apr 2025 14:46:38 +0200

"nomike (they/them)" <nomike <at> nomike.com> writes:

> (0) https://guix.gnu.org/manual/en/html_node/Building-from-Git.html

You are reading the manual for the last stable release (1.4.0), which is
bit old by now.  Can you see whether you get into the same problem when
trying to follow the current ("devel") manual located here:

  https://guix.gnu.org/manual/devel/en/html_node/Building-from-Git.html

Tomas

-- 
There are only two hard things in Computer Science:
cache invalidation, naming things and off-by-one errors.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.