Add PEP-396 compatible module's __version__

[pygost.git] / download.texi

diff --git a/download.texi b/download.texi
index 2bdd18fbdb55476d00173851f2d66e94891c304e..6dd1efb4401585dffea8b5704b6fe9e38ed10cc0 100644 (file)
--- a/download.texi
+++ b/download.texi
@@ -1,18 +1,20 @@
 @node Download
 @unnumbered Download
 
+@set VERSION 4.1
+
 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-4.0.tar.xz
-% wget http://pygost.cypherpunks.ru/pygost-4.0.tar.xz.sig
-% gpg --verify pygost-4.0.tar.xz.sig pygost-4.0.tar.xz
-% xz -d < pygost-4.0.tar.xz | tar xf -
-% cd pygost-4.0
-% 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
@@ -92,15 +94,19 @@ 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
+$ cat > requirements.txt <<EOF
+pygost==@value{VERSION} --hash=sha256:TODO
+EOF
+$ 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
@@ -118,16 +124,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}.