Debian Developer's Reference

Developer's Reference Team <developers-reference@packages.debian.org>

• Copyright © 2019 - 2022 Holger Levsen

• Copyright © 2015 - 2020 Hideki Yamane

• Copyright © 2008 - 2015 Lucas Nussbaum

• Copyright © 2004 - 2007 Andreas Barth

• Copyright © 2002 - 2009 Raphaël Hertzog

• Copyright © 1998 - 2003 Adam Di Carlo

• 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-2 in the Debian 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.

This is Debian Developer's Reference version 12.6, released on 2022-08-06.

If you want to print this reference, you should use the pdf version. This manual is also available in some other languages.

• 1. Границы данного документа
• 2. Applying to Become a Member
  • 2.1. Приступаем к работе
  • 2.2. Наставники и поручители Debian
  • 2.3. Registering as a Debian member
• 3. Обязанности разработчика Debian
  • 3.1. Обязанности сопровождающего пакетов
    • 3.1.1. Работа по подготовке следующего стабильного выпуска
    • 3.1.2. Сопровождение пакетов в стабильном выпуске
    • 3.1.3. Работа с критичными для выпуска ошибками
    • 3.1.4. Координация с разработчиками основной ветки
  • 3.2. Административные обязанности
    • 3.2.1. Сопровождение вашей связанной с Debian информации
    • 3.2.2. Сопровождение вашего открытого ключа
    • 3.2.3. Голосование
    • 3.2.4. Вежливый уход в отпуск
    • 3.2.5. Уход в отставку
    • 3.2.6. Возвращение после ухода
• 4. Resources for Debian Members
  • 4.1. Списки рассылки
    • 4.1.1. Базовые правила
    • 4.1.2. Базовые списки рассылки
    • 4.1.3. Специальные списки рассылки
    • 4.1.4. Запрос новых списков рассылки, связанных с разработкой
  • 4.2. Каналы IRC
  • 4.3. Документация
  • 4.4. Машины Debian
    • 4.4.1. Сервер bugs
    • 4.4.2. Сервер ftp-master
    • 4.4.3. Сервер www-master
    • 4.4.4. Веб-сервер people
    • 4.4.5. salsa.debian.org: Git repositories and collaborative development platform
    • 4.4.6. GitHub.com: Submitting pull requests to upstream repositories
    • 4.4.7. chroot для различных выпусков
  • 4.5. База данных разработчиков
  • 4.6. Архив Debian
    • 4.6.1. Разделы
    • 4.6.2. Архитектуры
    • 4.6.3. Пакеты
    • 4.6.4. Выпуски
      • 4.6.4.1. Стабильный, тестируемые и нестабильный выпуски
      • 4.6.4.2. Дополнительная информация о тестируемом выпуске
      • 4.6.4.3. Экспериментальный выпуск
    • 4.6.5. Кодовые имена выпусков
  • 4.7. Зеркала Debian
  • 4.8. Система входящих пакетов
  • 4.9. Информация о пакете
    • 4.9.1. В веб
    • 4.9.2. Утилита dak ls
  • 4.10. Система отслеживания пакетов Debian
  • 4.11. Обзор пакетов разработчика
  • 4.12. Установка Debian FusionForge: Alioth
  • 4.13. Goodies for Debian Members
• 5. Управление пакетами
  • 5.1. Новые пакеты
  • 5.2. Запись изменений в пакете
  • 5.3. Тестирование пакета
  • 5.4. Схема пакета с исходным кодом
  • 5.5. Выбор выпуска
    • 5.5.1. Специальный случай: загрузка в стабильный и предыдущий стабильный выпуски
    • 5.5.2. Special case: the stable-updates suite
    • 5.5.3. Специальный случай: загрузка в testing/testing-proposed-updates
  • 5.6. Загрузка пакета
    • 5.6.1. Загрузка на ftp-master
    • 5.6.2. Задержанные загрузки
    • 5.6.3. Загрузки безопасности
    • 5.6.4. Другие очереди загрузки
    • 5.6.5. Notifications
  • 5.7. Определение раздела для пакета, подраздела и приоритета
  • 5.8. Работа с ошибками
    • 5.8.1. Мониторинг ошибок
    • 5.8.2. Ответ на ошибки
    • 5.8.3. Bug housekeeping
    • 5.8.4. Когда ошибки исправляются путём новых загрузок
    • 5.8.5. Работа с ошибками, связанными с безопасностью
      • 5.8.5.1. Debian Security Tracker
      • 5.8.5.2. Конфиденциальность
      • 5.8.5.3. Рекомендации по безопасности
      • 5.8.5.4. Подготовка пакетов для решения проблем безопасности
      • 5.8.5.5. Загрузка исправленного пакета
  • 5.9. Перемещение, удаление, переименование, придание статуса осиротевшего, усыновление и повторное введение пакетов
    • 5.9.1. Перемещение пакетов
    • 5.9.2. Удаление пакетов
      • 5.9.2.1. Удаление пакетов из каталога Incoming (каталога входящих пакетов)
    • 5.9.3. Замена или переименование пакетов
    • 5.9.4. Придание статуса осиротевшего пакета
    • 5.9.5. Усыновление пакета
    • 5.9.6. Повторное добавление пакетов
  • 5.10. Работа на переносом и перенос пакетов
    • 5.10.1. Будьте добры к тем, кто занимается переносом
    • 5.10.2. Руководство для загрузок теми, кто занимается переносом
      • 5.10.2.1. Повторная компиляция или только двоичные NMU
      • 5.10.2.2. Когда следует делать NMU, если вы занимаетесь переносом
    • 5.10.3. Инфраструктура переноса и автоматизация
      • 5.10.3.1. Списки рассылки и веб-страницы
      • 5.10.3.2. Инструменты переноса
      • 5.10.3.3. wanna-build
    • 5.10.4. Если ваш пакет не может быть перенесён
    • 5.10.5. Отмечаем несвободные пакеты как собираемые автоматически (auto-buildable)
  • 5.11. Загрузки не-сопровождающим (NMU)
    • 5.11.1. Когда и как делать NMU
    • 5.11.2. NMU и файл debian/changelog
    • 5.11.3. Использование очереди DELAYED/
    • 5.11.4. NMU с точки зрения сопровождающего
    • 5.11.5. NMU исходного кода и двоичные NMU (binNMU)
    • 5.11.6. NMU и загрузки командой контроля качества
    • 5.11.7. NMU и командные загрузки
  • 5.12. Package Salvaging
    • 5.12.1. When a package is eligible for package salvaging
    • 5.12.2. How to salvage a package
  • 5.13. Совместное сопровождение
  • 5.14. Тестируемый выпуск
    • 5.14.1. Основы
    • 5.14.2. Обновления из нестабильного выпуска
      • 5.14.2.1. Устаревание
      • 5.14.2.2. Удаление из тестируемого выпуска
      • 5.14.2.3. Круговые зависимости
      • 5.14.2.4. Влияние пакета в тестируемом выпуске
      • 5.14.2.5. Подробности
    • 5.14.3. Прямые обновления тестируемого выпуска
    • 5.14.4. Часто задаваемые вопросы
      • 5.14.4.1. Что такое критичные для выпуска ошибки, как производится их подсчёт?
      • 5.14.4.2. Как установка какого-то пакета в тестируемый выпуск может сломать другие пакеты?
  • 5.15. The Stable backports archive
    • 5.15.1. Основы
    • 5.15.2. Exception to the testing-first rule
    • 5.15.3. Who can maintain packages in the stable-backports archive?
    • 5.15.4. When can one start uploading to stable-backports?
    • 5.15.5. How long must a package be maintained when uploaded to stable-backports?
    • 5.15.6. How often shall one upload to stable-backports?
    • 5.15.7. How can one learn more about backporting?
• 6. Лучшие практики создания пакетов
  • 6.1. Лучшие практики для debian/rules
    • 6.1.1. Сценарии-помощники
    • 6.1.2. Отделение ваших заплат в несколько файлов
    • 6.1.3. Множественные двоичные пакеты
  • 6.2. Лучшие практики для debian/control
    • 6.2.1. Общие принципы описания пакетов
    • 6.2.2. Резюме пакета или короткое описание
    • 6.2.3. Длинное описание
    • 6.2.4. Домашняя страница основной ветки разработки
    • 6.2.5. Размещение системы контроля версий
      • 6.2.5.1. Vcs-Browser
      • 6.2.5.2. Vcs-*
  • 6.3. Лучшие практики для debian/changelog
    • 6.3.1. Написание полезных пунктов файла изменений
    • 6.3.2. Selecting the upload urgency
    • 6.3.3. Распространённые неправильные представления о записях об изменениях
    • 6.3.4. Общие ошибки в записях об изменениях
    • 6.3.5. Дополнение журналов файлами NEWS.Debian
  • 6.4. Best practices around security
  • 6.5. Лучшие практики для сценариев сопровождающих
  • 6.6. Управление настройкой с помощью debconf
    • 6.6.1. Не злоупотребляйте debconf
    • 6.6.2. Общие рекомендации для авторов и переводчиков
      • 6.6.2.1. Пишите на правильном английском
      • 6.6.2.2. Будьте добры к переводчикам
      • 6.6.2.3. Отменяйте статус неясных строк когда исправляете опечатки или орфографию
      • 6.6.2.4. Не допускайте ничего по поводу интерфейсов
      • 6.6.2.5. Не используйте первое лицо
      • 6.6.2.6. Будьте нейтральны в гендерном отношении
    • 6.6.3. Определение полей шаблонов
      • 6.6.3.1. Тип
      • 6.6.3.2. Описание: краткое и расширенное описания
      • 6.6.3.3. Choices
      • 6.6.3.4. Default
    • 6.6.4. Template fields specific style guide
      • 6.6.4.1. Тип поля
      • 6.6.4.2. Поле Description
      • 6.6.4.3. Поле Choices
      • 6.6.4.4. Поле Default
  • 6.7. Интернационализация
    • 6.7.1. Обработка переводов debconf
    • 6.7.2. Интернационализованная документация
  • 6.8. Общие ситуации при создании пакетов
    • 6.8.1. Пакеты, использующие autoconf/automake
    • 6.8.2. Библиотеки
    • 6.8.3. Документация
    • 6.8.4. Конкретные типы пакетов
    • 6.8.5. Независящие от архитектуры данные
    • 6.8.6. Необходимость в конкретной локали во время сборки
    • 6.8.7. Делаем так, чтобы deborphan определят переходные пакеты
    • 6.8.8. Лучшие практики для файлов .orig.tar.{gz,bz2,xz}
      • 6.8.8.1. Чистый исходный код
      • 6.8.8.2. Повторная упаковка исходного кода основной ветки
      • 6.8.8.3. Изменение двоичных файлов
    • 6.8.9. Лучшие практики для отладочных пакетов
      • 6.8.9.1. Automatically generated debug packages
      • 6.8.9.2. Manual -dbg packages
    • 6.8.10. Лучшие практики для метапакетов
• 7. Помимо создания пакетов
  • 7.1. Отправка отчётов об ошибках
    • 7.1.1. Отправка множества отчётов об ошибках за один раз (массовое заполнение отчётов об ошибках)
      • 7.1.1.1. Пользовательские метки
  • 7.2. Работа по контролю качества
    • 7.2.1. Ежедневная работа
    • 7.2.2. Вечеринки по исправлению ошибок
  • 7.3. Связь с другими сопровождающими
  • 7.4. Работа с неактивными и/или недоступными сопровождающими
  • 7.5. Взаимодействие с будущими разработчиками Debian
    • 7.5.1. Поручение пакетов
      • 7.5.1.1. Поручительство нового пакета
      • 7.5.1.2. Поручение обновления существующего пакета
    • 7.5.2. Granting upload permissions to DMs
    • 7.5.3. Поддержка новых разработчиков
    • 7.5.4. Обработка заявок новых сопровождающих
• 8. Интернационализация и переводы
  • 8.1. Как переводы обрабатываются в Debian
  • 8.2. ЧаВО по I18N и L10N для сопровождающих
    • 8.2.1. Как перевести некоторый данный текст
    • 8.2.2. Как проверить перевод
    • 8.2.3. Как обновить перевод
    • 8.2.4. Как работать с отчётом об ошибке, касающемся перевода
  • 8.3. ЧаВО по I18N и L10N для переводчиков
    • 8.3.1. Как помочь с переводом
    • 8.3.2. Как предоставить перевод для добавления его в пакет
  • 8.4. Лучшие текущие практики, касающиеся локализации

Appendix

• 1. Обзор инструментов Debian для сопровождающего
  • 1.1. Базовые инструменты
    • 1.1.1. dpkg-dev
    • 1.1.2. debconf
    • 1.1.3. fakeroot
  • 1.2. Инструменты для проверки пакетов на предмет ошибок и соответствия стандартам
    • 1.2.1. lintian
    • 1.2.2. lintian-brush
    • 1.2.3. piuparts
    • 1.2.4. debdiff
    • 1.2.5. diffoscope
    • 1.2.6. duck
    • 1.2.7. adequate
    • 1.2.8. i18nspector
    • 1.2.9. cme
    • 1.2.10. licensecheck
    • 1.2.11. blhc
  • 1.3. Помощники для debian/rules
    • 1.3.1. debhelper
    • 1.3.2. dh-make
    • 1.3.3. equivs
  • 1.4. Сборщики пакетов
    • 1.4.1. git-buildpackage
    • 1.4.2. debootstrap
    • 1.4.3. pbuilder
    • 1.4.4. sbuild
  • 1.5. ПО для загрузки пакетов
    • 1.5.1. dupload
    • 1.5.2. dput
    • 1.5.3. dcut
  • 1.6. Автоматизация сопровождения пакетов
    • 1.6.1. devscripts
    • 1.6.2. reportbug
    • 1.6.3. autotools-dev
    • 1.6.4. dpkg-repack
    • 1.6.5. alien
    • 1.6.6. dpkg-dev-el
    • 1.6.7. dpkg-depcheck
  • 1.7. Инструменты для переноса
    • 1.7.1. dpkg-cross
  • 1.8. Документация и информацию
    • 1.8.1. debian-policy
    • 1.8.2. doc-debian
    • 1.8.3. developers-reference
    • 1.8.4. maint-guide
    • 1.8.5. packaging-tutorial
    • 1.8.6. how-can-i-help
    • 1.8.7. docbook-xml
    • 1.8.8. debiandoc-sgml
    • 1.8.9. debian-keyring
    • 1.8.10. debian-el