#use wml::debian::ddp title="Debian Developers' Manuals"
#include "$(ENGLISHDIR)/doc/manuals.defs"
#include "$(ENGLISHDIR)/doc/devel-manuals.defs"

<document "Debian Policy Manual" "policy">

<div class="centerblock">
<p>
  This manual describes the policy requirements for the Debian GNU/Linux
  distribution. This includes the structure and contents of the Debian
  archive, several design issues of the operating system, as well as
  technical requirements that each package must satisfy to be included
  in the distribution.

<doctable>
  <authors "Ian Jackson, Christian Schwarz, David A. Morris">
  <maintainer "The Debian Policy group">
  <status>
  ready
  </status>
  <availability>
  <inpackage "debian-policy">
  <inddpvcs-debian-policy>
  <p><a href="https://bugs.debian.org/debian-policy">Proposed amendments</a> to Policy

  <p>Supplemental Policy documentation:</p>
  <ul>
    <li><a href="packaging-manuals/fhs/fhs-3.0.html">Filesystem Hierarchy Standard</a>
    [<a href="packaging-manuals/fhs/fhs-3.0.pdf">PDF</a>]
    [<a href="packaging-manuals/fhs/fhs-3.0.txt">plain text</a>]
    <li><a href="debian-policy/upgrading-checklist.html">Upgrading checklist</a>
    <li><a href="packaging-manuals/virtual-package-names-list.yaml">Virtual package names list</a>
    <li><a href="packaging-manuals/menu-policy/">Menu policy</a>
    [<a href="packaging-manuals/menu-policy/menu-policy.txt.gz">plain text</a>]
    <li><a href="packaging-manuals/perl-policy/">Perl policy</a>
    [<a href="packaging-manuals/perl-policy/perl-policy.txt.gz">plain text</a>]
    <li><a href="packaging-manuals/debconf_specification.html">debconf specification</a>
    <li><a href="packaging-manuals/debian-emacs-policy">Emacsen policy</a>
    <li><a href="packaging-manuals/java-policy/">Java policy</a>
    <li><a href="packaging-manuals/python-policy/">Python policy</a>
    <li><a href="packaging-manuals/copyright-format/1.0/">copyright-format specification</a>
  </ul>
  </availability>
</doctable>
</div>

<hr>

<document "Debian Developer's Reference" "devref">

<div class="centerblock">
<p>
  This manual describes procedures and resources for Debian maintainers.
  It describes how to become a new developer, the upload procedure, how
  to handle our bug tracking system, the mailing lists, Internet
  servers, etc.

  <p>This manual is thought as a <em>reference manual</em> for all Debian
  developers (newbies and old pros).

<doctable>
  <authors "Ian Jackson, Christian Schwarz, Lucas Nussbaum, Rapha&euml;l Hertzog, Adam Di Carlo, Andreas Barth">
  <maintainer "Lucas Nussbaum, Hideki Yamane, Holger Levsen">
  <status>
  ready
  </status>
  <availability>
  <inpackage "developers-reference">
  <inddpvcs-developers-reference>
  </availability>
</doctable>
</div>

<hr>

<document "Guide for Debian Maintainers" "debmake-doc">

<div class="centerblock">
<p>
This tutorial document describes the building of the Debian package to ordinary
Debian users and prospective developers using the <code>debmake</code> command.
</p>
<p>
It is focused on the modern packaging style and comes with many simple examples.
</p>
<ul>
<li>POSIX shell script packaging</li>
<li>Python3 script packaging</li>
<li>C with Makefile/Autotools/CMake</li>
<li>multiple binary packages with shared library etc.</li>
</ul>
<p>
This “Guide for Debian Maintainers” can be considered as the successor to the
“Debian New Maintainers’ Guide”.
</p>

<doctable>
  <authors "Osamu Aoki">
  <maintainer "Osamu Aoki">
  <status>
  ready
  </status>
  <availability>
  <inpackage "debmake-doc">
  <inddpvcs-debmake-doc>
  </availability>
</doctable>
</div>

<hr>

<document "Debian New Maintainers' Guide" "maint-guide">

<div class="centerblock">
<p>
  This document will try to describe building of a Debian GNU/Linux package
  to the common Debian user (and wannabe developer) in common language, and
  well covered with working examples.

  <p>Unlike previous attempts, this one is based on <code>debhelper</code>
  and the new tools available to maintainers.  The author is making every
  attempt to incorporate and unify previous efforts.

<doctable>
  <authors "Josip Rodin, Osamu Aoki">
  <maintainer "Osamu Aoki">
  <status>
  outdated, use above “Guide for Debian Maintainers” (debmake-doc)
  </status>
  <availability>
  <inpackage "maint-guide">
  <inddpvcs-maint-guide>
  </availability>
</doctable>
</div>

<hr>

<document "Introduction to Debian packaging" "packaging-tutorial">

<div class="centerblock">
<p>
This tutorial is an introduction to Debian packaging.
It teaches prospective
developers how to modify existing packages, how to create their own packages,
and how to interact with the Debian community.
In addition to the main
tutorial, it includes three practical sessions on modifying the <code>grep</code>
package, and packaging the <code>gnujump</code> game and a Java library.
</p>

<doctable>
  <authors "Lucas Nussbaum">
  <maintainer "Lucas Nussbaum">
  <status>
  ready
  </status>
  <availability>
  <inpackage "packaging-tutorial">
  <inddpvcs-packaging-tutorial>
  </availability>
</doctable>
</div>

<hr>

<document "Debian Menu System" "menu">

<div class="centerblock">
<p>
  This manual describes the Debian Menu System and the <strong>menu</strong>
  package.

  <p>The menu package was inspired by the install-fvwm2-menu program from
  the old fvwm2 package. However, menu tries to provide a more general
  interface for menu building. With the update-menus command from this
  package, no package needs to be modified for every X window manager again,
  and it provides a unified interface for both text- and X-oriented
  programs.

<doctable>
  <authors "Joost Witteveen, Joey Hess, Christian Schwarz">
  <maintainer "Joost Witteveen">
  <status>
  ready
  </status>
  <availability>
  <inpackage "menu">
  <a href="packaging-manuals/menu.html/">HTML online</a>
  </availability>
</doctable>
</div>

<hr>

<document "Debian Installer internals" "d-i-internals">

<div class="centerblock">
<p>
  This document is intended to make Debian Installer more accessible to new
  developers and as a central location to document technical information.

<doctable>
  <authors "Frans Pop">
  <maintainer "Debian Installer team">
  <status>
  ready
  </status>
  <availability>
  <p><a href="https://d-i.debian.org/doc/internals/">HTML online</a></p>
  <p><a href="https://salsa.debian.org/installer-team/debian-installer/tree/master/doc/devel/internals">DocBook XML source online</a></p>
  </availability>
</doctable>
</div>

<hr>

<document "dbconfig-common documentation" "dbconfig-common">

<div class="centerblock">
<p>
  This document is intended for package maintainers who maintain packages that
  require a working database. Instead of implementing the required logic
  themselves they can rely on dbconfig-common to ask the right questions during
  install, upgrade, reconfigure and deinstall for them and create and fill the
  database.

<doctable>
  <authors "Sean Finney and Paul Gevers">
  <maintainer "Paul Gevers">
  <status>
  ready
  </status>
  <availability>
  <inpackage "dbconfig-common">
  <inddpvcs-dbconfig-common>
  Additional also the <a href="/doc/manuals/dbconfig-common/dbconfig-common-design.html">design document</a> is available.
  </availability>
</doctable>
</div>

<hr>

<document "dbapp-policy" "dbapp-policy">

<div class="centerblock">
<p>
  A proposed policy for packages that depend on a working database.

<doctable>
  <authors "Sean Finney">
  <maintainer "Paul Gevers">
  <status>
  draft
  </status>
  <availability>
  <inpackage "dbconfig-common">
  <inddpvcs-dbapp-policy>
  </availability>
</doctable>
</div>