CUSTOMDEB(1)						User Contributed Perl Documentation					      CUSTOMDEB(1)

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 stan-
       zas, 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 modi-
	   fication 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>

perl v5.8.8							    2008-01-27							      CUSTOMDEB(1)