customdeb

Langue: en

Version: 2008-01-27 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

customdeb - Customizes a binary debian package

SYNOPSIS

customdeb file.cdeb [package.deb]

Applies the changed specified in the file file.cdeb to the package file specified on the command line. If no package file was passed, it downloads the latest package with dget.

DESCRIPTION


DIRECTORIES

The created package will be saved in the output/ subdirectory of the current directory. A dlcache/ directory will be created as well, to prevent repeated downloads of the same file. It can, however, be deleted without problems.

FILE FORMAT

The cdeb file should be in a RFC822-like format, commonly used in Debian for almost everything: Field names and values are separated by a colon (":"). Lines starting with a blank are just appended to their previous line's value. Lines that contain only a period (".") in them will become an empty line in the output. Empty lines are ignored. Comments are allowed - All characters after a # sign until the end of the line are ignored. If you need to include the # sign, prepend it with another #. Also see Parse::DebControl.

The first stanza of the file specifies general information on the package and the changes. This is followed by any number of change stanzas, described as below. The changes are applied in the order of their appearance in the cdeb file.

HEADER FIELDS

Package
The name of the package to modify. (required)
Mod-Version
String to append to the version of the package.

Default: 0

Changes
String to be inserted into the Debian changelog of the created package.

Default: ``This is a customized package, created using customdeb.''

TODO: Multi line arguments are not handled nicely yet.

Files:
String that specifies a directory to copy files from into the package (maybe overwriting files there). This happens before any of modification stanzas are executed.

Default: None

FILE STANZA FIELDS

This describes changes to a file in the package.

File
The full path of the file to modify or add. (required)
Content
Write the (probably-multi-line) value of the field to the file.
Permission
The file permission to set, in octal format.
Owner
The user and group to set, separated by a space.

SEE ALSO

You can find example files for customdeb in /usr/share/doc/customdeb/examples/.

AUTHOR

Joachim Breitner <nomeata@debian.org>