Mention CACert, GOPRIVATE and go.mod-replace during installation

diff --git a/INSTALL b/INSTALL
index 690ba98156248f97362ebc8cba233f39329b29a9..06e6e6725fdd95162c57937c42cfb042b720a63a 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -35,10 +35,6 @@ like this:
     $ go run main.go
     f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
 
     $ go run main.go
     f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
 

-GoGOST is also go-get-able. For example to use streebog256 utility:
-
-    $ go get go.cypherpunks.ru/gogost/cmd/streebog256
-

 You have to verify downloaded tarballs integrity and authenticity to be
 sure that you retrieved trusted and untampered software. GNU Privacy
 Guard is used for that purpose.
 You have to verify downloaded tarballs integrity and authenticity to be
 sure that you retrieved trusted and untampered software. GNU Privacy
 Guard is used for that purpose.


@@ -54,3 +50,19 @@ resources.
     Look in PUBKEY.asc file.
     $ gpg --auto-key-locate dane --locate-keys gogost at cypherpunks dot ru
     $ gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru
     Look in PUBKEY.asc file.
     $ gpg --auto-key-locate dane --locate-keys gogost at cypherpunks dot ru
     $ gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru

+
+GoGOST is also go-get-able. For example to use streebog256 utility:
+
+    $ go get go.cypherpunks.ru/gogost/cmd/streebog256
+
+go.cypherpunks.ru uses CACert.org certificate authority, that is not
+included by default in some operating system distributions and probably
+you have to install it in your system, because "go get" uses HTTPS
+connections. If you have issues using either sum.golang.org or
+proxy.golang.org, then you can disable their usage with
+GOPRIVATE=go.cypherpunks.ru/gogost environment variable.
+
+Also you can use "replace" feature inside your go.mod, like:
+
+    require go.cypherpunks.ru/gogost/v4 v4.1.0
+    replace go.cypherpunks.ru/gogost/v4 => /home/stargrave/gogost-4.1.0/src/go.cypherpunks.ru/gogost/v4

diff --git a/download.texi b/download.texi
index bfdc5bc016663e5e75aac49799e8aacd3b888b2e..0110f45fc3364d0fba861ca6ee1b0b78f56a3101 100644 (file)
--- a/download.texi
+++ b/download.texi
@@ -42,12 +42,6 @@ $ go run main.go
 f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
 @end verbatim
 
 f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
 @end verbatim
 

-GoGOST is also @command{go get}-able. For example to use
-@command{streebog256} utility:
-@verbatim
-$ go get go.cypherpunks.ru/gogost/cmd/streebog256
-@end verbatim
-

 @multitable {XXXXX} {XXXX-XX-XX} {XXXX KiB} {link sign} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx}
 @headitem Version @tab Date @tab Size @tab Tarball @tab SHA256 checksum @tab Streebog-256 checksum
 
 @multitable {XXXXX} {XXXX-XX-XX} {XXXX KiB} {link sign} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx}
 @headitem Version @tab Date @tab Size @tab Tarball @tab SHA256 checksum @tab Streebog-256 checksum
 


@@ -113,6 +107,26 @@ $ gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru
 
 @end itemize
 
 
 @end itemize
 

+GoGOST is also @command{go get}-able. For example to use
+@command{streebog256} utility:
+@verbatim
+$ go get go.cypherpunks.ru/gogost/cmd/streebog256
+@end verbatim
+
+@code{go.cypherpunks.ru} uses @url{https://www.cacert.org/, CACert.org}
+certificate authority, that is not included by default in some operating
+system distributions and probably you have to install it in your system,
+because @command{go get} uses HTTPS connections. If you have issues
+using either @code{sum.golang.org} or @code{proxy.golang.org}, then you
+can disable their usage with @env{GOPRIVATE=go.cypherpunks.ru/gogost}
+environment variable.
+
+Also you can use @code{replace} feature inside your @file{go.mod}, like:
+@verbatim
+require go.cypherpunks.ru/gogost/v4 v4.1.0
+replace go.cypherpunks.ru/gogost/v4 => /home/stargrave/gogost-4.1.0/src/go.cypherpunks.ru/gogost/v4
+@end verbatim
+

 You can obtain development source code by cloning
 @url{http://git-scm.com/, Git}
 @url{https://git.cypherpunks.ru/cgit.cgi/gogost.git/}.
 You can obtain development source code by cloning
 @url{http://git-scm.com/, Git}
 @url{https://git.cypherpunks.ru/cgit.cgi/gogost.git/}.