Debian Developer's Reference
Total Page:16
File Type:pdf, Size:1020Kb
Debian Developer’s Reference Developer’s Reference Team, Andreas Barth, Adam Di Carlo, Raphaël Hertzog, Christian Schwarz, and Ian Jackson August 22, 2009 Debian Developer’s Reference by Developer’s Reference Team, Andreas Barth, Adam Di Carlo, Raphaël Hertzog, Christian Schwarz, and Ian Jackson Published unknown Copyright © 2004, 2005, 2006, 2007 Andreas Barth Copyright © 1998, 1999, 2000, 2001, 2002, 2003 Adam Di Carlo Copyright © 2002, 2003 Raphaël Hertzog Copyright © 1997, 1998 Christian Schwarz This manual is free software; you may redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. This is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for more details. A copy of the GNU General Public License is available as /usr/share/common-licenses/GPL in the Debian GNU/Linux distribution or on the World Wide Web at the GNU web site. You can also obtain it by writing to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. If you want to print this reference, you should use the pdf version. This page is also available in French. ii Contents 1 Scope of This Document1 2 Applying to Become a Maintainer3 2.1 Getting started . .3 2.2 Debian mentors and sponsors . .3 2.3 Registering as a Debian developer . .4 3 Debian Developer’s Duties7 3.1 Maintaining your Debian information . .7 3.2 Maintaining your public key . .7 3.3 Voting . .7 3.4 Going on vacation gracefully . .8 3.5 Coordination with upstream developers . .8 3.6 Managing release-critical bugs . .8 3.7 Retiring . .9 4 Resources for Debian Developers 11 4.1 Mailing lists . 11 4.1.1 Basic rules for use . 11 4.1.2 Core development mailing lists . 11 4.1.3 Special lists . 12 4.1.4 Requesting new development-related lists . 12 4.2 IRC channels . 12 4.3 Documentation . 12 4.4 Debian machines . 13 4.4.1 The bugs server . 13 4.4.2 The ftp-master server . 13 4.4.3 The www-master server . 13 4.4.4 The people web server . 13 4.4.5 The VCS servers . 14 4.4.6 chroots to different distributions . 14 4.5 The Developers Database . 14 4.6 The Debian archive . 15 4.6.1 Sections . 16 4.6.2 Architectures . 16 4.6.3 Packages . 17 4.6.4 Distributions . 17 4.6.4.1 Stable, testing, and unstable . 17 4.6.4.2 More information about the testing distribution . 18 4.6.4.3 Experimental . 18 4.6.5 Release code names . 18 4.7 Debian mirrors . 19 4.8 The Incoming system . 19 4.9 Package information . 20 4.9.1 On the web . 20 4.9.2 The dak ls utility . 20 4.10 The Package Tracking System . 20 4.10.1 The PTS email interface . 21 4.10.2 Filtering PTS mails . 22 4.10.3 Forwarding VCS commits in the PTS . 22 4.10.4 The PTS web interface . 22 4.11 Developer’s packages overview . 23 4.12 Debian’s GForge installation: Alioth . 23 4.13 Goodies for Developers . 24 iii CONTENTS 4.13.1 LWN Subscriptions . 24 4.13.2 Gandi.net Hosting Discount . 24 5 Managing Packages 25 5.1 New packages . 25 5.2 Recording changes in the package . 26 5.3 Testing the package . 26 5.4 Layout of the source package . 26 5.5 Picking a distribution . 27 5.5.1 Special case: uploads to the stable and oldstable distributions . 27 5.5.2 Special case: uploads to testing/testing-proposed-updates ........ 28 5.6 Uploading a package . 28 5.6.1 Uploading to ftp-master ................................ 28 5.6.2 Delayed uploads . 28 5.6.3 Security uploads . 28 5.6.4 Other upload queues . 28 5.6.5 Notification that a new package has been installed . 28 5.7 Specifying the package section, subsection and priority . 29 5.8 Handling bugs . 29 5.8.1 Monitoring bugs . 29 5.8.2 Responding to bugs . 30 5.8.3 Bug housekeeping . 30 5.8.4 When bugs are closed by new uploads . 31 5.8.5 Handling security-related bugs . 32 5.8.5.1 The Security Tracker . 32 5.8.5.2 Confidentiality . 32 5.8.5.3 Security Advisories . 33 5.8.5.4 Preparing packages to address security issues . 33 5.8.5.5 Uploading the fixed package . 34 5.9 Moving, removing, renaming, adopting, and orphaning packages . 35 5.9.1 Moving packages . 35 5.9.2 Removing packages . 35 5.9.2.1 Removing packages from Incoming ..................... 36 5.9.3 Replacing or renaming packages . 36 5.9.4 Orphaning a package . 36 5.9.5 Adopting a package . 37 5.10 Porting and being ported . 37 5.10.1 Being kind to porters . 37 5.10.2 Guidelines for porter uploads . 38 5.10.2.1 Recompilation or binary-only NMU . 38 5.10.2.2 When to do a source NMU if you are a porter . 39 5.10.3 Porting infrastructure and automation . 39 5.10.3.1 Mailing lists and.