pygost.gost3410.sign rand argument and more 34.10-2012 test vectors

[pygost.git] / download.texi

diff --git a/download.texi b/download.texi
index 1f3e419a6cdcb65de2c3d8b44eeb6971b2a47c72..043e1fed4b0112f3eedc21395a62f00fdce72974 100644 (file)
--- a/download.texi
+++ b/download.texi
@@ -1,22 +1,34 @@
 @node Download
 @unnumbered Download
 
+@set VERSION 4.2
+
 No additional dependencies except Python 2.7/3.x interpreter are required.
 
 Preferable way is to download tarball with the signature:
 
-@verbatim
-% wget http://pygost.cypherpunks.ru/pygost-3.15.tar.xz
-% wget http://pygost.cypherpunks.ru/pygost-3.15.tar.xz.sig
-% gpg --verify pygost-3.15.tar.xz.sig pygost-3.15.tar.xz
-% xz -d < pygost-3.15.tar.xz | tar xf -
-% cd pygost-3.15
-% python setup.py install
-@end verbatim
+@example
+$ [fetch|wget] http://pygost.cypherpunks.ru/pygost-@value{VERSION}.tar.xz
+$ [fetch|wget] http://pygost.cypherpunks.ru/pygost-@value{VERSION}.tar.xz.sig
+$ gpg --verify pygost-@value{VERSION}.tar.xz.sig pygost-@value{VERSION}.tar.xz
+$ xz --decompress --stdout pygost-@value{VERSION}.tar.xz | tar xf -
+$ cd pygost-@value{VERSION}
+$ python setup.py install
+@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
 
+@item @ref{Release 4.1, 4.1} @tab 2019-12-17 @tab 60 KiB
+@tab @url{pygost-4.1.tar.xz, link} @url{pygost-4.1.tar.xz.sig, sign}
+@tab @code{CF029E30 8207DF45 884DD118 843A9E5A 33C5D979 F1D05FEA 17B81628 41257A64}
+@tab @code{5ac0ab2989f5dd5ed3f941f40db5e6e0eba7d84708b376b95eb7396427b2511e}
+
+@item @ref{Release 4.0, 4.0} @tab 2019-07-19 @tab 61 KiB
+@tab @url{pygost-4.0.tar.xz, link} @url{pygost-4.0.tar.xz.sig, sign}
+@tab @code{E4A329A9 AB0A781A 254AF940 10237D4C 9EEB37CB F849BA1C EA7BAF60 E3BB98B3}
+@tab @code{d2646d1815338bb5e2b41388e34f2f445828d10c3253e1996fc5d8d865cdf94f}
+
 @item @ref{Release 3.15, 3.15} @tab 2018-12-09 @tab 54 KiB
 @tab @url{pygost-3.15.tar.xz, link} @url{pygost-3.15.tar.xz.sig, sign}
 @tab @code{930C4DAB 580F43A6 D2D32560 A77B877D 0C88F4F6 421307AA 36B7132F 04F8EA89}
@@ -87,15 +99,17 @@ Preferable way is to download tarball with the signature:
 
 @end multitable
 
-But also you can use PIP (@strong{no} authentication is performed!):
+But also you can use pip (@strong{no} OpenPGP authentication is
+performed!) with PyPI:
 
-@verbatim
-% pip install pygost==3.15
-@end verbatim
+@example
+$ echo pygost==@value{VERSION} --hash=sha256:9e8daad58a7fca0c3addd357268bff4c506074dd300887ebf96c0f1c21123835 > requirements.txt
+$ pip install --requirement requirements.txt
+@end example
 
 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
@@ -113,16 +127,15 @@ uid   PyGOST releases <pygost at cypherpunks dot ru>
 @item @url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost} maillist
 
 @item
-@verbatim
-% gpg --auto-key-locate dane --locate-keys pygost at cypherpunks dot ru
-% gpg --auto-key-locate wkd --locate-keys pygost at cypherpunks dot ru
-@end verbatim
+@example
+$ gpg --auto-key-locate dane --locate-keys pygost at cypherpunks dot ru
+$ gpg --auto-key-locate wkd --locate-keys pygost at cypherpunks dot ru
+@end example
 
 @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/pygost.git/}.
+You can obtain development source code with
+@command{git clone git://git.cypherpunks.ru/pygost.git}.