add HISTORY to various man pages

[plan9front.git] / sys / man / 1 / torrent

diff --git a/sys/man/1/torrent b/sys/man/1/torrent
index e4a215762c852974d13a9ddbaa08e325652a5d9b..31cc848a6d8b93fa0d35e8a750f52b5ad2cd7dac 100644 (file)
--- a/sys/man/1/torrent
+++ b/sys/man/1/torrent
@@ -14,7 +14,10 @@ torrent \- bittorrent client
 .I mtpt
 ] [
 .B -t
-.I url
+.I tracker-url
+] [
+.B -w
+.I webseed-url
 ] [
 .B -s
 ] [
@@ -42,13 +45,23 @@ option. If provided,
 .I torrent
 reads the file given at the final
 .I file
-argument (or standard-input when omited) and writes
+argument (or standard-input when omitted) and writes
 a torrent file to standard-output and exits.
-A tracker
-.I url
+A
+.I tracker-url
 should be given with the
 .B -t
-option in that case.
+option in that case. A list of trackers can be obtained
+on the web, see the examples below.
+.PP
+If the files in the torrent are also available from a url, a
+.I webseed-url
+can be passed with the
+.B -w
+option. If
+.I webseed-url
+ends with a slash, the filename, from the torrent, concatenated
+with the url forms the target url.
 .PP
 Without the
 .B -c
@@ -105,8 +118,17 @@ hget http://r-36.net/9front/9front.iso.bz2.torrent | \\
        ip/torrent -pv | \\
        aux/statusbar 'download...'
 .EE
+.LP
+Get list of public alive trackers to choose from
+.EX
+hget http://www.trackon.org/api/live
+.EE
+.LP
 .SH SOURCE
 .B /sys/src/cmd/ip/torrent.c
 .SH "SEE ALSO"
 .IR hget (1),
 .IR webfs (4)
+.SH HISTORY
+.I Torrent
+first appeared in 9front (October, 2011).