909bd77
.TH "DBAR" 1 "Jan 01 2008"
909bd77
.SH NAME
909bd77
dzen2-dbar \- simple gadget that you can use in combination with dzen to display a progressbar.
909bd77
.SH SYNOPSIS
909bd77
.HP 7
909bd77
\fBdzen2-dbar\fR [\-w \fIcharacters\fR] [\-s \fIsymbol\fR] [\-min \fIminvalue\fR] [\-max \fImaxvalue\fR] [\-l \fIstring\fR] [\-nonl]
909bd77
.SH DESCRIPTION
909bd77
.B dbar
909bd77
is an application that generates semi graphical progress meters, from some values you supply to it.
909bd77
.PP
909bd77
See the usage examples for a description of the expected input format.
909bd77
.SH OPTIONS
909bd77
A summary of options is included below.
909bd77
.TP
909bd77
.B \-max
909bd77
Value to be considered 100% (default: 100)
909bd77
.TP
909bd77
.B \-min
909bd77
Value to be considered 0% (default: 0)
909bd77
.TP
909bd77
.B \-w
909bd77
Number of charcaters to be considered 100% in the bar  (default: 25 )
909bd77
.TP
909bd77
.B \-s
909bd77
Symbol represeting the percentage value in the bar (default: =  )
909bd77
.TP
909bd77
.B \-l
909bd77
label to be prepended to the bar (default: '' )
909bd77
.TP
909bd77
.B \-nonl
909bd77
no new line, don't put '\n' at the end of the bar    (default: do print '\n')
909bd77
.SH USAGE EXAMPLES
909bd77
.TP
909bd77
.B Static 0% and 100% mark or single value input:
909bd77
.ip
909bd77
Command: echo 25 | dbar -m 100 -l Sometext
909bd77
.br
909bd77
Output: Sometext  25% [======                   ]
909bd77
.TP
909bd77
.B If your 100% mark changes dynamically or 2-values input:
909bd77
.ip
909bd77
Command: echo "50 150" | dbar
909bd77
.br
909bd77
Output: 33% [========                 ]
909bd77
.TP
909bd77
.B If your value range is not between [0, maxval] or 3-values input:
909bd77
.ip
909bd77
Command: echo "50 -25 150" | dbar
909bd77
.br
909bd77
Output: 43% [===========              ]
909bd77
.PP
909bd77
Dbar was written by Robert Manea.
909bd77
.PP
909bd77
This manual page was written by bertagaz <bertagaz@ptitcanardnoir.org>,
909bd77
for the Debian project (but may be used by others).