2010-03-28 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>

Documented --always-resume and --max-resume-failure-tries option
	and exit status 8 in man page. Fixed typo.
	* doc/aria2c.1.txt
	* src/OptionHandlerFactory.cc
pull/1/head
Tatsuhiro Tsujikawa 2010-03-28 07:38:41 +00:00
parent abe1e9843c
commit 65389139c6
5 changed files with 113 additions and 10 deletions

View File

@ -1,3 +1,10 @@
2010-03-28 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Documented --always-resume and --max-resume-failure-tries option
and exit status 8 in man page. Fixed typo.
* doc/aria2c.1.txt
* src/OptionHandlerFactory.cc
2010-03-28 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Added --always-resume and --max-resume-failure-tries option. If

View File

@ -2,12 +2,12 @@
.\" Title: aria2c
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 03/25/2010
.\" Date: 03/28/2010
.\" Manual: Aria2 Manual
.\" Source: Aria2 1.9.1a
.\" Language: English
.\"
.TH "ARIA2C" "1" "03/25/2010" "Aria2 1\&.9\&.1a" "Aria2 Manual"
.TH "ARIA2C" "1" "03/28/2010" "Aria2 1\&.9\&.1a" "Aria2 Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@ -994,6 +994,23 @@ If false is given, aria2 aborts download when a piece length is different from o
\fIfalse\fR
.RE
.PP
\fB\-\-always\-resume\fR[=\fItrue\fR|\fIfalse\fR]
.RS 4
Always resume download\&. If
\fItrue\fR
is given, aria2 always tries to resume download and if resume is not possible, aborts download\&. If
\fIfalse\fR
is given, when all given URIs do not support resume or aria2 encounters
\fIN\fR
URIs which does not support resume (\fIN\fR
is the value specified using
\fB\-\-max\-resume\-failure\-tries\fR
option), aria2 downloads file from scratch\&. See
\fB\-\-max\-resume\-failure\-tries\fR
option\&. Default:
\fItrue\fR
.RE
.PP
\fB\-\-async\-dns\fR[=\fItrue\fR|\fIfalse\fR]
.RS 4
Enable asynchronous DNS\&. Default:
@ -1104,6 +1121,20 @@ If an interface has multiple addresses, it is highly recommended to specify IP a
.sp .5v
.RE
.PP
\fB\-\-max\-resume\-failure\-tries\fR=\fIN\fR
.RS 4
When used with
\fB\-\-always\-resume\fR=\fIfalse\fR, aria2 downloads file from scratch when aria2 detects
\fIN\fR
number of URIs that does not support resume\&. If
\fIN\fR
is
\fI0\fR, aria2 downloads file from scratch when all given URIs do not support resume\&. See
\fB\-\-always\-resume\fR
option\&. Default:
\fI0\fR
.RE
.PP
\fB\-\-log\-level\fR=LEVEL
.RS 4
Set log level to output\&. LEVEL is either
@ -1357,6 +1388,11 @@ If network problem occurs\&.
.RS 4
If there are unfinished downloads\&. This error is only reported if all finished downloads are successful and there are unfinished downloads in a queue when aria2 exits by pressing Ctrl\-C by an user or sending TERM or INT signal\&.
.RE
.PP
\fB8\fR
.RS 4
If server does not support resume when resume is required to complete download\&.
.RE
.if n \{\
.sp
.\}

View File

@ -1798,6 +1798,20 @@ writes the piece to the appropriate files.</td>
</p>
</dd>
<dt class="hdlist1">
<strong>--always-resume</strong>[=<em>true</em>|<em>false</em>]
</dt>
<dd>
<p>
Always resume download. If <em>true</em> is given, aria2 always tries to
resume download and if resume is not possible, aborts download. If
<em>false</em> is given, when all given URIs do not support resume or aria2
encounters <em>N</em> URIs which does not support resume (<em>N</em> is the value
specified using <strong>--max-resume-failure-tries</strong> option), aria2
downloads file from scratch. See <strong>--max-resume-failure-tries</strong>
option. Default: <em>true</em>
</p>
</dd>
<dt class="hdlist1">
<strong>--async-dns</strong>[=<em>true</em>|<em>false</em>]
</dt>
<dd>
@ -1933,6 +1947,18 @@ name.</td>
</div>
<div class="dlist"><dl>
<dt class="hdlist1">
<strong>--max-resume-failure-tries</strong>=<em>N</em>
</dt>
<dd>
<p>
When used with <strong>--always-resume</strong>=<em>false</em>, aria2 downloads file from
scratch when aria2 detects <em>N</em> number of URIs that does not support
resume. If <em>N</em> is <em>0</em>, aria2 downloads file from scratch when all
given URIs do not support resume. See <strong>--always-resume</strong> option.
Default: <em>0</em>
</p>
</dd>
<dt class="hdlist1">
<strong>--log-level</strong>=LEVEL
</dt>
<dd>
@ -2257,6 +2283,15 @@ based on the last error encountered.</p></div>
or sending TERM or INT signal.
</p>
</dd>
<dt class="hdlist1">
<strong>8</strong>
</dt>
<dd>
<p>
If server does not support resume when resume is required to
complete download.
</p>
</dd>
</dl></div>
<div class="admonitionblock">
<table><tr>
@ -4012,7 +4047,7 @@ files in the program, then also delete it here.</p></div>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
Last updated 2010-03-25 23:48:28 JST
Last updated 2010-03-28 16:34:53 JST
</div>
</div>
</body>

View File

@ -687,6 +687,16 @@ Advanced Options
If true is given, you can proceed but some download progress will be lost.
Default: 'false'
*--always-resume*[='true'|'false']::
Always resume download. If 'true' is given, aria2 always tries to
resume download and if resume is not possible, aborts download. If
'false' is given, when all given URIs do not support resume or aria2
encounters 'N' URIs which does not support resume ('N' is the value
specified using *--max-resume-failure-tries* option), aria2
downloads file from scratch. See *--max-resume-failure-tries*
option. Default: 'true'
*--async-dns*[='true'|'false']::
Enable asynchronous DNS.
Default: 'true'
@ -764,6 +774,14 @@ specify IP address explicitly. See also *--disable-ipv6*. If your
system doesn't have getifaddrs(), this option doesn't accept interface
name.
*--max-resume-failure-tries*='N'::
When used with *--always-resume*='false', aria2 downloads file from
scratch when aria2 detects 'N' number of URIs that does not support
resume. If 'N' is '0', aria2 downloads file from scratch when all
given URIs do not support resume. See *--always-resume* option.
Default: '0'
*--log-level*=LEVEL::
Set log level to output.
LEVEL is either 'debug', 'info', 'notice', 'warn' or 'error'.
@ -964,6 +982,11 @@ based on the last error encountered.
downloads in a queue when aria2 exits by pressing Ctrl-C by an user
or sending TERM or INT signal.
*8*::
If server does not support resume when resume is required to
complete download.
[NOTE]
An error occurred in a finished download will not be reported
as exit status.

View File

@ -641,17 +641,19 @@
" starts from scratch. This will be useful for\n" \
" users behind proxy server which disables resume.")
#define TEXT_ALWAYS_RESUME \
_(" --always-resume[=true|false] Always resume download. If false is given, when\n" \
" all given URIs does not support resume or aria2\n" \
" encounters N URIs which does not support resume\n" \
" (N is the value specified using\n" \
_(" --always-resume[=true|false] Always resume download. If true is given, aria2\n" \
" always tries to resume download and if resume is\n" \
" not possible, aborts download. If false is given,\n" \
" when all given URIs do not support resume or\n" \
" aria2 encounters N URIs which does not support\n" \
" resume (N is the value specified using\n" \
" --max-resume-failure-tries option), aria2\n" \
" download file from scratch.\n" \
" downloads file from scratch.\n" \
" See --max-resume-failure-tries option.")
#define TEXT_MAX_RESUME_FAILURE_TRIES \
_(" --max-resume-failure-tries=N When used with --always-resume=false, aria2\n" \
" download file from scratch when aria2 detects N\n" \
" downloads file from scratch when aria2 detects N\n" \
" number of URIs that does not support resume. If N\n" \
" is 0, aria2 download file from scratch when all\n" \
" is 0, aria2 downloads file from scratch when all\n" \
" given URIs do not support resume.\n" \
" See --always-resume option.")