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