Updated man page

doc/aria2c.1

@@ -1,11 +1,11 @@
 .\"     Title: aria2c
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
-.\"      Date: 06/23/2007
+.\"      Date: 07/06/2007
 .\"    Manual: 
 .\"    Source: 
 .\"
-.TH "ARIA2C" "1" "06/23/2007" "" ""
+.TH "ARIA2C" "1" "07/06/2007" "" ""
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -24,7 +24,7 @@ aria2c [OPTIONS] \-M METALINK_FILE
 .SH "DESCRIPTION"
 aria2 is a utility for downloading files. It has completely new design concept from its predecessor, Aria, and is written from scratch. aria2 has a segmented downloading engine in its core. It can download one file from multiple URLs or multiple connections from one URL. This results in very high speed downloading, much faster than ordinary browsers. This engine in was implemented in a single\-thread model. The architecture is clean and easy to extend. aria2 currently supports HTTP, FTP, and BitTorrent. It also supports Metalink version 3.0.
 .sp
-Please visit the project web site at http://aria2.sourceforge.net
+Please visit the project web site at http://aria2.sourceforge.net/
 .sp
 .SH "OPTIONS"
 .PP
@@ -249,12 +249,16 @@ Disables netrc support.
 \-i, \-\-input\-file=FILE
 .RS 4
 Downloads URIs found in
-\fIFILE\fR. You can specify multiple URIs for a single entity: deliminate URIs by Tab in a single line.
+\fIFILE\fR. You can specify multiple URIs for a single entity: deliminate URIs by Tab in a single line. Reads input from stdin when
+\fI\-\fR
+is specified.
 .RE
 .PP
 \-j, \-\-max\-concurrent\-downloads=N
 .RS 4
-Set maximum number of concurrent downloads. Default:
+Set maximum number of concurrent downloads. It should be used with
+\fI\-i\fR
+option. Default:
 \fI5\fR
 .RE
 .PP
@@ -266,6 +270,28 @@ Load cookies from
 is one used by Netscape and Mozilla.
 .RE
 .PP
+\-S, \-\-show\-files
+.RS 4
+Print file listing of .torrent or .metalink file and exit.
+.RE
+.PP
+\-\-select\-file=INDEX\&...
+.RS 4
+Set file to download by specifing its index. You can know file index through
+\fI\-\-show\-files\fR
+option. Multiple indexes can be specified by using
+\fI,\fR
+like "3,6". You can also use
+\fI\-\fR
+to specify rangelike "1\-5".
+\fI,\fR
+and
+\fI\-\fR
+can be used together. When used with \-M option, index may vary depending on the query(see
+\fI\-\-metalink\-*\fR
+options).
+.RE
+.PP
 \-T, \-\-torrent\-file=TORRENT_FILE
 .RS 4
 The file path to .torrent file.
@@ -279,11 +305,6 @@ prevents aria2 to enter BitTorrent mode even if the filename of downloaded file
 \fItrue\fR
 .RE
 .PP
-\-S, \-\-show\-files
-.RS 4
-Print file listing of .torrent file and exit.
-.RE
-.PP
 \-\-direct\-file\-mapping=true|false
 .RS 4
 Directly read from and write to each file mentioned in .torrent file. Default:
@@ -292,7 +313,8 @@ Directly read from and write to each file mentioned in .torrent file. Default:
 .PP
 \-\-listen\-port=PORT
 .RS 4
-Set port number to listen to for peer connection. Default: 6881\-6999
+Set port number to listen to for peer connection. Default:
+\fI6881\-6999\fR
 .RE
 .PP
 \-\-max\-upload\-limit=SPEED
@@ -306,21 +328,6 @@ or
 \fI0\fR
 .RE
 .PP
-\-\-select\-file=INDEX\&...
-.RS 4
-Set file to download by specifing its index. You can know file index through
-\fI\-\-show\-files\fR
-option. Multiple indexes can be specified by using
-\fI,\fR
-like "3,6". You can also use
-\fI\-\fR
-to specify rangelike "1\-5".
-\fI,\fR
-and
-\fI\-\fR
-can be used together.
-.RE
-.PP
 \-\-seed\-time=MINUTES
 .RS 4
 Specify seeding time in minutes. See also
@@ -422,6 +429,21 @@ You can mix up different protocols
 aria2c http://AAA.BBB.CCC/file.zip ftp://DDD.EEE.FFF/GGG/file.zip
 .RE
 .PP
+Download files listed in a text file. 5 files are downloaded concurrently
+.RS 4
+aria2c \-i uris.txt \-j 5
+.RE
+.PP
+Download files passed through stdin
+.RS 4
+cat uris.txt | aria2c \-i \-
+.RE
+.PP
+Download a file using local cookies
+.RS 4
+aria2c \-\-load\-cookies cookies.txt http://AAA.BBB.CCC/file.zip
+.RE
+.PP
 Download a torrent
 .RS 4
 aria2c \-o test.torrent http://AAA.BBB.CCC/file.torrent
@@ -437,6 +459,11 @@ Download only selected files
 aria2c \-T test.torrent dir/file1.zip dir/file2.zip
 .RE
 .PP
+Download only selected files using index
+.RS 4
+aria2c \-T test.torrent \-\-select\-file 1,3\-5
+.RE
+.PP
 Print file listing of .torrent file
 .RS 4
 aria2c \-T test.torrent \-S
@@ -456,6 +483,21 @@ Metalink downloading with preferences
 .RS 4
 aria2c \-M test.metalink \-\-metalink\-version=1.1.1 \-\-metalink\-language=en\-US
 .RE
+.PP
+Download only selected files
+.RS 4
+aria2c \-T test.metalink \-\-metalink\-language=en\-US dir/file1.zip dir/file2.zip
+.RE
+.PP
+Download only selected files using index
+.RS 4
+aria2c \-T test.metalink \-\-metalink\-language=en\-US \-\-select\-file 1,3\-5
+.RE
+.PP
+Print file listing of .metalink file
+.RS 4
+aria2c \-T test.torrent \-S \-\-metalink\-language=en\-US
+.RE
 .SH "FILES"
 .PP
 aria2.conf

doc/aria2c.1.txt

@@ -25,7 +25,7 @@ browsers. This engine in was implemented in a single-thread model.
 The architecture is clean and easy to extend. aria2 currently supports HTTP,
 FTP, and BitTorrent. It also supports Metalink version 3.0.
 
-Please visit the project web site at http://aria2.sourceforge.net
+Please visit the project web site at http://aria2.sourceforge.net/
 
 OPTIONS
 -------
@@ -171,17 +171,33 @@ OPTIONS
 
  -i, --input-file=FILE::
         Downloads URIs found in 'FILE'. You can specify
-                              multiple URIs for a single entity: deliminate
-                              URIs by Tab in a single line.
+        multiple URIs for a single entity: deliminate
+        URIs by Tab in a single line.
+        Reads input from stdin when '-' is specified.
 
  -j, --max-concurrent-downloads=N::
          Set maximum number of concurrent downloads.
+         It should be used with '-i' option.
          Default: '5'
 
  --load-cookies=FILE::
           Load cookies from 'FILE'. The format of 'FILE' is
                               one used by Netscape and Mozilla.
 
+ -S, --show-files::
+     Print file listing of .torrent or .metalink file
+     and exit.
+
+ --select-file=INDEX...::
+       Set file to download by specifing its index.
+       You can know file index through '--show-files'
+       option. Multiple indexes can be specified by using
+       ',' like "3,6".
+       You can also use '-' to specify rangelike "1-5".
+       ',' and '-' can be used together.
+       When used with -M option, index may vary depending
+       on the query(see '--metalink-*' options).
+
  -T, --torrent-file=TORRENT_FILE::
   The file path to .torrent file.
 
@@ -191,9 +207,6 @@ OPTIONS
                               downloaded file ends with .torrent.
                               Default: 'true'
 
- -S, --show-files::
-             Print file listing of .torrent file and exit.
-
  --direct-file-mapping=true|false::
  Directly read from and write to each file
                               mentioned in .torrent file.
@@ -201,7 +214,7 @@ OPTIONS
 
  --listen-port=PORT::
            Set port number to listen to for peer connection.
-           Default: 6881-6999
+           Default: '6881-6999'
 
  --max-upload-limit=SPEED::
      Set max upload speed in bytes per sec.
@@ -209,14 +222,6 @@ OPTIONS
                               You can append 'K' or 'M'(1K = 1024, 1M = 1024K).
                               Default: '0'
 
- --select-file=INDEX...::
-       Set file to download by specifing its index.
-                              You can know file index through '--show-files'
-                              option. Multiple indexes can be specified by using
-                              ',' like "3,6".
-                              You can also use '-' to specify rangelike "1-5".
-                              ',' and '-' can be used together.
-
  --seed-time=MINUTES::
           Specify seeding time in minutes. See also
                               '--seed-ratio' option.
@@ -279,6 +284,12 @@ EXAMPLES
   aria2c http://AAA.BBB.CCC/file.zip http://DDD.EEE.FFF/GGG/file.zip
  You can mix up different protocols::
   aria2c http://AAA.BBB.CCC/file.zip ftp://DDD.EEE.FFF/GGG/file.zip
+ Download files listed in a text file. 5 files are downloaded concurrently::
+  aria2c -i uris.txt -j 5
+ Download files passed through stdin::
+  cat uris.txt | aria2c -i -
+ Download a file using local cookies::
+  aria2c --load-cookies cookies.txt http://AAA.BBB.CCC/file.zip
 
  Download a torrent::
   aria2c -o test.torrent http://AAA.BBB.CCC/file.torrent
@@ -286,6 +297,8 @@ EXAMPLES
   aria2c -T test.torrent
  Download only selected files::
   aria2c -T test.torrent dir/file1.zip dir/file2.zip
+ Download only selected files using index::
+  aria2c -T test.torrent --select-file 1,3-5
  Print file listing of .torrent file::
   aria2c -T test.torrent -S
 
@@ -295,6 +308,12 @@ EXAMPLES
   aria2c -M test.metalink
  Metalink downloading with preferences::
   aria2c -M test.metalink --metalink-version=1.1.1 --metalink-language=en-US
+ Download only selected files::
+  aria2c -T test.metalink --metalink-language=en-US dir/file1.zip dir/file2.zip
+ Download only selected files using index::
+  aria2c -T test.metalink --metalink-language=en-US --select-file 1,3-5
+ Print file listing of .metalink file::
+  aria2c -T test.torrent -S --metalink-language=en-US
 
 FILES
 -----