statusbar 1.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. .TH STATUSBAR 8
  2. .SH NAME
  3. statusbar \- display a bar graph status window
  4. .SH SYNOPSIS
  5. .B aux/statusbar
  6. [
  7. .B -kt
  8. ]
  9. [
  10. .B -w
  11. .I minx,miny,maxx,maxy
  12. ]
  13. .I title
  14. .SH DESCRIPTION
  15. .I Aux/statusbar
  16. reads textual status lines
  17. from standard input, converting them into a
  18. continuously updated bar graph displayed in a new window
  19. on the screen.
  20. The
  21. .I title
  22. is displayed on a line above the bar graph.
  23. Each input line is two space-separated decimal numbers:
  24. the numerator and denominator of a fraction.
  25. .PP
  26. .I Statusbar
  27. exits when it reaches end-of-file on standard input.
  28. Typing
  29. .SM DEL
  30. or control-C
  31. will also cause it to exit.
  32. .PP
  33. The options are:
  34. .TP
  35. .B -k
  36. do not allow typing to cause
  37. .I statusbar
  38. to exit
  39. .TP
  40. .B -t
  41. print an ASCII status bar to standard output, using
  42. backspace to redraw it
  43. .TP
  44. .B -w
  45. set the coordinates of the statusbar window created
  46. .PD
  47. .SH EXAMPLE
  48. The
  49. .B -v
  50. option to
  51. .IR hget (1)
  52. .\" and the
  53. .\" .B -d
  54. .\" option to
  55. .\" .IR venti/fmtarenas
  56. .\" and
  57. .\" .I venti/fmtisect
  58. .\" (see
  59. ,\" .IR ventiaux (8))
  60. causes it to print status lines suitable for
  61. input to
  62. .IR statusbar .
  63. .PP
  64. Monitor a long download:
  65. .IP
  66. .EX
  67. hget -v -o bigfile http://server.com/bigfile |[2]
  68. aux/statusbar 'big file download'
  69. .EE
  70. .SH SOURCE
  71. .B /sys/src/cmd/aux/statusbar.c