style
authorng0 <ng0@n0.is>
Sat, 20 Apr 2019 13:59:38 +0000 (13:59 +0000)
committerng0 <ng0@n0.is>
Sat, 20 Apr 2019 13:59:38 +0000 (13:59 +0000)
doc/man/gnunet-download.1

index 4dd8ecb79f2135d83290b16ecbeb39eb948a9930..e2c4ab365ded7acdaa5e559ec953b9606e3d447e 100644 (file)
@@ -49,14 +49,18 @@ The final filename is constructed based on meta-data extracted using libextracto
 .It Fl p Ar DOWNLOADS | Fl \-parallelism= Ns Ar DOWNLOADS
 Set the maximum number of parallel downloads that is allowed.
 More parallel downloads can, to some extent, improve the overall time to download content.
-However, parallel downloads also take more memory (see also option \-r which can be used to limit memory utilization) and more sockets.
-This option is used to limit the number of files that are downloaded in parallel (\-r can be used to limit the number of blocks that are concurrently requested).
+However, parallel downloads also take more memory (see also
+.Fl r
+which can be used to limit memory utilization) and more sockets.
+This option is used to limit the number of files that are downloaded in parallel.
+.Fl r
+can be used to limit the number of blocks that are concurrently requested.
 As a result, the value only matters for recursive downloads.
 The default value is 32.
 .It Fl r Ar REQUESTS | Fl \-request-parallelism= Ns Ar REQUESTS
 Set the maximum number of parallel requests that is allowed.
-If multiple files are downloaded, gnunet\-download will not run them in parallel if this would cause the number of pending requests to possibly exceed the given value.
-This is useful since, for example, downloading dozens of multi\-gigabyte files in parallel could exhaust memory resources and would hardly improve performance.
+If multiple files are downloaded, gnunet-download will not run them in parallel if this would cause the number of pending requests to possibly exceed the given value.
+This is useful since, for example, downloading dozens of multi-gigabyte files in parallel could exhaust memory resources and would hardly improve performance.
 Note that the limit only applies to this specific process and that other download activities by other processes are not included in this limit.
 Consider raising this limit for large recursive downloads with many large files if memory and network bandwidth are not fully utilized and if the parallelism limit
 .Pq Fl p
@@ -65,7 +69,9 @@ This option also only matters for recursive downloads.
 The default value is 4092.
 .It Fl R | \-recursive
 Download directories recursively (and in parallel).
-Note that the URI must belong to a GNUnet directory and that the filename given to "\-o" must end in '.gnd' -- otherwise, you will receive an error.
+Note that the URI must belong to a GNUnet directory and that the filename given to
+.Fl o
+must end in '.gnd' \(em otherwise, you will receive an error.
 You may want to use "DIRNAME/.gnd" for the filename, this way a directory "DIRNAME/" will be created, and GNUnet's internal directory information will be stored in "DIRNAME/.gnd".
 However, it is also possible to specify "DIRNAME.gnd", in which case the files from the directory will end up in "DIRNAME/", while GNUnet's directory meta data will be in "DIRNAME.gnd".
 .It Fl v | \-version