From e4a24ef2859f8bf6c354e66236a7c279ae02b385 Mon Sep 17 00:00:00 2001 From: Sergey Matveev Date: Mon, 4 May 2015 19:19:54 +0300 Subject: [PATCH] [DOC] Mention dependent libraries mirror Signed-off-by: Sergey Matveev --- doc/download.texi | 8 +++----- doc/installation.texi | 25 ++++++++++--------------- doc/integrity.texi | 15 +++++++++++++++ doc/sources.texi | 22 ++++++++++++++++++++++ utils/makedist.sh | 7 ++++++- 5 files changed, 56 insertions(+), 21 deletions(-) create mode 100644 doc/integrity.texi create mode 100644 doc/sources.texi diff --git a/doc/download.texi b/doc/download.texi index 5168e34..68e596a 100644 --- a/doc/download.texi +++ b/doc/download.texi @@ -1,3 +1,6 @@ +@node Prepared tarballs +@section Prepared tarballs + You can obtain releases source code prepared tarballs from the links below: @multitable {XXXXX} {XXXX KiB} {link sign} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} @@ -32,8 +35,3 @@ You can obtain releases source code prepared tarballs from the links below: Also you can try its @ref{Contacts, .onion} version. Sourceforge.net also provides mirror for the files above: @url{http://sourceforge.net/projects/govpn/files/}. - -You can obtain its development source code by cloning -Git repository: @code{git clone https://github.com/stargrave/govpn.git}. -Pay attention that it does not contain compiled documentation and is not -recommended for porters because of that. diff --git a/doc/installation.texi b/doc/installation.texi index 13d2159..7276476 100644 --- a/doc/installation.texi +++ b/doc/installation.texi @@ -19,20 +19,7 @@ using @emph{Make}): @item @code{github.com/bigeagle/water} @tab GNU/Linux @tab BSD 3-Clause @end multitable -@include download.texi - -You @strong{have to} verify downloaded archives integrity and check -their signature to be sure that you have got trusted, untampered -software. For integrity and authentication of downloaded binaries -@url{https://www.gnupg.org/, The GNU Privacy Guard} is used. You must -download signature provided with the tarball. - -For the very first time you have to import signing public keys. They -are provided below, but be sure that you are reading them from the -trusted source. Alternatively check this page from -@ref{Contacts, other sources} and look for the mailing list announcements. - -For example you can get tarball, set proper @code{$GOPATH} and run +You can get tarball, set proper @code{$GOPATH} and run @code{make} (that will install all necessary libraries and build @emph{govpn-client}, @emph{govpn-server}, @emph{govpn-verifier} binaries: @@ -48,4 +35,12 @@ For example you can get tarball, set proper @code{$GOPATH} and run % gmake -C govpn/src/govpn all @end example -@include pubkey.texi +@menu +* Prepared tarballs:: +* Development source code:: +* Tarballs integrity check:: +@end menu + +@include download.texi +@include sources.texi +@include integrity.texi diff --git a/doc/integrity.texi b/doc/integrity.texi new file mode 100644 index 0000000..01badc5 --- /dev/null +++ b/doc/integrity.texi @@ -0,0 +1,15 @@ +@node Tarballs integrity check +@section Tarballs integrity check + +You @strong{have to} verify downloaded archives integrity and check +their signature to be sure that you have got trusted, untampered +software. For integrity and authentication of downloaded binaries +@url{https://www.gnupg.org/, The GNU Privacy Guard} is used. You must +download signature provided with the tarball. + +For the very first time you need to import signing public keys. They +are provided below, but be sure that you are reading them from the +trusted source. Alternatively check this page from +@ref{Contacts, other sources} and look for the mailing list announcements. + +@include pubkey.texi diff --git a/doc/sources.texi b/doc/sources.texi new file mode 100644 index 0000000..acecea7 --- /dev/null +++ b/doc/sources.texi @@ -0,0 +1,22 @@ +@node Development source code +@section Development source code + +Development source contains the latest version of the code. It may be +buggy. Also it does not contain compiled documentation and is not +recommended for porters because of that. + +You can obtain it by cloning Git repository: +@code{git clone https://github.com/stargrave/govpn.git}. + +Also there is mirror of dependent libraries for safety if their native +repositories will be unavailable (they are seldom updated): + +@multitable @columnfractions .50 .50 +@headitem Software/library @tab Mirror +@item @code{govpn} @tab @url{git://git.cypherpunks.ru/govpn.git} +@item @code{golang.org/x/crypto/poly1305} @tab @url{git://git.cypherpunks.ru/crypto.git} +@item @code{golang.org/x/crypto/salsa20} @tab @url{git://git.cypherpunks.ru/crypto.git} +@item @code{golang.org/x/crypto/xtea} @tab @url{git://git.cypherpunks.ru/crypto.git} +@item @code{golang.org/x/crypto/pbkdf2} @tab @url{git://git.cypherpunks.ru/crypto.git} +@item @code{github.com/agl/ed25519} @tab @url{git://git.cypherpunks.ru/ed25519.git} +@end multitable diff --git a/utils/makedist.sh b/utils/makedist.sh index 9e2e365..6ff776c 100755 --- a/utils/makedist.sh +++ b/utils/makedist.sh @@ -9,7 +9,12 @@ cd $tmp/govpn-$release git checkout $release rm -fr .git find . -name .gitignore -delete -echo > doc/download.texi +cat > doc/download.texi <