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

[raid5atemyhomework via Guix-patches via <guix-patches@gnu.org>]

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