序文

If you are a somewhat experienced Debian user ^[1], you may have encountered following situations:

You wish to install a certain software package not yet found in the Debian archive.
You wish to update a Debian package with the newer upstream release.
You wish to fix bugs of a Debian package with some patches.

If you wanted to create a Debian package to fulfill these wishes and to share your work with the community, you are the target audience of this guide as a prospective Debian maintainer. ^[2] Welcome to the Debian community.

Debian has many social and technical rules and conventions to follow since it is a large volunteer organization with history. Debian also has developed a huge array of packaging tools and archive maintenance tools to build consistent sets of binary packages addressing many technical objectives:

packages build across many architectures (Section 5.6.4, “Variables for debian/rules”)
reproducible build (Section 5.6.5, “Reproducible build”)
clean build under clearly specified package dependencies and patches (Section 5.7, “debian/control”, Section 5.10, “debian/patches/*”, Section 7.10, “chroot”)
optimal splits into multiple binary packages (Section 5.7.1, “Split of a Debian binary package”)
smooth library transitions (Section 5.20.2, “Library transition”)
interactive installation customization (Section 5.21, “debconf”)
multiarch support (Section 5.22, “マルチアーチ”)
security enhancement using specific compiler flags (Section 5.23, “Compiler hardening”)
continuous integration (Section 5.24, “Continuous integration”)
boot strapping (Section 5.26, “Bootstrapping”)
…

These make it somewhat overwhelming for many new prospective Debian maintainers to get involved with Debian. This guide tries to provide entry points for them to get started. It describes the following:

What you should know before getting involved with Debian as a prospective maintainer.
What it looks like to make a simple Debian package.
What kind of rules exist for making the Debian package.
Tips for making the Debian package.
Examples of making Debian packages for several typical scenarios.

The author felt limitations of updating the original “New Maintainers' Guide” with the dh-make package and decided to create an alternative tool and its matching document to address modern requirements. The result is the debmake (version: 4.4.0) package and this updated “Guide for Debian Maintainers” in the debmake-doc (version: 1.17-9) package.

Many chores and tips have been integrated into the debmake command making this guide simple. This guide also offers many packaging examples.

	Caution
	It takes many hours to properly create and maintain Debian packages. The Debian maintainer must be both technically competent and diligent to take up this challenge.

Some important topics are explained in detail. Some of them may look irrelevant to you. Please be patient. Some corner cases are skipped. Some topics are only covered by the external pointers. These are intentional choices to keep this guide simple and maintainable.

^[1]You do need to know a little about Unix programming but you certainly don’t need to be a wizard. You can learn about the basic handling of a Debian system from the Debian Reference. It contains some pointers to learn about Unix programming, too.

^[2]If you are not interested in sharing the Debian package, you can certainly work around your local situation by compiling and installing the fixed upstream source package into /usr/local/.


Debian メンテナー用ガイド		Chapter 1. Overview