]> git.lizzy.rs Git - plan9front.git/blobdiff - sys/man/8/statusbar
games/mix: Add Knuth MIX emulator/assembler
[plan9front.git] / sys / man / 8 / statusbar
index f79e1b64bfdd645f777f6c02d955d37f70053a79..8f3b09a01fcebac17d0ef4b71f8d181989446cef 100644 (file)
@@ -1,6 +1,6 @@
 .TH STATUSBAR 8
 .SH NAME
-statusbar \- display a bar graph status window
+statusbar, statusmsg \- display a bar graph or status message window
 .SH SYNOPSIS
 .B aux/statusbar
 [
@@ -11,20 +11,33 @@ statusbar \- display a bar graph status window
 .I minx,miny,maxx,maxy
 ]
 .I title
+.br
+.B aux/statusmsg
+[
+.B -kt
+]
+[
+.B -w
+.I minx,miny,maxx,maxy
+] [
+.I title
+]
 .SH DESCRIPTION
-.I Aux/statusbar
-reads textual status lines
-from standard input, converting them into a
-continuously updated bar graph displayed in a new window
-on the screen.
+.I Statusbar
+and
+.I statusmsg
+read textual status lines from standard input into a
+continuously updated bar graph or text message displayed in
+a new window on the screen.
 The
 .I title
-is displayed on a line above the bar graph.
-Each input line is two space-separated decimal numbers:
+is displayed on a line above the bar graph or message.
+For
+.I statusbar,
+each input line is two space-separated decimal numbers:
 the numerator and denominator of a fraction.
 .PP
-.I Statusbar
-exits when it reaches end-of-file on standard input.
+The programs exit when it reaches end-of-file on standard input.
 Typing
 .SM DEL
 or control-C
@@ -33,39 +46,16 @@ will also cause it to exit.
 The options are:
 .TP
 .B -k
-do not allow typing to cause
-.I statusbar
-to exit
+do not allow typing to cause exit
 .TP
 .B -t
-print an ASCII status bar to standard output, using
-backspace to redraw it
+print an ASCII version of the bar or message to standard output, using
+backspace to redraw it
 .TP
 .B -w
-set the coordinates of the statusbar window created
+set the coordinates of the window created
 .PD
-.SH EXAMPLE
-The
-.B -v
-option to
-.IR hget (1)
-.\" and the 
-.\" .B -d
-.\" option to
-.\" .IR venti/fmtarenas
-.\" and
-.\" .I venti/fmtisect
-.\" (see
-.\" .IR venti-fmt (8))
-causes it to print status lines suitable for
-input to
-.IR statusbar .
-.PP
-Monitor a long download:
-.IP
-.EX
-hget -v -o bigfile http://server.com/bigfile |[2]
-  aux/statusbar 'big file download'
-.EE
 .SH SOURCE
 .B /sys/src/cmd/aux/statusbar.c
+.br
+.B /sys/src/cmd/aux/statusmsg.c