debian/source/format
This file contains on a single line the format that should be
used to build the source package (possible formats are described
above). No leading or trailing spaces are allowed.
debian/source/include-binaries
This file contains a list of binary files (one per line) that
should be included in the debian tarball. Leading and trailing
spaces are stripped. Lines starting with '#
' are comments and
are skipped. Empty lines are ignored.
debian/source/options
This file contains a list of long options that should be
automatically prepended to the set of command line options of a
dpkg-source --build
or dpkg-source --print-format
call. Options
like --compression
and --compression-level
are well suited for
this file.
Each option should be put on a separate line. Empty lines and
lines starting with '#
' are ignored. The leading '--
' should be
stripped and short options are not allowed. Optional spaces are
allowed around the '=
' symbol and optional quotes are allowed
around the value. Here's an example of such a file:
# let dpkg-source create a debian.tar.bz2 with maximal
compression
compression = "bzip2"
compression-level = 9
# use debian/patches/debian-changes as automatic patch
single-debian-patch
# ignore changes on config.{sub,guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"
Note: format
options are not accepted in this file, you should
use debian/source/format
instead.
debian/source/local-options
Exactly like debian/source/options
except that the file is not
included in the generated source package. It can be useful to
store a preference tied to the maintainer or to the VCS
repository where the source package is maintained.
debian/source/local-patch-header
and debian/source/patch-header
Free form text that is put on top of the automatic patch
generated in formats '2.0' or '3.0 (quilt)'. local-patch-header
is not included in the generated source package while
patch-header
is.
debian/patches/
vendor.series
debian/patches/series
This file lists all patches that have to be applied (in the given
order) on top of the upstream source package. Leading and
trailing spaces are stripped. The vendor will be the lowercase
name of the current vendor, or debian
if there is no vendor
defined. If the vendor-specific series file does not exist, the
vendor-less series file will be used. Lines starting with '#
'
are comments and are skipped. Empty lines are ignored.
Remaining lines start with a patch filename (relative to the
debian/patches/
directory) up to the first space character or the
end of line. Optional quilt
options can follow up to the end of
line or the first '#
' preceded by one or more spaces (which marks
the start of a comment up to the end of line).