diff mbox series

[bug#46956] PATCH] doc: Add information about mirrors.

Message ID VMOh2B0vnOBG1R21y5ugyX_wNy-9pyxf_iu4Y8fYvH53soFyHRIhtucpCvIUz5wqmAqJY18H02I_6muYmJrPjpdaz6ccqve9iHFgR5-5sds=@protonmail.com
State New
Headers show
Series [bug#46956] PATCH] doc: Add information about mirrors. | expand

Checks

Context Check Description
cbaines/applying patch fail View Laminar job
cbaines/issue success View issue

Commit Message

raid5atemyhomework Aug. 10, 2021, 11:55 a.m. UTC
As requested by Xinglu.

Also the original patch has bitrotted and no longer apply to latest master, fixed that as well.

--

From 9eeeeb888c3cdd1a788d2a2646c1baf4cd0d7c09 Mon Sep 17 00:00:00 2001
From: raid5atemyhomework <raid5atemyhomework@protonmail.com>
Date: Tue, 10 Aug 2021 19:52:31 +0800
Subject: [PATCH] [PATCH] doc: Add information about mirrors.

* doc.texi (Getting Substitutes from Other Servers): Add a list of
mirror substitute servers.
(Using a Custom Guix Channel): Add a list of mirror Guix repositories.
---
 doc/guix.texi | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

--
2.32.0

Comments

Xinglu Chen Aug. 10, 2021, 2:03 p.m. UTC | #1
On Tue, Aug 10 2021, raid5atemyhomework via Guix-patches via wrote:

> As requested by Xinglu.
>
> Also the original patch has bitrotted and no longer apply to latest
> master, fixed that as well.

The patch LGTM, but I don’t have commit access, so you will have to wait
for someone else to merge it.  :-)
Simon Tournier Aug. 17, 2021, 11:20 a.m. UTC | #2
Hi,

I have not followed closely the discussion so maybe I am off topic.

On Tue, 10 Aug 2021 at 11:55, raid5atemyhomework via Guix-patches via <guix-patches@gnu.org> wrote:

> +Below is a list of available substitute servers for the Guix distribution
> +channel; you can add a mirror that is nearer to you if you find that the
> +official Guix substitute server is slow:
> +
> +@itemize
> +@item @code{https://mirror.sjtu.edu.cn/guix} - China, SJTU.
> +@item @code{https://ci.guix.gnu.org} - Germany, official Guix server.
> +You should always add this as a substitute URL as a fallback.
> +@item @code{https://bordeaux.guix.gnu.org} - France, official Guix
> +server.  You should always add this as a substitute URL as a
> +fallback.
> +@end itemize

From my understanding bordeaux builds by its own and ci too, i.e., they
are not really a mirror from each other.  But the last is a real
mirror––from ci I guess.

It implies that the user does not necessary get the same binaries if the
build is not reproducible.

Well, my point is: the word «mirror» from the sentence «you can add a
mirror that is nearer…» should be «server» and the documentation should
not talk about mirror here, IMHO.  If my understanding is correct. :-)



> +@item @code{https://github.com/guix-mirror/guix} branch @code{master}
> +- USA, unofficial mirror.

Who is behind this mirror?  Well, I am not sure what means USA here.


All the best,
simon
diff mbox series

Patch

diff --git a/doc/guix.texi b/doc/guix.texi
index 4eb5324b51..031ec782e1 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -94,6 +94,7 @@  Copyright @copyright{} 2021 Xinglu Chen@*
 Copyright @copyright{} 2021 Raghav Gururajan@*
 Copyright @copyright{} 2021 Domagoj Stolfa@*
 Copyright @copyright{} 2021 Hui Lu@*
+Copyright @copyright{} 2021 raid5atemyhomework@*

 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -3902,6 +3903,20 @@  can list as many substitute servers as you like, with the caveat that
 substitute lookup can be slowed down if too many servers need to be
 contacted.

+Below is a list of available substitute servers for the Guix distribution
+channel; you can add a mirror that is nearer to you if you find that the
+official Guix substitute server is slow:
+
+@itemize
+@item @code{https://mirror.sjtu.edu.cn/guix} - China, SJTU.
+@item @code{https://ci.guix.gnu.org} - Germany, official Guix server.
+You should always add this as a substitute URL as a fallback.
+@item @code{https://bordeaux.guix.gnu.org} - France, official Guix
+server.  You should always add this as a substitute URL as a
+fallback.
+@end itemize
+
+
 Note that there are also situations where one may want to add the URL of
 a substitute server @emph{without} authorizing its key.
 @xref{Substitute Authentication}, to understand this fine point.
@@ -5095,6 +5110,19 @@  From there on, @command{guix pull} will fetch code from the @code{super-hacks}
 branch of the repository at @code{example.org}.  The authentication concern is
 addressed below ((@pxref{Channel  Authentication}).

+Below is a list of available mirrors of the @code{guix} repository; you can
+replace the @code{guix} channel with one that is nearer to you if you find
+that the official @code{guix} repository is slow:
+
+@itemize
+@item @code{https://git.savannah.gnu.org/git/guix.git} branch @code{master}
+- USA, Official Guix.
+@item @code{https://github.com/guix-mirror/guix} branch @code{master}
+- USA, unofficial mirror.
+@item @code{https://mirror.sjtu.edu.cn/git/guix.git} branch @code{master}
+- China, SJTU, not available over TOR.
+@end itemize
+
 @node Replicating Guix
 @section Replicating Guix