[GNUnet-SVN] [gnunet] 41/75: some changes and work in user handbook.

[gnunet]

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

martin-schanzenbach pushed a commit to branch master
in repository gnunet.

commit 1f7a2dd68d1e6260fad4af042878c0a07d39bc12
Author: Nils Gillmann <address@hidden>
AuthorDate: Wed Jun 13 08:01:51 2018 +0000

    some changes and work in user handbook.
    
    Signed-off-by: Nils Gillmann <address@hidden>
---
 doc/documentation/chapters/user.texi | 48 ++++++++++++++++++++----------------
 1 file changed, 27 insertions(+), 21 deletions(-)

diff --git a/doc/documentation/chapters/user.texi 
b/doc/documentation/chapters/user.texi
index 48fcc04c3..b5457cf15 100644
--- a/doc/documentation/chapters/user.texi
+++ b/doc/documentation/chapters/user.texi
@@ -2,20 +2,21 @@
 @chapter Using GNUnet
 @c %**end of header
 
-This tutorial is supposed to give a first introduction for end-users
-trying to do something "real" with GNUnet. Installation and
+This tutorial is supposed to give a first introduction for users
+trying to do something real with GNUnet. Installation and
 configuration are specifically outside of the scope of this tutorial.
 Instead, we start by briefly checking that the installation works, and
 then dive into uncomplicated, concrete practical things that can be done
-with the network.
+with the framework provided by GNUnet.
 
-This chapter of the GNUnet Reference Documentation documents
-how to use the various peer-to-peer applications of the
+In short, this chapter of the ``GNUnet Reference Documentation'' will
+show you how to use the various peer-to-peer applications of the
 GNUnet system.
-As GNUnet evolves, we will add new chapters for the various
+As GNUnet evolves, we will add new sections for the various
 applications that are being created.
 
-Comments and extensions of this documentation are always welcome.
+Comments on the content of this chapter, and extensions of it are
+always welcome.
 
 
 @menu
@@ -35,10 +36,11 @@ Comments and extensions of this documentation are always 
welcome.
 @section Checking the Installation
 @c %**end of header
 
-This section describes a quick casual way to check if your GNUnet
+This section describes a quick, casual way to check if your GNUnet
 installation works. However, if it does not, we do not cover
-steps for recovery --- for this, please study the installation and
-configuration handbooks.
+steps for recovery --- for this, please study the instructions
+provided in the developer handbook as well as the system-specific
+instruction in the source code address@hidden system specific instructions are 
not provided as part of this handbook!}.
 
 
 @menu
@@ -47,13 +49,16 @@ configuration handbooks.
 * Peer Information::
 @end menu
 
address@hidden GNUnet GTK
address@hidden GTK
address@hidden GTK user interface
 @node gnunet-gtk
 @subsection gnunet-gtk
 @c %**end of header
 
 The @command{gnunet-gtk} package contains several graphical
 user interfaces for the respective GNUnet applications.
-Those currently are:
+Currently these interfaces cover:
 
 @itemize @bullet
 @item Statistics
@@ -68,20 +73,21 @@ Those currently are:
 @subsection Statistics
 @c %**end of header
 
-First, you should launch the graphical user interface.  You can do
-this from the command-line by typing
+First, you should launch GNUnet address@hidden you should also start gnunet, 
via gnunet-arm or the system provided method}.
+You can do this from the command-line by typing
 
 @example
-$ gnunet-statistics-gtk
+gnunet-statistics-gtk
 @end example
 
-If your peer is running correctly, you should see a bunch of
-lines, all of which should be "significantly" above zero (at least if your
-peer has been running for a few seconds). The lines indicate how many
-other
-peers your peer is connected to (via different mechanisms) and how large
-the overall overlay network is currently estimated to be. The X-axis
-represents time (in seconds since the start of @command{gnunet-gtk}).
+If your address@hidden term ``peer'' is a common word used in federated and 
distributed networks to describe a participating device which is connected to 
the network. Thus, your Personal Computer or whatever it is you are looking at 
the Gtk+ interface describes a ``Peer'' or a ``Node''.}
+is running correctly, you should see a bunch of lines,
+all of which should be ``significantly'' above zero (at least if your
+peer has been running for more than a few seconds). The lines indicate
+how many other peers your peer is connected to (via different
+mechanisms) and how large the entire overlay network is currently
+estimated to be. The X-axis represents time (in seconds since the
+start of @command{gnunet-gtk}).
 
 You can click on "Traffic" to see information about the amount of
 bandwidth your peer has consumed, and on "Storage" to check the amount

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