From 073d6ca265ecd89bc63b9febcd4da2fa3d487f62 Mon Sep 17 00:00:00 2001 From: Tatsuhiro Tsujikawa Date: Thu, 13 Nov 2008 15:32:21 +0000 Subject: [PATCH] 2008-11-14 Tatsuhiro Tsujikawa Added INPUT FILE section to man page. Escaped fake URLs. * doc/aria2c.1.txt --- ChangeLog | 6 ++++++ doc/aria2c.1 | 27 ++++++++++++++++++++++++--- doc/aria2c.1.html | 31 ++++++++++++++++++++++++++++--- doc/aria2c.1.txt | 31 +++++++++++++++++++++++++++++-- 4 files changed, 87 insertions(+), 8 deletions(-) diff --git a/ChangeLog b/ChangeLog index 5d2a1d3d..50ad8da4 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2008-11-14 Tatsuhiro Tsujikawa + + Added INPUT FILE section to man page. + Escaped fake URLs. + * doc/aria2c.1.txt + 2008-11-14 Tatsuhiro Tsujikawa Fixed wrong note position for -o option. diff --git a/doc/aria2c.1 b/doc/aria2c.1 index ca64972d..8c537a3f 100644 --- a/doc/aria2c.1 +++ b/doc/aria2c.1 @@ -30,7 +30,11 @@ The directory to store the downloaded file\&. .RS 4 Downloads URIs found in FILE\&. You can specify multiple URIs for a single entity: separate URIs on a single line using the TAB character\&. Reads input from stdin when \fI\-\fR -is specified\&. +is specified\&. The additional +\fBout\fR +and +\fBdir\fR +options can be specified after each line of URIs\&. This optional line must start with white space(s)\&. See INPUT FILE section for details\&. .RE .PP \fB\-l\fR, \fB\-\-log\fR=LOG @@ -304,8 +308,7 @@ Enable HTTP/1\&.1 pipelining\&. Default: .RS 4 Append HEADER to HTTP request header\&. You can use this option repeatedly to specify more than one header: aria2c \fB\-\-header\fR="X\-A: b78" -\fB\-\-header\fR="X\-B: 9J1" -http://host/file +\fB\-\-header\fR="X\-B: 9J1" http://host/file .RE .PP \fB\-\-load\-cookies\fR=FILE @@ -1427,6 +1430,24 @@ You can seed downloaded file using \-\-check\-integrity=true option\&. aria2c \-\-check\-integrity=true file\&.torrent .fi .RE +.SH "INPUT FILE" +The input file can contain list of URIs to feed them into aria2\&. You can specify multiple URIs for a single entity: separate URIs on a single line using the TAB character\&. +.sp +Each line is treated as if it is provided in command\-line argument\&. Therefore they are affected by \fB\-Z\fR and \fB\-P\fR options\&. The additional \fBout\fR and \fBdir\fR options can be specified after each line of URIs\&. This optional line must start with white space(s)\&. +.sp +For example, the content of uri\&.txt is: +.sp +.sp +.RS 4 +.nf +http://server/file\&.iso http://mirror/file\&.iso + dir=/iso_images + out=file\&.img +http://foo/bar +.fi +.RE +and if aria2 is executed with \-i uri\&.txt \-d /tmp options, then file\&.iso is saved as /iso_images/file\&.img and it is downloaded from http://server/file\&.iso and http://mirror/file\&.iso\&. The file bar is downloaded from http://foo/bar and saved as /tmp/bar\&. +.sp .SH "SERVER PERFORMANCE PROFILE" This section describes the format of server performance profile\&. The file is plain text and each line has several NAME=VALUE pair, delimited by comma\&. Currently following NAMEs are recognized: .PP diff --git a/doc/aria2c.1.html b/doc/aria2c.1.html index 1ebcc524..a5867351 100644 --- a/doc/aria2c.1.html +++ b/doc/aria2c.1.html @@ -399,6 +399,9 @@ ARIA2C(1) Manual Page Downloads URIs found in FILE. You can specify multiple URIs for a single entity: separate URIs on a single line using the TAB character. Reads input from stdin when - is specified. + The additional out and dir options can be specified after each line of + URIs. This optional line must start with white space(s). + See INPUT FILE section for details.

@@ -544,7 +547,7 @@ ARIA2C(1) Manual Page In Metalink, BitTorrent download you cannot specify file name. The file name specified here is only used when the URLs fed to aria2 is done by command line without -i, -Z option. For example: -aria2c -o myfile.zip http://mirror1/file.zip http://mirror2/file.zip +aria2c -o myfile.zip http://mirror1/file.zip http://mirror2/file.zip
@@ -772,7 +775,7 @@ aria2c -o myfile.zip http://mirror1/file.zip Append HEADER to HTTP request header. You can use this option repeatedly to specify more than one header: - aria2c --header="X-A: b78" --header="X-B: 9J1" http://host/file + aria2c --header="X-A: b78" --header="X-B: 9J1" http://host/file

@@ -1817,6 +1820,28 @@ you can resume the download without a control file by giving 
aria2c --check-integrity=true file.torrent
+

INPUT FILE

+
+

The input file can contain list of URIs to feed them into aria2. +You can specify multiple URIs for a single entity: +separate URIs on a single line using the TAB character.

+

Each line is treated as if it is provided in command-line argument. +Therefore they are affected by -Z and -P options. +The additional out and dir options can be specified after each line of +URIs. This optional line must start with white space(s).

+

For example, the content of uri.txt is:

+
+
+
http://server/file.iso http://mirror/file.iso
+  dir=/iso_images
+  out=file.img
+http://foo/bar
+
+

and if aria2 is executed with -i uri.txt -d /tmp options, +then file.iso is saved as /iso_images/file.img and it is downloaded from +http://server/file.iso and http://mirror/file.iso. +The file bar is downloaded from http://foo/bar and saved as /tmp/bar.

+

SERVER PERFORMANCE PROFILE

This section describes the format of server performance profile. @@ -1994,7 +2019,7 @@ files in the program, then also delete it here.

diff --git a/doc/aria2c.1.txt b/doc/aria2c.1.txt index b83827ce..c08105f9 100644 --- a/doc/aria2c.1.txt +++ b/doc/aria2c.1.txt @@ -26,6 +26,9 @@ Basic Options Downloads URIs found in FILE. You can specify multiple URIs for a single entity: separate URIs on a single line using the TAB character. Reads input from stdin when '-' is specified. + The additional *out* and *dir* options can be specified after each line of + URIs. This optional line must start with white space(s). + See INPUT FILE section for details. *-l*, *--log*=LOG:: The file name of the log file. If '-' is specified, log is written to @@ -104,7 +107,7 @@ HTTP/FTP Options In Metalink, BitTorrent download you cannot specify file name. The file name specified here is only used when the URLs fed to aria2 is done by command line without *-i*, *-Z* option. For example: -aria2c -o myfile.zip http://mirror1/file.zip http://mirror2/file.zip +aria2c -o myfile.zip \http://mirror1/file.zip \http://mirror2/file.zip *--proxy-method*=METHOD:: Set the method to use in proxy request. @@ -220,7 +223,7 @@ HTTP Specific Options *--header*=HEADER:: Append HEADER to HTTP request header. You can use this option repeatedly to specify more than one header: - aria2c *--header*="X-A: b78" *--header*="X-B: 9J1" http://host/file + aria2c *--header*="X-A: b78" *--header*="X-B: 9J1" \http://host/file *--load-cookies*=FILE:: Load Cookies from FILE using the Firefox3 format(SQLite3) and the @@ -871,6 +874,30 @@ You can seed downloaded file using --check-integrity=true option. aria2c --check-integrity=true file.torrent --------------------------------------------- +INPUT FILE +---------- +The input file can contain list of URIs to feed them into aria2. +You can specify multiple URIs for a single entity: +separate URIs on a single line using the TAB character. + +Each line is treated as if it is provided in command-line argument. +Therefore they are affected by *-Z* and *-P* options. +The additional *out* and *dir* options can be specified after each line of +URIs. This optional line must start with white space(s). + +For example, the content of uri.txt is: +--------------------------------------------- +http://server/file.iso http://mirror/file.iso + dir=/iso_images + out=file.img +http://foo/bar +--------------------------------------------- + +and if aria2 is executed with -i uri.txt -d /tmp options, +then file.iso is saved as /iso_images/file.img and it is downloaded from +\http://server/file.iso and \http://mirror/file.iso. +The file bar is downloaded from \http://foo/bar and saved as /tmp/bar. + SERVER PERFORMANCE PROFILE -------------------------- This section describes the format of server performance profile.