GNU bug report logs - #41565
[PATCH] doc: Use existing URLs and file names in installation instructions.

Previous Next

Package: guix-patches;

Reported by: Julien Lepiller <julien <at> lepiller.eu>

Date: Wed, 27 May 2020 15:31:01 UTC

Severity: normal

Tags: patch

Done: Julien Lepiller <julien <at> lepiller.eu>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Julien Lepiller <julien <at> lepiller.eu>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#41565: closed ([PATCH] doc: Use existing URLs and file names
 in installation instructions.)
Date: Wed, 27 May 2020 21:30:04 +0000
[Message part 1 (text/plain, inline)]
Your message dated Wed, 27 May 2020 23:29:11 +0200
with message-id <20200527232911.74e8c406 <at> tachikoma.lepiller.eu>
and subject line Re: [bug#41565] [PATCH] doc: Use existing URLs and file names in installation instructions.
has caused the debbugs.gnu.org bug report #41565,
regarding [PATCH] doc: Use existing URLs and file names in installation instructions.
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
41565: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=41565
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
From: Julien Lepiller <julien <at> lepiller.eu>
To: guix-patches <at> gnu.org
Subject: [PATCH] doc: Use existing URLs and file names in installation
 instructions.
Date: Wed, 27 May 2020 17:30:13 +0200
[Message part 3 (text/plain, inline)]
Some users seem to be confused by the fact that our URLs in the manual
don't work for them.  This is most likely because they copy them
without reading the rest of the text which clearly says they should
replace @var{system} with one of the supported values.  One example of
this confusion is this conversation:
https://mastodon.social/@Nixfreak/104224784493287104

Since our current approach doesn't seem to be very effective, I propose
to change the URLs and file names with actual ones, using x86_64-linux
as the system because this is the most popular platform that we support
nowadays.  I keep mentioning the other architectures as alternatives,
hoping that users will notice the x86_64 in the URL and keep reading to
learn how to install Guix for another architecture if they want to.

Wdyt?
[0001-doc-Use-existing-URLs-and-file-names-in-installation.patch (text/x-patch, attachment)]
[Message part 5 (message/rfc822, inline)]
From: Julien Lepiller <julien <at> lepiller.eu>
To: 41565-done <at> debbugs.gnu.org
Subject: Re: [bug#41565] [PATCH] doc: Use existing URLs and file names in
 installation instructions.
Date: Wed, 27 May 2020 23:29:11 +0200
Le Wed, 27 May 2020 22:44:44 +0200,
Marius Bakke <marius <at> gnu.org> a écrit :

> Julien Lepiller <julien <at> lepiller.eu> writes:
> 
> > Wdyt?  
> 
> Sgtm.
> 
> [...]
> 
> > -@indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.@var{system}.tar.xz},
> > -where @var{system} is @code{x86_64-linux} for an @code{x86_64}
> > machine -already running the kernel Linux, and so on.
> > +@indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.x86_64-linux.tar.xz},
> > +where @code{x86_64-linux} can be replaced with @code{xi686-linux}
> > for an  
>                                                        ^^^ stray 'x'


Pushed as f18d5d75979f5374962c03a8f3c266054a489e11 with this fix, a
copyright line for me and an improved commit message.

Thank you!


This bug report was last modified 4 years and 361 days ago.

Previous Next


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