5e(1), ssam(1): small corrections, torrent(1): explain what BitTorrent is

sys/man/1/5e

@@ -16,7 +16,8 @@ simulates the execution of an ARM binary in a Plan 9 environment.
 Unlike its predecessor
 .IR vi (1)
 it supports, among others, the syscalls
-.IR rfork (2)
+rfork (see
+.IR fork (2))
 and
 .IR exec (2),
 which allows for the execution of threaded programs (e.g.,

sys/man/1/ssam

@@ -60,7 +60,7 @@ by
 .B ssam 'y/[a-zA-Z]+/ c/\en/' | grep . | sort | uniq -c
 Count frequency of words read from standard input.
 .SH SOURCE
-.B \*9/bin/ssam
+.B /rc/bin/ssam
 .SH SEE ALSO
 .IR sed (1), 
 .IR sam (1),

sys/man/1/torrent

@@ -2,7 +2,7 @@
 .SH NAME
 torrent \- bittorrent client
 .SH SYNOPSIS
-.B torrent
+.B ip/torrent
 [
 .B -d
 ]
@@ -23,53 +23,67 @@ torrent \- bittorrent client
 .I file
 ]
 .SH DESCRIPTION
-.I Torrent
+BitTorrent is a protocol for efficient file distribution
-downloads the files that are specified in the torrent
+over the internet. Files are split into small pieces
-.I file
+that are then downloaded by clients in random order.
-in the current working directory. If no
+As soon as a client completes a piece, it makes the piece 
-.I file
+available for others to download.
-is given, standard-input is used.
 .PP
-Normally,
+To find find other clients (peers), a tracker-server is
-.I torrent
+contacted.
-exits after all files have been downloaded. 
+.PP
+Before files can be transmitted, a torrent-file needs
+to be created describing the pieces of the files and
+other meta-data like network addresses of the trackers.
+.PP
+.I Torrent
+downloads the files that are described in the torrent-file
+given by the
+.I file
+argument to the current working directory. If no
+.I file
+is given, the torrent is read from standard-input.
+.PP
+Normally, the program exits immediately after all pieces
+have been completed.
 The
 .B -s
-option causes 
+option causes it to keep running and serve the remaining
-.I torrent
+clients (also known as seeding).
-to keep seeding.
 .PP
-An alternative mountpoint of the
+Trackers use a subset of the HTTP protocol, so an
+alternative 
 .IR webfs (4)
-filesystem can be given with the
+mountpoint can be given with the
 .B -m
 option (defaults to
 .BR /mnt/web ).
-.SH DIAGNOSTICS
-The
-.B -d
-option enables debug output to standard-error.
 .PP
 The
 .B -v
 option causes
 .I torrent
-to list the files contained in the content
+to list the files in the torrent-file before downloading.
-before downloading.
+.PP
+The
+.B -d
+option produces verbose debug output to standard-error.
 .PP
 To monitor the download progress, the
 .B -p
-option can be given to cause
+option can be given to cause the completed and total number of
-.I torrent
+pieces written as a line of text to standard-output in one
-to print the current and the total number of pieces
+second intervals.
-to download every second.
 .SH EXAMPLE
+Download the latest iso file of the distribution 
 .EX
 cd /tmp
-hget http://r-36.net/9front/9front.iso.bz2.torrent | ip/torrent -pv | aux/statusbar 'download...'
+hget http://r-36.net/9front/9front.iso.bz2.torrent | \\
+	ip/torrent -pv | \\
+	aux/statusbar 'download...'
 .EE
 .SH SOURCE
 .B /sys/src/cmd/ip/torrent.c
-.SH "SEE ALSO
+.SH "SEE ALSO"
 .IR hget (1),
 .IR webfs (4)