.\"
.\" avg-pkg-build-time.1 - the *roff document processor source for the avg-pkg-build-time manual
.\"
.\" This file is part of Debian GNU/Linux's prepackaged version of wanna-build.
.\" Copyright (C) 1998 James Troup <james@nocrew.org>.
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License , or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; see the file COPYING.  If not, write to
.\" the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
.\"
.TH avg-pkg-build-time 1 .\" "Command Manual" 1998-11-17 "November 17, 1998"
.SH NAME
avg-pkg-build-time \- display or alter database of package build times/space
.SH SYNOPSIS
.B avg-pkg-build-time
.B avg-pkg-build-space
[\-s/\-\-space] [\-a/\-\-add <package name> <time>] [\-\-delete <package name>] [\-\-dump] [\-t/\-\-top]
.SH VERSION
This man page documents avg-pkg-build from 1999-05-04.
.SH DESCRIPTION
\fBavg-pkg-build-time\fR displays or alters data from a database of
package build times or space, usually updated by sbuild.
.PP
If no option is given \fBavg-pkg-build-time\fR will display the entire
contents of the database. If called as \fBavg-pkg-build-space\fR, it
will use the database of build space requirements.
.PP
.SS OPTIONS
.TP
.IR \-a , "--add <package name> <time>"
Add an entry for a package. <time> is in the format HH:MM:SS, where
hours and minutes are optional.
.TP
.IR "--delete <package name>"
Remove the data for a package from the database.
.TP
.IR "--dump"
Output the contents of the database in unprocessed form.
.TP
.IR \-s , "--space"
Display space instead of time.
.TP
.IR \-t , "--top"
Sort the output by build time; longest build first.
.SH ENVIRONMENT VARIABLES
The following environment variables are used by \fBavg-pkg-build-time\fR:
.IP "HOME"
The home directory of the user.
.SH FILES
\fBavg-pkg-build-time\fR reads the sbuild configuration files
(/etc/sbuild.conf and ~/.sbuildrc (if it exists)) to discover the
location of the database.
.SH DIAGNOSTICS
None.
.SH BUGS
None known at this time.
.PP
Email bug reports to
.BR buildd-disc@nocrew.org .
Be sure to include the word ``avg-pkg-build-time'' somewhere in the ``Subject:'' field.
.SH AUTHOR
.nf
Roman Hodek
Roman.Hodek@informatik.uni-erlangen.de
.fi
.SH "SEE ALSO"
.SP
.BR sbuild ( 1 ),
.BR sbuild.conf ( 5 ),
.BR sbuildrc ( 5 ).