.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH DIRSUM 1 "May 2010" UNIX "User Manuals"
.SH NAME
Dirsum - directory summary
.SH SYNOPSIS
.B dirsum [
.I -r
.B ] [
.I path
.B ]

.SH DESCRIPTION

\fBDirsum\fP gives  a more  complete and descriptive  information than
using existing command line tools like du.

It is a command line tool to assist sorting out which directories in a
filesystem  contain  the  most  bytes.    It  will  sort  all  of  the
subdirectories of  a selected \fBpath\fP according to  the total bytes
of   all  files   in   them,  including   recursion  through   further
subdirectories.   If  not \fBpath\fP  is  specified,  dirsum uses  the
current directory from where it is called.


.SH OPTIONS
.IP "-r"
continue recursion into new partitions mounted in subdirectories

.SH AUTHORS
.nf
Dirk Bartley - author <\fIdirk@rustyloon.net\fR>

Denis "Jaromil" Roio - current maintainer <\fIhttp://rastasoft.org\fR>
.fi

Dirsum  has   been  around  for  a  while   without  maintenance,  its
documentation  has limited  information about  the year  of  its first
release, however  it seems that the  last version written  by Dirk has
been  0.3 released around  the year  2004, while  in 2010  Jaromil has
taken charge for its maintenance and inclusion in Debian GNU/Linux.

.SH COPYING
Permission is  granted to copy,  distribute and/or modify  this manual
under the terms of the  GNU Free Documentation License, Version 1.1 or
any later version  published by the Free Software  Foundation; with no
Invariant  Sections.  Permission  is  granted to  make and  distribute
verbatim  copies of  this  manual page  provided  the above  copyright
notice and this permission notice are preserved on all copies.

.SH AVAILABILITY
The most recent  version of \fIDirsum\fR can be  attained from its GIT
repository     at    \fIhttp://code.dyne.org\fR    and     from    the
\fIftp.dyne.org\fR software repository.