110 lines
4 KiB
Groff
110 lines
4 KiB
Groff
.\" Copyright 2005 Lars Wirzenius
|
|
.\"
|
|
.\" 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. If not, see <https://www.gnu.org/licenses/>.
|
|
.\"
|
|
.TH DD\-LIST 1 2011-10-27 "Debian"
|
|
.\" --------------------------------------------------------------------
|
|
.SH NAME
|
|
dd\-list \- nicely list .deb packages and their maintainers
|
|
.\" --------------------------------------------------------------------
|
|
.SH SYNOPSIS
|
|
.BR dd\-list " [" \-hiusV "] [" \-\-help "] [" \-\-stdin "]"
|
|
.BR "" "[" "\-\-sources \fISources_file" "]
|
|
.BR "" "[" \-\-dctrl "] [" \-\-version "] [" \-\-uploaders "] [" \fIpackage " ...]"
|
|
.\" --------------------------------------------------------------------
|
|
.SH DESCRIPTION
|
|
.B dd\-list
|
|
produces nicely formatted lists of Debian (.deb) packages and their
|
|
maintainers.
|
|
.PP
|
|
Input is a list of source or binary package names on the command line
|
|
(or the standard input if
|
|
.B \-\-stdin
|
|
is given).
|
|
Output is a list of the following format, where package names are source
|
|
packages by default:
|
|
.PP
|
|
.nf
|
|
.RS
|
|
J. Random Developer <jrandom@debian.org>
|
|
.RS
|
|
j-random-package
|
|
j-random-other
|
|
.RE
|
|
.PP
|
|
Diana Hacker <diana@example.org>
|
|
.RS
|
|
fun-package
|
|
more-fun-package
|
|
.RE
|
|
.RE
|
|
.fi
|
|
.PP
|
|
This is useful when you want, for example, to produce a list of packages
|
|
that need to attention from their maintainers, e.g., to be rebuilt when
|
|
a library version transition happens.
|
|
.\" --------------------------------------------------------------------
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-h ", " \-\-help
|
|
Print brief help message.
|
|
.TP
|
|
.BR \-i ", " \-\-stdin
|
|
Read package names from the standard input, instead of taking them
|
|
from the command line. Package names are whitespace delimited.
|
|
.TP
|
|
.BR \-d ", " \-\-dctrl
|
|
Read package list from standard input in the format of a Debian
|
|
package control file. This includes the status file, or output of
|
|
apt-cache. This is the fastest way to use dd-list, as it uses the
|
|
maintainer information from the input instead of looking up the maintainer
|
|
of each listed package.
|
|
.IP
|
|
If no \fISource:\fP line is given, the \fIPackage:\fP name is used for
|
|
output, which might be a binary package name.
|
|
.TP
|
|
.BR \-z ", " \-\-uncompress
|
|
Try to uncompress the \-\-dctrl input before parsing. Supported compression
|
|
formats are gz, bzip2 or xz.
|
|
.TP
|
|
\fB\-s\fR, \fB\-\-sources\fR \fISources_file\fR
|
|
Read package information from the specified \fISources_file\fRs. This can be
|
|
given multiple times. The files can be gz, bzip2 or xz compressed. If the
|
|
filename does not end in \fI.gz\fR, \fI.bz2\fR or \fI.xz\fR, then the \fB-z\fR
|
|
option must be used.
|
|
.IP
|
|
If no \fISources_file\fRs are specified, dd\-list will ask apt\-get for
|
|
an appropriate set of sources (if \fIapt\fR is at version greater than 1.1.8),
|
|
else any files matching \fI/var/lib/apt/lists/*_source_Sources\fR will be used.
|
|
.TP
|
|
.BR \-u ", " \-\-uploaders
|
|
Also list developers who are named as uploaders of packages, not only
|
|
the maintainers; this is the default behaviour, use \-\-nouploaders to
|
|
prevent it. Uploaders are indicated with "(U)" appended to the package name.
|
|
.TP
|
|
.BR \-nou ", " \-\-nouploaders
|
|
Only list package Maintainers, do not list Uploaders.
|
|
.TP
|
|
.BR \-b ", " \-\-print\-binary
|
|
Use binary package names in the output instead of source package names
|
|
(has no effect with \fB--dctrl\fP if the \fIPackage:\fP line contains
|
|
source package names).
|
|
.TP
|
|
.BR \-V ", " \-\-version
|
|
Print the version.
|
|
.\" --------------------------------------------------------------------
|
|
.SH AUTHOR
|
|
Lars Wirzenius <liw@iki.fi>
|
|
.P
|
|
Joey Hess <joeyh@debian.org>
|