Chapter C. Source packages (from old Packaging Manual)

114

C.1.5

dpkg distaddfile

  adds a file to

debian/files

Some packages' uploads need to include files other than the source and binary package files.

dpkg distaddfile

adds a file to the

debian/files

file so that it will be included in the

.changes

file when

dpkg genchanges

is run.

It is usually invoked from the

binary

target of

debian/rules

:

dpkg distaddfile

filename section priority

The filename is relative to the directory where

dpkg genchanges

will expect to find it   this is

usually the directory above the top level of the source tree. The

debian/rules

target should

put the file there just before or just after calling

dpkg distaddfile

.

The section and priority are passed unchanged into the resulting

.changes

file.

C.1.6

dpkg genchanges

  generates a

.changes

upload control file

This program is usually called by package independent automatic building scripts such as

dpkg buildpackage

, but it may also be called by hand.

It is usually called in the top level of a built source tree, and when invoked with no arguments

will print out a straightforward

.changes

file based on the information in the source pack 

age's changelog and control file and the binary and source packages which should have been

built.

C.1.7

dpkg parsechangelog

  produces parsed representation of a changelog

This program is used internally by

dpkg source

et al. It may also occasionally be useful in

debian/rules

and elsewhere. It parses a changelog,

debian/changelog

by default, and

prints a control file format representation of the information in it to standard output.

C.1.8

dpkg architecture

  information about the build and host system

This program can be used manually, but is also invoked by

dpkg buildpackage

or

debian

/rules

to set to set environment or make variables which specify the build and host architec 

ture for the package building process.

C.2 The Debianised source tree

The source archive scheme described later is intended to allow a Debianised source tree with

some associated control information to be reproduced and transported easily. The Debianised