From 6131cd0e220764ae6b9c016a3729d130cc53806d Mon Sep 17 00:00:00 2001 From: ng0 Date: Sat, 20 Apr 2019 13:59:38 +0000 Subject: style --- doc/man/gnunet-download.1 | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) (limited to 'doc/man') diff --git a/doc/man/gnunet-download.1 b/doc/man/gnunet-download.1 index 4dd8ecb79..e2c4ab365 100644 --- a/doc/man/gnunet-download.1 +++ b/doc/man/gnunet-download.1 @@ -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 -- cgit v1.2.3