'\" t
.\"     Title: ben
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 09/21/2015
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "BEN" "1" "09/21/2015" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ben \- transition tracker manager
.SH "SYNOPSIS"
.sp
\fBben\fR \fIFRONTEND\fR [\fIOPTIONS\fR]
.sp
\fBben\fR [\-h|\-help|\-\-help]
.SH "DESCRIPTION"
.sp
The ben(1) command is a set of utilities written in OCaml\&. It provides a full featured transition tracker to follow the evolution of a set of packages in the Debian\(cqs archive\&. All frontends share a common list of options described below\&.
.SH "OPTIONS"
.PP
\fB\-\-dry\-run\fR
.RS 4
Dry run
.RE
.PP
\fB\-\-quiet|\-q\fR
.RS 4
Quiet mode
.RE
.PP
\fB\-\-verbose\fR
.RS 4
Verbose mode
.RE
.PP
\fB\-\-mirror uri\fR
.RS 4
Package mirror to use
.RE
.PP
\fB\-\-mirror\-binaries uri\fR
.RS 4
Package mirror to use for binaries
.RE
.PP
\fB\-\-mirror\-sources uri\fR
.RS 4
Package mirror to use for sources
.RE
.PP
\fB\-\-areas a,\&...\fR
.RS 4
Areas to consider (comma separated)
.RE
.PP
\fB\-\-archs a,\&...\fR
.RS 4
Architectures to consider (comma separated)
.RE
.PP
\fB\-\-suite a\fR
.RS 4
Suite
.RE
.PP
\fB\-\-cache\-dir d\fR
.RS 4
Path to cache dir
.RE
.PP
\fB\-\-cache\-file|\-C f\fR
.RS 4
Specify the name of the cache file
.RE
.PP
\fB\-\-use\-cache\fR
.RS 4
Use cache whenever possible
.RE
.PP
\fB\-\-config|\-c c\fR
.RS 4
Config file
.RE
.PP
\fB\-\-more\-binary\-keys l\fR
.RS 4
Comma separated list of further relevant binary keys
.RE
.PP
\fB\-\-more\-source\-keys l\fR
.RS 4
Comma separated list of further relevant source keys
.RE
.PP
\fB\-\-preferred\-compression\-format f\fR
.RS 4
Preferred compression format (Default: Gzip)
.RE
.SH "FRONTENDS"
.PP
\fBdownload\fR
.RS 4
has no command\-line options, except the shared ones\&. It downloads all Sources\&.gz files and all Packages\&.gz files for selected architectures and areas\&.
.RE
.PP
\fBquery\fR
.RS 4
This utility is pretty much like grep\-dctrl(1)\&. Given a list of Packages or Sources files, it performs a query and outputs the result\&.
.RE
.PP
\fBmonitor\fR
.RS 4
The frontend monitor builds a monitor page for a transition that is described by few criteria (the list of affected packages, a description of good package and the description of a broken package)\&.
.RE
.PP
\fBtracker\fR
.RS 4
This frontend uses the monitor to generate a summary page about all known transitions\&. An example of such summary can be found at
http://release\&.debian\&.org/transitions/\&.
.RE
.sp
For more information about ben\(cqs frontends, please refer to the reference manual\&.
.SH "AUTHOR"
.sp
Ben was originally written by Stéphane Glondu\&.
.SH "RESOURCES"
.sp
Main web site: http://ben\&.debian\&.net/