Parametrized version in documentation

[gogost.git] / download.texi

diff --git a/download.texi b/download.texi
index a948d8dbb27306eeec86063ba97bfdbf0426f621..df68b9da2b8ac4c18f86d433150c96a368eb9d41 100644 (file)
--- a/download.texi
+++ b/download.texi
@@ -4,47 +4,67 @@
 Preferable way is to download tarball with the signature from
 website and, for example, run tests with benchmarks:
 
 Preferable way is to download tarball with the signature from
 website and, for example, run tests with benchmarks:
 

-@verbatim
-% wget http://gogost.cypherpunks.ru/gogost-1.1.tar.xz
-% wget http://gogost.cypherpunks.ru/gogost-1.1.tar.xz.sig
-% gpg --verify gogost-1.1.tar.xz.sig gogost-1.1.tar.xz
-% xz -d < gogost-1.1.tar.xz | tar xf -
-% make -C gogost-1.1 all bench
-% echo hello world | ./gogost-1.1/streebog256
+@example
+$ [fetch|wget] http://gogost.cypherpunks.ru/gogost-@value{VERSION}.tar.xz
+$ [fetch|wget] http://gogost.cypherpunks.ru/gogost-@value{VERSION}.tar.xz.sig
+$ gpg --verify gogost-@value{VERSION}.tar.xz.sig gogost-@value{VERSION}.tar.xz
+$ xz -d < gogost-@value{VERSION}.tar.xz | tar xf -
+$ make -C gogost-@value{VERSION} all bench
+$ echo hello world | gogost-@value{VERSION}/streebog256

 f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
 f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d

-@end verbatim
+@end example

 
 And then you can include its source code in your project for example
 like this:
 
 
 And then you can include its source code in your project for example
 like this:
 

-@verbatim
-% mkdir -p myproj/src
-% export GOPATH=$PWD/myproj
-% cd myproj/src
-% cat > main.go <<EOF
+@example
+$ mkdir -p myproj/src
+$ cp -r gogost-@value{VERSION}/src/go.cypherpunks.ru myproj/src
+$ export GOPATH=$PWD/myproj
+$ cd myproj/src
+$ cat > main.go <<EOF

 package main
 
 import (
     "encoding/hex"
     "fmt"
 
 package main
 
 import (
     "encoding/hex"
     "fmt"
 

-    "cypherpunks.ru/gogost/gost34112012256"
+    "go.cypherpunks.ru/gogost/v4/gost34112012256"

 )
 
 )
 

-func main() {
+func main() @{

     h := gost34112012256.New()
     h := gost34112012256.New()

-    h.Write([]byte("hello world"))
+    h.Write([]byte("hello world\n"))

     fmt.Println(hex.EncodeToString(h.Sum(nil)))
     fmt.Println(hex.EncodeToString(h.Sum(nil)))

-}
+@}

 EOF
 EOF

-% cp -r ../../gogost-1.1/src/cypherpunks.ru .
-% go run main.go
-c600fd9dd049cf8abd2f5b32e840d2cb0e41ea44de1c155dcd88dc84fe58a855
-@end verbatim
+$ go run main.go
+f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
+@end example

 
 @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
 

+@item @ref{Release 4.2.0, 4.2.0} @tab 2019-10-18 @tab 57 KiB
+@tab @url{gogost-4.2.0.tar.xz, link} @url{gogost-4.2.0.tar.xz.sig, sign}
+@tab @code{07B44D64 E99924D2 612F9161 037EAFCE 191911B3 B2A9748F 6D340BB7 FBF8EF5A}
+@tab @code{6fc059688e4cf121c3af4a5b3bbb13661478c5df91de5f6f2da89f64486d5977}
+
+@item @ref{Release 4.1.0, 4.1.0} @tab 2019-10-03 @tab 55 KiB
+@tab @url{gogost-4.1.0.tar.xz, link} @url{gogost-4.1.0.tar.xz.sig, sign}
+@tab @code{F2FEF2E0 ADEB5742 FA2B3338 64E8B91B 3CCAA97D 5BA62177 21E08A11 F1FA8133}
+@tab @code{72e0d52aa25158ab1bb45e5498ce703b516c616b71101b74d5ee259f516c4e91}
+
+@item @ref{Release 4.0, 4.0} @tab 2019-08-12 @tab 56 KiB
+@tab @url{gogost-4.0.tar.xz, link} @url{gogost-4.0.tar.xz.sig, sign}
+@tab @code{4899B930 2110C9A9 592821D6 B206146F 2A66FC5A 3DEE9D6E 11F5EA51 72FEE6E6}
+@tab @code{ad8b58d42c3829e66dd1994265478eab921393cf0f7a8b520d900e38092a2cd6}
+
+@item @ref{Release 3.0, 3.0} @tab 2019-07-19 @tab 47 KiB
+@tab @url{gogost-3.0.tar.xz, link} @url{gogost-3.0.tar.xz.sig, sign}
+@tab @code{0BC2F39C DDB66493 BDF02DA7 C0A04633 E2A33462 4E3C0C7C 567712A6 6078FC82}
+@tab @code{40de433a7e37fdca1ac2a9ef6093c85314937d59fa72e8e4dc91d5bf4eb064d7}
+

 @item @ref{Release 2.0, 2.0} @tab 2016-11-26 @tab 39 KiB
 @tab @url{gogost-2.0.tar.xz, link} @url{gogost-2.0.tar.xz.sig, sign}
 @tab @code{28E8C15C 0EC5CC2A 47A8CCDA DF9EADB5 E46970AA FB7FAAF3 AA250FFC 79CE57F7}
 @item @ref{Release 2.0, 2.0} @tab 2016-11-26 @tab 39 KiB
 @tab @url{gogost-2.0.tar.xz, link} @url{gogost-2.0.tar.xz.sig, sign}
 @tab @code{28E8C15C 0EC5CC2A 47A8CCDA DF9EADB5 E46970AA FB7FAAF3 AA250FFC 79CE57F7}


@@ -64,7 +84,7 @@ c600fd9dd049cf8abd2f5b32e840d2cb0e41ea44de1c155dcd88dc84fe58a855
 
 You @strong{have to} verify downloaded tarballs integrity and
 authenticity to be sure that you retrieved trusted and untampered
 
 You @strong{have to} verify downloaded tarballs integrity and
 authenticity to be sure that you retrieved trusted and untampered

-software. @url{https://www.gnupg.org/, The GNU Privacy Guard} is used
+software. @url{https://www.gnupg.org/, GNU Privacy Guard} is used

 for that purpose.
 
 For the very first time it is necessary to get signing public key and
 for that purpose.
 
 For the very first time it is necessary to get signing public key and


@@ -82,17 +102,37 @@ uid   GoGOST releases <gogost at cypherpunks dot ru>
 @item @url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost} maillist
 
 @item
 @item @url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost} maillist
 
 @item

-@verbatim
-% gpg --keyserver hkp://keys.gnupg.net/ --recv-keys 0x82343436696FC85A
-% gpg --auto-key-locate dane --locate-keys gogost at cypherpunks dot ru
-% gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru
-@end verbatim
+@example
+$ gpg --auto-key-locate dane --locate-keys gogost at cypherpunks dot ru
+$ gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru
+@end example

 
 @item
 @verbatiminclude PUBKEY.asc
 
 @end itemize
 
 
 @item
 @verbatiminclude PUBKEY.asc
 
 @end itemize
 

-You can obtain development source code by cloning
-@url{http://git-scm.com/, Git}
-@url{https://git.cypherpunks.ru/cgit.cgi/gogost.git/}.
+GoGOST is also @command{go get}-able. For example to use
+@command{streebog256} utility:
+
+@example
+$ go get go.cypherpunks.ru/gogost/cmd/streebog256
+@end example
+
+@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:
+
+@example
+require go.cypherpunks.ru/gogost/v4 v@value{VERSION}
+replace go.cypherpunks.ru/gogost/v4 => /home/stargrave/gogost-@value{VERSION}/src/go.cypherpunks.ru/gogost/v4
+@end example
+
+You can obtain development source code with
+@command{git clone git://git.cypherpunks.ru/gogost.git}.