.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "CUSTOMDEB 1"
.TH CUSTOMDEB 1 "2008-01-27" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
customdeb \- Customizes a binary debian package
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBcustomdeb\fR \fIfile.cdeb\fR [\fIpackage.deb\fR]
.PP
Applies the changed specified in the file \fIfile.cdeb\fR to the package file specified on the command line. If no package file was passed, it downloads the latest package with dget.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
.Sh "\s-1DIRECTORIES\s0"
.IX Subsection "DIRECTORIES"
The created package will be saved in the \fIoutput/\fR subdirectory of
the current directory. A \fIdlcache/\fR directory will be created as
well, to prevent repeated downloads of the same file. It can,
however, be deleted without problems.
.Sh "\s-1FILE\s0 \s-1FORMAT\s0"
.IX Subsection "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 (\f(CW\*(C`:\*(C'\fR). Lines starting with a blank are just appended
to their previous line's value. Lines that contain only a period (\f(CW\*(C`.\*(C'\fR) 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.
.PP
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.
.Sh "\s-1HEADER\s0 \s-1FIELDS\s0"
.IX Subsection "HEADER FIELDS"
.IP "Package" 4
.IX Item "Package"
The name of the package to modify. \fI(required)\fR
.IP "Mod-Version" 4
.IX Item "Mod-Version"
String to append to the version of the package.
.Sp
Default: 0
.IP "Changes" 4
.IX Item "Changes"
String to be inserted into the Debian changelog of the
created package.
.Sp
Default: \*(L"This is a customized package, created using customdeb.\*(R"
.Sp
\&\fB\s-1TODO:\s0\fR Multi line arguments are not handled nicely yet.
.IP "Files:" 4
.IX Item "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.
.Sp
Default: None
.Sh "\s-1FILE\s0 \s-1STANZA\s0 \s-1FIELDS\s0"
.IX Subsection "FILE STANZA FIELDS"
This describes changes to a file in the package.
.IP "File" 4
.IX Item "File"
The full path of the file to modify or add. \fI(required)\fR
.IP "Content" 4
.IX Item "Content"
Write the (probably\-multi\-line) value of the field to the file.
.IP "Permission" 4
.IX Item "Permission"
The file permission to set, in octal format.
.IP "Owner" 4
.IX Item "Owner"
The user and group to set, separated by a space.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
You can find example files for \fBcustomdeb\fR in \fI/usr/share/doc/customdeb/examples/\fR.
.SH "AUTHOR"
.IX Header "AUTHOR"
Joachim Breitner <nomeata@debian.org>