Ver código fonte

Updated usage of -V option.

Tatsuhiro Tsujikawa 14 anos atrás
pai
commit
b7b5fac13c
2 arquivos alterados com 25 adições e 14 exclusões
  1. 13 10
      doc/aria2c.1.asciidoc
  2. 12 4
      src/usage_text.h

+ 13 - 10
doc/aria2c.1.asciidoc

@@ -55,14 +55,16 @@ Basic Options
 [[aria2_optref_check_integrity]]*-V*, *--check-integrity*[='true'|'false']::
 
   Check file integrity by validating piece hashes or a hash of entire
-  file.  This option has effect only in BitTorrent and Metalink
-  downloads with checksums.  If piece hashes are provided, this option
-  can detect damaged portions of a file and re-download them.  If a
-  hash of entire file is provided, hash check is only done when file
-  has benn already download. This is determined by file length. If
-  hash check fails, file is re-downloaded from scratch.  If both piece
-  hashes and a hash of entire file are provided, only piece hashes are
-  used. Default: 'false'
+  file.  This option has effect only in BitTorrent, Metalink downloads
+  with checksums or HTTP(S)/FTP downloads with
+  *<<aria2_optref_checksum, --checksum>>* option.  If
+  piece hashes are provided, this option can detect damaged portions
+  of a file and re-download them.  If a hash of entire file is
+  provided, hash check is only done when file has been already
+  download. This is determined by file length. If hash check fails,
+  file is re-downloaded from scratch.  If both piece hashes and a hash
+  of entire file are provided, only piece hashes are used. Default:
+  'false'
 
 [[aria2_optref_continue]]*-c*, *--continue*[='true'|'false']::
    Continue downloading a partially downloaded file.
@@ -3575,8 +3577,9 @@ Repair a damaged download
 aria2c -V file.metalink
 -----------------------
 [NOTE]
-This option is only available used with BitTorrent or metalink with chunk
-checksums.
+
+Repairing damaged downloads can be done efficiently when used with
+BitTorrent or Metalink with chunk checksums.
 
 Drop connection if download speed is lower than specified value
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

+ 12 - 4
src/usage_text.h

@@ -184,10 +184,18 @@
   _(" --enable-http-pipelining[=true|false] Enable HTTP/1.1 pipelining.")
 #define TEXT_CHECK_INTEGRITY                                            \
   _(" -V, --check-integrity[=true|false] Check file integrity by validating piece\n" \
-    "                              hashes. This option has effect only in BitTorrent\n" \
-    "                              and Metalink downloads with chunk checksums.\n" \
-    "                              Use this option to re-download a damaged portion\n" \
-    "                              of a file. See also --bt-hash-check-seed option.")
+    "                              hashes or a hash of entire file. This option has\n" \
+    "                              effect only in BitTorrent, Metalink downloads\n" \
+    "                              with checksums or HTTP(S)/FTP downloads with\n" \
+    "                              --checksum option. If piece hashes are provided,\n" \
+    "                              this option can detect damaged portions of a file\n" \
+    "                              and re-download them. If a hash of entire file is\n" \
+    "                              provided, hash check is only done when file has\n" \
+    "                              been already download. This is determined by file\n" \
+    "                              length. If hash check fails, file is\n" \
+    "                              re-downloaded from scratch. If both piece hashes\n" \
+    "                              and a hash of entire file are provided, only\n" \
+    "                              piece hashes are used.")
 #define TEXT_BT_HASH_CHECK_SEED                                         \
   _(" --bt-hash-check-seed[=true|false] If true is given, after hash check using\n" \
     "                              --check-integrity option and file is complete,\n" \