← Back to branch summary

~ubuntu-branches/ubuntu/hardy/sbuild/hardy

« back to all changes in this revision

Viewing changes to man/sbuild-stats.1.in

  • Committer: Bazaar Package Importer
  • Author(s): Roger Leigh, Jan-Marek Glogowski
  • Date: 2008-01-01 11:36:55 UTC
  • mfrom: (8.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080101113655-rxlefdonr61fnikq
Tags: 0.57.0-1
http://bugs.debian.org/449253
* Sbuild/*.pm: Reindent to increase readability.
* Sbuild/Chroot.pm: set APT::Install-Recommends to false inside the
  chroot (Closes: #449253).
* Sbuild/Conf.pm: Add and export $check_depends_algorithm.
  [Jan-Marek Glogowski]
* sbuild:
  - Reindent to increase readability.
  - Add additional syntax checks.  Thanks to Jan-Marek Glogowski.
  - build: Use unicode line drawing characters instead of ASCII.
  - filter_dependencies: Remove redundant conditional.
    [Jan-Marek Glogowski]
  - Add check for check-depends-algorithm option. [Jan-Marek Glogowski]
  - filter_dependencies: Change dependency behaviour depending upon
    check_depends_algorithm.  [Jan-Marek Glogowski]
  - Move to bin/.
* avg-pkg-build-time:
  - Move to bin/.
* bin/*: Reindent to increase readability.
* chroot/*: Reindent to increase readability.
* bin/sbuild-createchroot:
  - Moved from chroot/buildd.chroot.
  - Also install fakeroot and build-essential.
* sbuild-createchroot.1.in: Add manual page.
* chroot/buildd.chroot:
  - Add GPL boilerplate.
  - Remove /etc/passwd creation (already done by debootstrap).
  - Remove sbuild directory creation (already done by schroot).
  - Use here doc to set up /etc/apt/sources.list.
  - List sources.list.
* chroot/README: Rename from README.buildd-chroot.  Remove
  buildd.chroot section.
* example.sbuildrc: Add missing variable types.  [Jan-Marek Glogowski]
* example.sbuildrc: Add missing variable types and add
  $check_depends_algorithm.  [Jan-Marek Glogowski]
* sbuild.1: Document --check-depends-algorithm [Jan-Marek Glogowski]
* Move manual pages to man/.
* debian/manpages: Move manual pages to man/.
* sbuild.conf: Move to etc/.
* example.sbuildrc: Move to etc/.
* debian/compat: Move to debhelper v6 compatibility level.
* debian/control: Update to Standards-Version 3.7.3.
* debian/copyright:
  - Update git repository location.
  - Update GPL boilerplate.
* debian/sbuild.dirs:
  - Rename from debian/dirs.
  - Remove all but -var/lib/sbuild/srcdep-lock.
* debian/manpages: Remove.
* debian/sbuild.postinst: Rename from debian/postinst.
* debian/sbuild.preinst: Rename from debian/preinst.
* debian/sbuild.postrm: Rename from debian/postrm.
* debian/sbuild.install:
  - New file.
  - Install files from usr/sbin and usr/share/man/man8.
* debian/rules:
  - Install sbuild-createchroot, and add buildd.chroot compatibility
    symlink.
  - Move -stamp files to debian/.
  - Remove GENFILES.
  - Run configure, make, and make install in appropriate rules.
  - Use dh_install.
  - Remove all special-cased installation rules (now handled by automake).
* Note: All upstream changes are now in an upstream ChangeLog.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/sbuild-stats.1.in
 
1
.\" Copyright © 1998  James Troup <james@nocrew.org>
 
2
.\" Copyright © 2006  Roger Leigh <rleigh@debian.org>
 
3
.\"
 
4
.\" This program is free software: you can redistribute it and/or modify
 
5
.\" it under the terms of the GNU General Public License as published by
 
6
.\" the Free Software Foundation, either version 2 of the License, or
 
7
.\" (at your option) any later version.
 
8
.\"
 
9
.\" This program is distributed in the hope that it will be useful, but
 
10
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
 
11
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 
12
.\" General Public License for more details.
 
13
.\"
 
14
.\" You should have received a copy of the GNU General Public License
 
15
.\" along with this program.  If not, see
 
16
.\" <http://www.gnu.org/licenses/>.
 
17
.TH SBUILD\-STATS 1 "@RELEASE_DATE@" "Version @VERSION@" "Debian sbuild"
 
18
.SH NAME
 
19
sbuild\-stats \- display or alter database of package build times/space
 
20
.SH SYNOPSIS
 
21
.B sbuild\-stats
 
22
.B avg\-pkg\-build\-time
 
23
.B avg\-pkg\-build\-space
 
24
[\-s/\-\-space] [\-a/\-\-add <package name> <time>] [\-\-delete <package name>] [\-\-dump] [\-t/\-\-top]
 
25
.SH VERSION
 
26
This man page documents the packaged version of sbuild.  This version is
 
27
maintained by the \fBbuildd-tools\fP project developers on Alioth
 
28
(\f[CR]https://alioth.debian.org/projects/buildd\-tools/\fP).
 
29
.SH DESCRIPTION
 
30
\fBsbuild\-stats\fR displays or alters data from a database of package build
 
31
times or space, usually updated by sbuild.  Note: sbuild\-stats was previously
 
32
known as avg\-pkg\-build\-time and avg\-pkg\-build\-space.  When invoked with
 
33
the old names, the database is defaulted to either the build-time or
 
34
build-space database, as if the \fI\-\-time\fP or \fI\-\-space\fP options had
 
35
been used, respectively.
 
36
.PP
 
37
If no option other than the database to use is given, \fBsbuild\-stats\fR will
 
38
display the entire contents of the database.
 
39
.PP
 
40
The database files are only used if they already exist.  See
 
41
\fIREADME.Debian\fP for more information.
 
42
.PP
 
43
.SS OPTIONS
 
44
.TP
 
45
.IR \-a , "\-\-add <package name> <time>"
 
46
Add an entry for a package. <time> is in the format HH:MM:SS, where
 
47
hours and minutes are optional.
 
48
.TP
 
49
.IR "\-\-delete <package name>"
 
50
Remove the data for a package from the database.
 
51
.TP
 
52
.IR "\-\-dump"
 
53
Output the contents of the database in unprocessed form.
 
54
.TP
 
55
.IR \-t , "\-\-time"
 
56
Display build-time database.
 
57
.TP
 
58
.IR \-s , "\-\-space"
 
59
Display build-space database.
 
60
.TP
 
61
.IR "\-\-top"
 
62
Sort the output by build time; longest build first.
 
63
.SH ENVIRONMENT VARIABLES
 
64
The following environment variables are used by \fBsbuild\-stats\fR:
 
65
.IP HOME
 
66
The home directory of the user.
 
67
.SH FILES
 
68
\fBsbuild\-stats\fR reads the sbuild configuration files
 
69
\fI/etc/sbuild/sbuild.conf\fP and \fI~/.sbuildrc\fP (if it exists) to discover
 
70
the location of the databases, which are usually located under
 
71
\fI/var/lib/sbuild\fP.
 
72
.SH EXAMPLES
 
73
To view the average build time for the \fIkoffice\fP package:
 
74
.PP
 
75
\f[CR]% \f[CB]sbuild-stats --time koffice\fP\fP
 
76
.br
 
77
koffice:                02:44:55 (1 entry, sigma 00:00:00)
 
78
.PP
 
79
To view the average build space for the \fIkoffice\fP package:
 
80
.PP
 
81
\f[CR]% \f[CB]sbuild-stats --space koffice\fP\fP
 
82
.br
 
83
koffice:                1597724k (1597724k latest)
 
84
\f[CR]% \f[CB]sbuild\-update unstable\fP\fP
 
85
.br
 
86
.SH AUTHORS
 
87
.nf
 
88
Roman Hodek.
 
89
Roger Leigh.
 
90
.fi
 
91
.SH COPYRIGHT
 
92
.nf
 
93
Copyright \[co] 2006\[en]2007 Roger Leigh <rleigh@debian.org>.
 
94
Copyright \[co] 1998 Roman Hodek <Roman.Hodek@informatik.uni-erlangen.de>.
 
95
.fi
 
96
.SH "SEE ALSO"
 
97
.BR sbuild (1),
 
98
.BR sbuild\-apt (1),
 
99
.BR sbuild\-upgrade (1).
 
100
.\"#
 
101
.\"# The following sets edit modes for GNU EMACS
 
102
.\"# Local Variables:
 
103
.\"# mode:nroff
 
104
.\"# fill-column:79
 
105
.\"# End: