.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_BUILDINFO 1p"
.TH DH_BUILDINFO 1p 2024-03-25 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
dh_buildinfo \- register the versions of build\-dependencies used to build a package
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBdh_buildinfo\fR [\fIdebhelper\ options\fR] [\fIgenerate\fR] [\fIcat\fR] [\fIinstall\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
dh_buildinfo is a debhelper program that registers in a file the list
of packages declared as build-time dependencies, as well as
build-essential packages, together with their versions, as installed
in the build machine.
.PP
This will hopefully help to track packages (auto\-)built with package
versions which are known to be buggy, and, more generally, to find out
whether a package needs to be rebuilt because of a significant change
in a package it has a build-time dependency on.
.PP
You will usually just run this in your package's binary rule. If you
need extra control over the operation, you can specify the actions to
be taken. The default actions are \fIgenerate\fR \fIinstall\fR.
.SH OPTIONS
.IX Header "OPTIONS"
.IP \fIgenerate\fR 4
.IX Item "generate"
Generate the list of versions of the build dependencies in use.
.IP \fIcat\fR 4
.IX Item "cat"
Output the list of versions to \fIstdout\fR.
.IP \fIinstall\fR 4
.IX Item "install"
Installs the compressed list of versions to the package's build directory, in
/usr/share/doc/package/buildinfo.gz