[GNUnet-SVN] [gnunet] branch master updated (0d0b7af9c -> 76e9cc144)

[gnunet]

This is an automated email from the git hooks/post-receive script.

ng0 pushed a change to branch master
in repository gnunet.

    from 0d0b7af9c doc: some svn->git fixes and comments.
     new 9f8b058fc doc: install: some item + file fixes.
     new f47c0fe74 doc: install: Remove duplicate paragraph.
     new 76e9cc144 doc: install: mixed fixes.

The 3 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 doc/chapters/installation.texi | 121 +++++++++++++++++++----------------------
 1 file changed, 56 insertions(+), 65 deletions(-)

diff --git a/doc/chapters/installation.texi b/doc/chapters/installation.texi
index 5a84de52d..d622f7b13 100644
--- a/doc/chapters/installation.texi
+++ b/doc/chapters/installation.texi
@@ -48,21 +48,21 @@ These packages must be installed before a typical GNUnet 
installation
 can be performed:
 
 @table @asis
address@hidden GNU libmicrohttpd
-0.9.30 or higher
address@hidden GNU libextractor
-1.0 or higher
address@hidden GNU libtool
-2.2 or higher 
address@hidden GNU libunistring
-0.9.1.1 or higher
address@hidden GNU libidn
-1.0.0 or higher
address@hidden @uref{ftp://ftp.gnupg.org/gcrypt/libgcrypt/, GNU libgcrypt}
address@hidden://ftp.gnupg.org/gcrypt/libgcrypt/libgcrypt-1.6.0.tar.bz2, 1.6.0} 
or
-higher
address@hidden GnuTLS
address@hidden://ftp.gnutls.org/gcrypt/gnutls/v3.2/gnutls-3.2.7.tar.xz, 3.2.7} 
or
address@hidden
+GNU libmicrohttpd 0.9.30 or higher
address@hidden
+GNU libextractor 1.0 or higher
address@hidden
+GNU libtool 2.2 or higher 
address@hidden
+GNU libunistring 0.9.1.1 or higher
address@hidden
+GNU libidn 1.0.0 or higher
address@hidden
address@hidden://ftp.gnupg.org/gcrypt/libgcrypt/, GNU libgcrypt}
address@hidden://ftp.gnupg.org/gcrypt/libgcrypt/libgcrypt-1.6.0.tar.bz2, 1.6.0} 
or higher
address@hidden
+GnuTLS @uref{ftp://ftp.gnutls.org/gcrypt/gnutls/v3.2/gnutls-3.2.7.tar.xz, 
3.2.7} or
 higher, compile with libunbound for DANE support; GnuTLS also requires GNU
 nettle 2.7 (update: GnuTLS 3.2.7 appears NOT to work against GNU nettle
 > 2.7, due to some API updatings done by nettle. Thus it should be compiled
@@ -70,40 +70,41 @@ against nettle 2.7 and, in case you get some error on the 
reference to
 `rpl_strerror' being undefined, follow the instructions on@
 @uref{http://lists.gnupg.org/pipermail/gnutls-devel/2013-November/006588.html, 
this}
 post (and the link inside it)).
address@hidden libgnurl
-7.34.0 or higher (available from https://gnunet.org/gnurl), should be compiled
-after @code{GnuTLS}
address@hidden libglpk
-4.45 or higher
address@hidden @uref{http://www.openssl.org/, OpenSSL} (binary)
-1.0 or higher
address@hidden TeX Live
-2012 or higher, optional (for gnunet-bcd)
address@hidden libpulse
-2.0 or higher, optional (for gnunet-conversation)
address@hidden libopus
-1.0.1 or higher, optional (for gnunet-conversation)
address@hidden libogg
-1.3.0 or higher, optional (for gnunet-conversation)
address@hidden certool (binary)
address@hidden
+libgnurl 7.34.0 or higher (available from https://gnunet.org/gnurl),
+should be compiled after @code{GnuTLS}
address@hidden
+libglpk 4.45 or higher
address@hidden
address@hidden://www.openssl.org/, OpenSSL} (binary) 1.0 or higher
address@hidden
+TeX Live 2012 or higher, optional (for gnunet-bcd)
address@hidden
+libpulse 2.0 or higher, optional (for gnunet-conversation)
address@hidden
+libopus 1.0.1 or higher, optional (for gnunet-conversation)
address@hidden
+libogg 1.3.0 or higher, optional (for gnunet-conversation)
address@hidden
+certool (binary)
 optional for convenient installation of the GNS proxy
 (available as part of Debian's libnss3-tools)
address@hidden python-zbar
-0.10 or higher, optional (for gnunet-qr)
address@hidden
+python-zbar 0.10 or higher, optional (for gnunet-qr)
 @item libsqlite
 3.8.0 or higher (note that the code will compile and often work with lower
 version numbers, but you may get subtle bugs with respect to quota management
 in certain rare cases); alternatively, MySQL or Postgres can also be installed,
 but those databases will require more complex configurations (not recommended
 for first-time users)
address@hidden zlib
-any version we tested worked
address@hidden Gtk+
-3.0 or higher, optional (for gnunet-gtk)
address@hidden libgladeui
-must match Gtk+ version, optional (for gnunet-gtk)
address@hidden libqrencode
-3.0 or higher, optional (for gnunet-namestore-gtk)
address@hidden
+zlib any version we tested worked
address@hidden
+Gtk+ 3.0 or higher, optional (for gnunet-gtk)
address@hidden
+libgladeui must match Gtk+ version, optional (for gnunet-gtk)
address@hidden
+libqrencode 3.0 or higher, optional (for gnunet-namestore-gtk)
 @end table
 
 
@@ -112,20 +113,7 @@ must match Gtk+ version, optional (for gnunet-gtk)
 
 If you have to compile libgnurl from source since the version included in your
 distribution is to old you perhaps get an error message while running the
address@hidden script:
-
address@hidden@
- $ configure@
- ...@
- checking for 64-bit curl_off_t data type... unknown@
- checking for 32-bit curl_off_t data type... unknown@
- checking for 16-bit curl_off_t data type... unknown@
- configure: error: cannot find data type for curl_off_t.@
-}
-
-If you have to compile libgnurl from source since the version included in your
-distribution is to old, you perhaps get an error message while running the
address@hidden script:
address@hidden script:
 
 @code{@
  $ configure@
@@ -325,10 +313,13 @@ development headers for the various libraries are also 
installed. There maybe
 files for other distributions, or you might be able to find equivalent packages
 for your distribution.
 
+In the code instructions below, @emph{#} indicates commands run as privileged 
root
+user and @emph{$} shows commands run as unprivileged ("normal") system user.
+
 While it is possible to build and install GNUnet without having root access,
 we will assume that you have full control over your system in these
-instructions. First, you should create a system user "gnunet" and an additional
-group "gnunetdns". On Debian and Ubuntu GNU/Linux, type:@
+instructions. First, you should create a system user @emph{gnunet} and an 
additional
+group @emph{gnunetdns}. On Debian and Ubuntu GNU/Linux, type:@
 @code{@
  # adduser --system --home /var/lib/gnunet --group --disabled-password gnunet@
  # addgroup --system gnunetdns@
@@ -344,16 +335,16 @@ group "gnunetdns". On Debian and Ubuntu GNU/Linux, type:@
  $ cd gnunet-0.10.?@
  $ ./configure --with-sudo=sudo --with-nssdir=/lib@
  $ make@
- $ sudo make install@
+ $ sudo make install@
 }@
 
 If you want to be able to enable DEBUG-level log messages, add
address@hidden to the end of the ./configure command.
address@hidden to the end of the @code{./configure} command.
 DEBUG-level log messages are in English-only and should only be useful for
 developers (or for filing really detailed bug reports). 
 
-Finally, you probably want to compile gnunet-gtk, which includes gnunet-setup
-(graphical tool for configuration) and gnunet-fs-gtk (graphical tool for
+Finally, you probably want to compile @code{gnunet-gtk}, which includes 
gnunet-setup
+(graphical tool for configuration) and @code{gnunet-fs-gtk} (graphical tool for
 file-sharing):@
 
 @code{@
@@ -365,7 +356,7 @@ file-sharing):@
  $ cd ..@
  $ sudo ldconfig # just to be safe@
 }@
- Now, edit @code{/etc/gnunet.conf} to contain the following:@
+ Next, edit the file @file{/etc/gnunet.conf} to contain the following:@
 @code{@
  [arm]@
  SYSTEM_ONLY = YES@
@@ -402,7 +393,7 @@ $USER on the system, run:@
 }@
 
 to allow them to access the system-wide GNUnet services. Then, each user should
-create a configuration file "~/.config/gnunet.conf" with the lines:@
+create a configuration file @file{~/.config/gnunet.conf} with the lines:@
 
 @code{@
  [arm]@
@@ -417,7 +408,7 @@ and start the per-user services using@
  $ gnunet-arm -c ~/.config/gnunet.conf -s@
 }@
 
-Again, adding a @file{crontab} entry to autostart the peer is advised:@
+Again, adding a @code{crontab} entry to autostart the peer is advised:@
 @code{@
 @@reboot /usr/local/bin/gnunet-arm -c $HOME/.config/gnunet.conf -s@
 }@
@@ -445,7 +436,7 @@ hosts: files mdns4_minimal [NOTFOUND=return] dns mdns4
 
 
 The exact details may differ a bit, which is fine. Add the text
-"gns [NOTFOUND=return]" after "files":
address@hidden"gns [NOTFOUND=return]"} after @emph{"files"}:
 @example
 hosts: files gns [NOTFOUND=return] mdns4_minimal [NOTFOUND=return] dns mdns4
 @end example

-- 
To stop receiving notification emails like this one, please contact
address@hidden