From c3c9fef22fa6e4657c3fc862bad365b440ee2305 Mon Sep 17 00:00:00 2001 From: Nils Gillmann Date: Fri, 4 May 2018 19:57:38 +0000 Subject: Follow-up commit to format most of the other man pages code. Signed-off-by: Nils Gillmann --- doc/man/gnunet-directory.1 | 39 +++++++++++++++++++++++++++++++++------ 1 file changed, 33 insertions(+), 6 deletions(-) (limited to 'doc/man/gnunet-directory.1') diff --git a/doc/man/gnunet-directory.1 b/doc/man/gnunet-directory.1 index 373e171f1..9a44be244 100644 --- a/doc/man/gnunet-directory.1 +++ b/doc/man/gnunet-directory.1 @@ -7,10 +7,14 @@ gnunet\-directory \- display directories [\fIOPTIONS\fR] (FILENAME)* .SH DESCRIPTION .PP -gnunet\-directory lists the contents of one or more GNUnet directories. A GNUnet directory is a binary file that contains a list of GNUnet file\-sharing URIs and meta data. The names of the directory files must be passed as command\-line arguments to gnunet\-directory. +gnunet\-directory lists the contents of one or more GNUnet directories. +A GNUnet directory is a binary file that contains a list of GNUnet +file\-sharing URIs and meta data. The names of the directory files must +be passed as command\-line arguments to gnunet\-directory. .TP \fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR -configuration file to use (useless option since gnunet\-directory does not really depend on any configuration options) +configuration file to use (useless option since gnunet\-directory does not +really depend on any configuration options) .TP \fB\-h\fR, \fB\-\-help\fR print help page @@ -21,13 +25,36 @@ Change the loglevel. Possible values for LOGLEVEL are ERROR, WARNING, INFO and \fB\-v\fR, \fB\-\-version\fR print the version number .SH NOTES -A GNUnet directory is a file containing a list of GNUnet URIs and meta data. The keys can point to files, other directories or files in namespaces. In other words, a GNUnet directory is similar to UNIX directories. The difference to tar and zip is that GNUnet directory does not contain the actual files (except if they are really small, in which case they may be inlined), just symbolic (links), similar to directories with symbolic links in UNIX filesystems. The benefit is that the individual files can be retrieved separately (if desired) and if some of the files are inserted to another node in GNUnet, this just increases their availability but does not produce useless duplicates (for example, it is a better idea to publish a collection of pictures or compressed sound files using a GNUnet directory instead of processing them with archivers such as tar or zip first). Directories can contain arbitrary meta data for each file. +A GNUnet directory is a file containing a list of GNUnet URIs and meta data. +The keys can point to files, other directories or files in namespaces. In other +words, a GNUnet directory is similar to UNIX directories. The difference to tar +and zip is that GNUnet directory does not contain the actual files (except if +they are really small, in which case they may be inlined), just symbolic (links), +similar to directories with symbolic links in UNIX filesystems. The benefit is +that the individual files can be retrieved separately (if desired) and if some +of the files are inserted to another node in GNUnet, this just increases their +availability but does not produce useless duplicates (for example, it is a +better idea to publish a collection of pictures or compressed sound files +using a GNUnet directory instead of processing them with archivers such as +tar or zip first). Directories can contain arbitrary meta data for each file. -If a directory has missing blocks (for example, some blocks failed to download), GNUnet is typically able to retrieve information about other files in the directory. Files in a GNUnet directory have no particular order; the GNUnet code that generates a directory can reorder the entries in order to better fit the information about files into blocks of 32k. Respecting 32k boundaries where possible makes it easier for gnunet\-directory (and other tools) to recover information from partially downloaded directory files. +If a directory has missing blocks (for example, some blocks failed to download), +GNUnet is typically able to retrieve information about other files in the +directory. Files in a GNUnet directory have no particular order; the GNUnet +code that generates a directory can reorder the entries in order to better +fit the information about files into blocks of 32k. Respecting 32k boundaries +where possible makes it easier for gnunet\-directory (and other tools) to +recover information from partially downloaded directory files. -At the moment, directories can be created by \fBgnunet\-fs\-gtk\fP and \fBgnunet\-publish\fP. Just like ordinary files, a directory can be published in a namespace. +At the moment, directories can be created by \fBgnunet\-fs\-gtk\fP +and \fBgnunet\-publish\fP. Just like ordinary files, a directory can be +published in a namespace. -GNUnet directories use the (unregistered) mimetype \fBapplication/gnunet\-directory\fP. They can show up among normal search results. The directory file can be downloaded to disk by \fBgnunet\-download\fP(1) for later processing or be handled more directly by \fBgnunet\-fs\-gtk\fP(1). +GNUnet directories use the (unregistered) +mimetype \fBapplication/gnunet\-directory\fP. They can show up among normal +search results. The directory file can be downloaded to disk +by \fBgnunet\-download\fP(1) for later processing or be handled more directly +by \fBgnunet\-fs\-gtk\fP(1). .SH "REPORTING BUGS" Report bugs by using mantis or by sending electronic mail to -- cgit v1.2.3