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

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

[raid5atemyhomework via Guix-patches via]

Closes: 46942


From 63bcc0750248369b2171409168fd200e3841f0a5 Mon Sep 17 00:00:00 2001
From: raid5atemyhomework <raid5atemyhomework@protonmail.com>
Date: Sat, 6 Mar 2021 09:12:53 +0800
Subject: [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 | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 464c1141d8..d4582b009f 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -86,6 +86,7 @@ Copyright @copyright{} 2020 raingloom@*
 Copyright @copyright{} 2020 Daniel Brooks@*
 Copyright @copyright{} 2020 John Soo@*
 Copyright @copyright{} 2020 Jonathan Brielmaier@*
+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
@@ -3879,6 +3880,16 @@ as a fallback.  Of course you 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 the last 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.
@@ -5072,6 +5083,17 @@ 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://mirror.sjtu.edu.cn/git/guix.git} branch @code{master}
+- China, SJTU.
+@item @code{https://git.savannah.gnu.org/git/guix.git} branch @code{master}
+- USA, Official Guix.
+@end itemize
+
 @node Replicating Guix
 @section Replicating Guix

--
2.30.1

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

[raid5atemyhomework via Guix-patches via]

Bump.

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

[raid5atemyhomework via Guix-patches via]

BUMP

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

[Xinglu Chen]

[-- Attachment #1: Type: text/plain, Size: 3283 bytes --]

On Sat, Mar 06 2021, raid5atemyhomework via Guix-patches via wrote:

> Closes: 46942
>
>
> From 63bcc0750248369b2171409168fd200e3841f0a5 Mon Sep 17 00:00:00 2001
> From: raid5atemyhomework <raid5atemyhomework@protonmail.com>
> Date: Sat, 6 Mar 2021 09:12:53 +0800
> Subject: [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 | 22 ++++++++++++++++++++++
>  1 file changed, 22 insertions(+)
>
> diff --git a/doc/guix.texi b/doc/guix.texi
> index 464c1141d8..d4582b009f 100644
> --- a/doc/guix.texi
> +++ b/doc/guix.texi
> @@ -86,6 +86,7 @@ Copyright @copyright{} 2020 raingloom@*
>  Copyright @copyright{} 2020 Daniel Brooks@*
>  Copyright @copyright{} 2020 John Soo@*
>  Copyright @copyright{} 2020 Jonathan Brielmaier@*
> +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
> @@ -3879,6 +3880,16 @@ as a fallback.  Of course you 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 the last substitute URL as a fallback.
> +@end itemize

<https://bordeaux.guix.gnu.org> is also an official substitute server;
I think it should be added to the list.

>  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.
> @@ -5072,6 +5083,17 @@ 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://mirror.sjtu.edu.cn/git/guix.git} branch @code{master}
> +- China, SJTU.

This Git repo doesn’t seem to accept connetions made through Tor, so it
might not be the best example

--8<---------------cut here---------------start------------->8---
$ git clone https://mirror.sjtu.edu.cn/git/guix.git
Cloning into 'guix'...
fatal: unable to access 'https://mirror.sjtu.edu.cn/git/guix.git/': Received HTTP code 503 from proxy after CONNECT
--8<---------------cut here---------------end--------------->8---

There is another mirror on GitHub[1], and suprisingly, it works even
when connecting through Tor.

[1]: https://github.com/guix-mirror/guix

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 861 bytes --]

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

[raid5atemyhomework via Guix-patches via]

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(+)

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

--
2.32.0

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

[Xinglu Chen]

[-- Attachment #1: Type: text/plain, Size: 317 bytes --]

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.  :-)

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 861 bytes --]

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

[zimoun]

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