Download Debian New Maintainers` Guide

Transcript
1 / 58
Debian New Maintainers’ Guide
Chapter 1
Getting started The Right Way
This document tries to describe the building of a Debian package to ordinary Debian users and prospective developers. It uses
fairly non-technical language, and it’s well covered with working examples. There is an old Latin saying: Longum iter est per
praecepta, breve et efficax per exempla (It’s a long way by the rules, but short and efficient with examples).
This document has been updated for the Debian jessie release.
1
One of the things that makes Debian such a top-notch distribution is its package system. While there is a vast quantity of software
already in the Debian format, sometimes you need to install software that isn’t. You may be wondering how you can make your
own packages; and perhaps you think it is a very difficult task. Well, if you are a real novice on Linux, it is hard, but if you were
a rookie, you wouldn’t be reading this document now :-) You do need to know a little about Unix programming but you certainly
don’t need to be a wizard. 2
One thing is certain, though: to properly create and maintain Debian packages takes many hours. Make no mistake, for our
system to work the maintainers need to be both technically competent and diligent.
If you need some help on packaging, please read Section 1.4.
Newer versions of this document should always be available online at http://www.debian.org/doc/maint-guide/ and in the maintguide package. The translations may be available in packages such as maint-guide-es. Please note that this documentation
may be slightly outdated.
Since this is a tutorial, I choose to explain each detailed step for some important topics. Some of them may look irrelevant to you.
Please be patient. I have also intentionally skipped some corner cases and provided only pointers to keep this document simple.
1.1
Social dynamics of Debian
Here are some observations of Debian’s social dynamics, presented in the hope that it will prepare you for interactions with
Debian:
• We all are volunteers.
– You cannot impose on others what to do.
– You should be motivated to do things by yourself.
• Friendly cooperation is the driving force.
– Your contribution should not overstrain others.
1 The document assumes you are using a jessie or newer system. If you need to follow this text in an older system (including an older Ubuntu system
etc.), you must install backported dpkg and debhelper packages, at least.
2 You can learn about the basic handling of a Debian system from the Debian Reference (http://www.debian.org/doc/manuals/debian-reference/) . It contains
some pointers to learn about Unix programming, too.