[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] [gnunet] branch master updated: polish/update user document
From: |
gnunet |
Subject: |
[GNUnet-SVN] [gnunet] branch master updated: polish/update user documentation - first steps |
Date: |
Thu, 28 Jun 2018 00:36:20 +0200 |
This is an automated email from the git hooks/post-receive script.
julius-buenger pushed a commit to branch master
in repository gnunet.
The following commit(s) were added to refs/heads/master by this push:
new f425a18fa polish/update user documentation - first steps
f425a18fa is described below
commit f425a18fa4556aa1f41397de0cb6605017e3f234
Author: Julius Bünger <address@hidden>
AuthorDate: Thu Jun 28 00:35:14 2018 +0200
polish/update user documentation - first steps
---
doc/documentation/chapters/user.texi | 42 +++++++++++++++++-------------------
1 file changed, 20 insertions(+), 22 deletions(-)
diff --git a/doc/documentation/chapters/user.texi
b/doc/documentation/chapters/user.texi
index 7bb277421..2dd6cbcb5 100644
--- a/doc/documentation/chapters/user.texi
+++ b/doc/documentation/chapters/user.texi
@@ -35,7 +35,7 @@ always welcome.
@node Start and stop GNUnet
@section Start and stop GNUnet
-To start GNUnet:
+Previous to use any GNUnet-based application, one has to start a node:
@example
$ gnunet-arm -s -l gnunet.log
@@ -699,9 +699,9 @@ the searcher/downloader specify "no anonymity",
non-anonymous
file-sharing is used. If either user specifies some desired degree
of anonymity, anonymous file-sharing will be used.
-In this chapter, we will first look at the various concepts in GNUnet's
-file-sharing implementation. Then, we will discuss specifics as to
-how they impact users that publish, search or download files.
+After a short introduction, we will first look at the various concepts in
+GNUnet's file-sharing implementation. Then, we will discuss specifics as to how
+they impact users that publish, search or download files.
@menu
@@ -758,32 +758,28 @@ Search results are printed by gnunet-search like this:
@c it will be better the avoid the ellipsis altogether because I don't
@c understand the explanation below that
@example
-$ gnunet-download -o "COPYING" --- gnunet://fs/chk/N8...C92.17992
-=> The GNU Public License <= (mimetype: text/plain)
+#15:
+gnunet-download -o "COPYING" gnunet://fs/chk/PGK8M...3EK130.75446
+
@end example
@noindent
-The first line is the command you would have to enter to download
+The whole line is the command you would have to enter to download
the file. The argument passed to @code{-o} is the suggested
filename (you may change it to whatever you like).
address@hidden except it's triple dash in the above example ---
-The @code{--} is followed by key for decrypting the file,
-the query for searching the file, a checksum (in hexadecimal)
-finally the size of the file in bytes.
-The second line contains the description of the file; here this is
-"The GNU Public License" and the mime-type (see the options for
-gnunet-publish on how to specify these).
+It is followed by the key for decrypting the file, the query for searching the
+file, a checksum (in hexadecimal) finally the size of the file in bytes.
@node fs-Downloading
@subsection Downloading
@c %**end of header
-In order to download a file, you need the three values returned by
+In order to download a file, you need the whole line returned by
@command{gnunet-search}.
You can then use the tool @command{gnunet-download} to obtain the file:
@example
-$ gnunet-download -o FILENAME --- GNUNETURL
+$ gnunet-download -o <FILENAME> <GNUNET-URL>
@end example
@noindent
@@ -797,7 +793,7 @@ If you want to download the GPL from the previous example,
you do the following:
@example
-$ gnunet-download -o "COPYING" --- gnunet://fs/chk/N8...92.17992
+$ gnunet-download -o "COPYING" gnunet://fs/chk/PGK8M...3EK130.75446
@end example
@noindent
@@ -809,11 +805,9 @@ already present.
GNUnet's file-encoding mechanism will ensure file integrity, even if the
existing file was not downloaded from GNUnet in the first place.
-You may want to use the @command{-V} switch (must be added before
address@hidden Same as above it's triple dash
-the @command{--}) to turn on verbose reporting. In this case,
address@hidden will print the current number of
-bytes downloaded whenever new data was received.
+You may want to use the @command{-V} switch to turn on verbose reporting. In
+this case, @command{gnunet-download} will print the current number of bytes
+downloaded whenever new data was received.
@node fs-Publishing
@subsection Publishing
@@ -826,6 +820,10 @@ to the network. The basic format of the command is
$ gnunet-publish [-n] [-k KEYWORDS]* [-m TYPE:VALUE] FILENAME
@end example
+For example
address@hidden
+$ gnunet-publish -m "description:GNU License" -k gpl -k test -m
"mimetype:text/plain" COPYING
address@hidden example
@menu
* Important command-line options::
--
To stop receiving notification emails like this one, please contact
address@hidden
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] [gnunet] branch master updated: polish/update user documentation - first steps,
gnunet <=