aboutsummaryrefslogtreecommitdiffstats
path: root/english/doc/devel-manuals.wml
blob: ac0923d903ee86d725e2dbb79c55801b48d70eb9 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
#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>

© 2014-2024 Faster IT GmbH | imprint | privacy policy