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

[Xinglu Chen <public@yoctocell.xyz>]

[-- 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 --]