.\" $Id: du2ps.1,v 3.1 2005/02/19 08:29:53 mac Exp $
.\" Copyleft 1994-2005 nagae@media.t-kougei.ac.jp and mac@line.to
.\" du2ps.man
.\""
.TH du2ps 1 "Feb 19, 2005"
.SH NAME
du2ps \- filter for converting output of du to PostScript file
.SH SYNOPSIS
.B du2ps
[
.I options
]
<
.I du_out_file
>
.I ps_file
.SH DESCRIPTION
The
.B du2ps
reads the output of
.BR du (1),
then print a figure of hierarchic structure and volume of
directory as one page PostScript file.
.PP
Each directory are illustrated as a rectangle in its volume descending order
with height corresponding to its volume, and sub directories are placed
from left to right recursively. 
.SH OPTIONS
.TP
.B \-land
Layout in landscape.
.TP
.B \-port
Layout in portrait (default).
.TP
.B \-sa
Place directories in alphabetical order.
.TP
.B \-ss
Place directories in volume order (default).
.TP
.B \-bw
Monocrome mode (default).
.TP
.B \-color
Color mode (8 colors).
.TP
.B \-ncolor num
Color mode with number of colors.
.TP
.B \-a3
.TP
.B \-a4
.TP
.B \-b4
.TP
.B \-b5
.TP
.B \-us
Switch page size to A3, A4, B4, B5, or US letter. Default size is A4.
.TP
.BI \-ff " name"
Specify the font name for text. Default font is Times-Roman.
.TP
.BI \-fs " size"
Specify the font size. Default size is 8.0 [pt].
.TP
.BI \-ms " size"
Specify the margin size around a page. Default margin is 50.0 [pt].
.TP
.BI \-lw " size"
Specify the width of line to draw the rectangle area. Default value is 0.5 [pt].
.TP
.BI \-ncols " num"
Specify number of rectangle columns (maximum directory depth).
Default value is 7 for portrait and 10 for landscape.
.TP
.BI \-eps " width height"
Output in EPS format.
.I Width
and
.I height
are the width and height of a BoundingBox.
.SH EXAMPLES
.B " du | du2ps | lpr
.IP
The most left directory name becomes ``.'', and print ``The number of disk
blocks used at .'' in the upper left corner.
.
.B " du /home/taro/work | du2ps | lpr
.PP
.B " du ~taro/work | du2ps | lpr
.IP
The most left directory name becomes ``work'', and print
``The number of disk blocks used at /home/taro/work'' 
in the upper left corner.
.PP
.B " du ../../ps | du2ps -us -fs 16 > tmp.ps; gs tmp.ps
.IP
The most left directory name becomes ``ps'', and print
``The number of disk blocks used at ../../ps''
in the upper left corner.
The ``-us'' option makes the page to fit a whole paper, 
because the default paper size of GhostScript is US letter.
.PP
.B " du ~taro/work ~taro/bin | du2ps -eps 200 300 > fig1.eps
.IP
The most left directory name becomes ``taro'', and print
``The number of disk blocks used at /home/taro''
in the upper left corner.
Output will be commented with ``%%BoundingBox: 0 0 200 300''.
.PP
.B " du work bin | du2ps -eps 100 100 -fs 4 > fig2.eps
.IP
The most left directory name becomes ``..'', and print
``The number of disk blocks used at''
in the upper left corner.
.SH SEE ALSO
.BR du (1),
.BR xdu (1)
.SH AUTHORS
Takanori Nagae <nagae@media.t-kougei.ac.jp> and
Shigeru Makino <mac@line.to>
.PP
The du2ps is based on xdu.
The author of xdu is Phillip C. Dykstra <phil@BRL.MIL>.