CONTENTS

ii

3.4.2

The extended description

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.5

Dependencies

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.6

Virtual packages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

3.7

Base system

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

3.8

Essential packages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

3.9

Tasks

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

3.10 Maintainer Scripts

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

3.10.1 Prompting in maintainer scripts

. . . . . . . . . . . . . . . . . . . . . . . . 16

4 Source packages

19

4.1

Standards conformance

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.2

Package relationships

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.3

Changes to the upstream sources

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4.4

Debian changelog:

debian/changelog

. . . . . . . . . . . . . . . . . . . . . . . 21

4.4.1

Alternative changelog formats

. . . . . . . . . . . . . . . . . . . . . . . . . 22

4.5

Error trapping in makefiles

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

4.6

Time Stamps

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

4.7

Restrictions on objects in source packages

. . . . . . . . . . . . . . . . . . . . . . . 23

4.8

Main building script:

debian/rules

. . . . . . . . . . . . . . . . . . . . . . . . . 23

4.9

Variable substitutions:

debian/substvars

. . . . . . . . . . . . . . . . . . . . . 26

4.10 Generated files list:

debian/files

. . . . . . . . . . . . . . . . . . . . . . . . . . 26

5 Control files and their fields

27

5.1

Syntax of control files

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

5.2

Source package control files  

debian/control

. . . . . . . . . . . . . . . . . . . 28

5.3

Binary package control files  

DEBIAN/control

. . . . . . . . . . . . . . . . . . . 28

5.4

Debian source control files  

.dsc

. . . . . . . . . . . . . . . . . . . . . . . . . . . 29

5.5

Debian changes files  

.changes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

5.6

List of fields

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

5.6.1

Source

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

5.6.2

Maintainer

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

5.6.3

Uploaders

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30