1 developers-reference (2.6.9) unstable; urgency=low
3 * first thorough pass through the document; separated out
4 language-independant elements into common.ent
5 * Sec. "Stable, unstable, and sometimes frozen": mention how old stable
6 releases are available at archive.debian.org
7 * doc-base: change section for *constitution* to Debian (not 'debian')
12 developers-reference (2.6.8) unstable; urgency=low
14 * when applying as a new user, the login name can be *eight* characters,
15 not seven (thanks to Rafael Caetano dos Santos)
17 -- Adam Di Carlo <aph@debian.org> Fri, 21 May 1999 21:50:04 -0400
19 developers-reference (2.6.7) unstable; urgency=low
21 * SGML'ish: normalize SGML elements, refill paragraphs (closes Bug#37987)
22 * doc-base: change section to Debian -- hmm, this looks like a doc-base
23 bug, really, but hey, who am I to refile bugs to another one of my own
24 packages? (closes Bug#37392)
25 * Ch. "Overview of Debian Maintainer Tools": new section for yada (um,
26 someone who uses this should check my description), correct build ->
27 debuild in the devscripts section (closes Bug#38053)
29 -- Adam Di Carlo <aph@debian.org> Fri, 21 May 1999 01:41:45 -0400
31 developers-reference (2.6.6) unstable; urgency=low
33 * Sec. "The master server": note that problems on Debian ftp can be sent
34 to ftpmaster@debian.org also
35 * Secs. "Uploads via chiark" and "Uploads via erlangen": remove
36 'cron-driven' (thanks Roman Hodek)
37 * Sec. "Being Kind to Porters": typos corrected, note that binary-arch
38 and binary-indep targets should work independantly (thanks Roman
40 * Sec. "buildd": remove erroneous reference to debbuild, reorganize the
41 section and correct typos (thank again Roman -- boy, this is the all
43 * debian/rules: re-enable letter-sized PDFs
45 -- Adam Di Carlo <aph@debian.org> Sun, 9 May 1999 01:17:29 -0400
47 developers-reference (2.6.5) unstable; urgency=low
49 * Sec. "Architectures": correction on supported architecture in Linux
51 * Sec. "Experimental": other reasons to use or not use the experiment
52 archive "section", from comments by Guy Maor
53 * Sec. "Being Kind to Porters": replace x86 with i386 (closes Bug#36485)
54 * debian/rules: date printing protected from local l10n (closes Bug#36891)
55 * Ch. "Mailing Lists, Servers, and Other Machines": renamed chapter; add
57 * Sec. "Debian Servers": new, for talking about the standard servers,
58 with intro; demoted server sections under that
59 * Sec. "The FTP servers": was empty, removed
60 * Sec. "The master server": fill in more info and cross-refs on how to
62 * Sec. "The CVS server": add some more detail which should be included
63 when requesting cvs areas; mention the cvsweb URL
64 * Sec. "Other Debian Machines": new section, list the machines for which
65 a normal developer may have access.
67 -- Adam Di Carlo <aph@debian.org> Tue, 4 May 1999 03:32:21 -0400
69 developers-reference (2.6.4) unstable; urgency=low
71 * debian/rules: hack 'byhand' file entries to include debian version
72 number in it, so subsequent uploads of the package into Incoming don't
73 step all over each other
75 -- Adam Di Carlo <aph@debian.org> Fri, 9 Apr 1999 20:04:04 -0400
77 developers-reference (2.6.3) unstable; urgency=low
79 * correction from James Troup -- <keyring-maint> is indeed the correct
80 address for PGP key updates
82 -- Adam Di Carlo <aph@debian.org> Sun, 4 Apr 1999 13:28:58 -0400
84 developers-reference (2.6.2) unstable; urgency=low
86 * Sec. "fakeroot": libtricks is not replacing anything after all
87 * developers-reference.sgml: use public declaration
88 * BTW, if any maintainers of translated versions of this document would
89 like to talk to me about folding your version into the
90 developers-reference CVS area, please get in touch with me
92 -- Adam Di Carlo <aph@debian.org> Sun, 4 Apr 1999 04:42:29 -0400
94 developers-reference (2.6.1) unstable; urgency=low
96 * include Debian constitution (closes Bug#30694)
97 * Sec. "fakeroot": libtricks is replacing fakeroot, not libtool
98 * Sec. "Maintaining Your Public Key" -- give email addresses as
99 {pgp,gpg}-update@debian.org, at James Troup's request (note to Jameas,
100 if you see this: /usr/doc/debian-keyring/README.gz talks about
101 <keyring-maint> instead)
102 * Ch. "Overview of Debian Maintainer Tools" -- add Sec. "debget"
103 * developers-reference.sgml: minor typo correction from Tril
105 * doc-base stuff: add abstract to developers-reference, new file for
107 * debian/rules: minor cleanup and consistency; build PDF, not PS file;
108 ship PDF file;.text file now has .txt extension
109 * debian/control: set priority to optional, matching archive
111 -- Adam Di Carlo <aph@debian.org> Sat, 3 Apr 1999 17:17:06 -0500
113 developers-reference (2.6.0) frozen unstable; urgency=low
115 * would be nice to sneak this into slink; it's just documentation!
116 * Ch. "Porting and Being Ported": porter information broken out into it's
117 own chapter, Sec. "Guidelines for Porter Uploads" and "When to do a
118 source NMU if you are a porter" moved to this chapter; porter tool
119 descriptions such as 'quinn-diff' moved to this section. Sec. "Being
120 Kind to Porters" added, with tips for how to avoid making problems for
122 * Ch. "Non-Maintainer Uploads (NMUs)": update for the new chapter, and
123 tighten up the language a bit
124 * Sec. "Monitoring bugs": add a little cron job to get an 'index maint'
125 of outstanding bugs (closes Bug#31259), loosen language a tiny bit
126 w.r.t. non-maintainers or submitters closing bugs (closes Bug#30394)
127 * Sec. "Scope of This Document": point out that this file is not
129 * Ch. "Handling Bugs": renamed from "Handling Bug Reports", incorporate
130 some suggestions from James Troup, namely, don't mail from your root
131 account, don't close bugs via control@bugs.debian.org; break out new
132 sections, "Submitting Bugs" and "Responding to Bugs"
133 * Ch. "Overview of Debian Maintainer Tools": remove attribution for
134 package maintainers, since I can't keep up; add entries for fakeroot
136 * Ch. "Maintaining Your Debian Information": new chapter, quite small
137 right now; it mentions keyring-maint@debian.org for key modification,
138 warns against putting private keys on multi-user machines, and talks
139 about how to depart Debian gracefully
140 * typo correction from Christian Hudon (closes Bug#32052)
141 * menu file removed, obsoleted by doc-base file
142 * parameterize some often-changing values with SGML entities, update
143 number of available packages
144 * use new way of notating multiple copyrights
145 * change <tt> elements to <file> where appropriate
147 -- Adam Di Carlo <aph@debian.org> Thu, 11 Feb 1999 02:53:55 -0500
149 developers-reference (2.5.0.5) unstable; urgency=low
151 * add version.ent to docdir, needed to reconstruct from SGML
154 -- Adam Di Carlo <aph@debian.org> Tue, 29 Dec 1998 02:42:50 -0500
156 developers-reference (2.5.0.4) unstable; urgency=low
158 * not officially released
159 * more spelling corrections
160 * s/ppc/powerpc/ (thanks, James Troup)
162 -- Adam Di Carlo <aph@debian.org> Fri, 18 Dec 1998 00:07:40 -0500
164 developers-reference (2.5.0.3) unstable; urgency=low
166 * not officially released
167 * Sec. "Removing a package from Incoming": tiny section added
168 * some PGP-centricity removed
169 * Sec. "Adopting a package": point out that hijacking packages is not ok
170 * Ch. "Non-Maintainer Uploads (NMUs) and Porters": change 'NMU' to
171 'source NMU', 'port' to 'binary NMU', shorten the window for porters a
172 tad; fix spelling; stress that non-maintainer patches must be
173 non-disruptive and that aesthetic issues are not suitable for fixing
174 by non-maintainers; other fixes as suggested by interested parties
176 -- Adam Di Carlo <aph@debian.org> Wed, 25 Nov 1998 00:01:27 -0500
178 developers-reference (2.5.0.2) frozen unstable; urgency=low
180 * not officially released
181 * maintainer name change (but it's still me)
182 * Ch. "Non-Maintainer Uploads (NMUs) and Porters": new chapter
183 discussing NMUs and porters; Section "Interim Releases" integrated out
184 of existance. New TOC for this section is:
185 * 6 Non-Maintainer Uploads (NMUs) and Porters
186 + 6.1 Who can do a port or an NMU
187 + 6.2 When to do a port or an NMU
188 o 6.2.1 When to do an NMU if you are a porter
189 + 6.3 How to do an NMU
190 o 6.3.1 NMU version numbering
191 o 6.3.2 NMUs must create a changelog entry
192 o 6.3.3 NMUs must send patches, if any, to the BTS
193 o 6.3.4 Building the NMU
194 + 6.4 Guidelines for Porters
196 * Sec. "Maintainer changes": renamed to "Adopting a package" and moved
197 to Chapter "Moving, Removing, Renaming, Adopting, and Orphaning
199 * Sec. "Reporting lots of bugs at once": more forcefully deprecate this
201 * Sec. "Adopting a package": mention that the BTS maintainer update can
202 take a couple of weeks
203 * Sec. "Overview of Debian Maintainer Tools": give credit where credit
204 is due and attribute current maintainers; add `apt'; add `quinn-diff';
205 add mention of as yet unreleased 'buildd' package, since I'm so
206 excited about it and can't wait
207 * Sec. "Removing packages": talk about how apt-cache can be used to look
208 at reverse depends, a good step to take prior to removing a package
210 * show *full* TOC, including sect2
211 * of course the obligatory typo, grammar, and spelling corrections
213 * Makefile: small changes to accomodate DDP autobuild
214 * debian/dirs: obsolete, removed
215 * debian/rules: use changelog date for SGML timestamping, not current date
217 -- Adam Di Carlo <aph@debian.org> Fri, 20 Nov 1998 12:27:53 -0500
219 developers-reference (2.5.0) frozen unstable; urgency=low
221 * move to 3-level version number:
222 top-level version number probably won't change for a whil, it is the
223 "major", the second-level number means significant content changes,
224 and the third-level change means corrections and minor improvements.
225 Since this version has significant content changes, we are now 2.5.0.
226 Since I'm going to put porter instructions in the next major rev, that
229 * use new <package> tag where appropriate (Ardo, you rock)
230 * replace 'm86k' with 'm68k'
231 * rename 'Whirlwind Tour of ...' section to 'Overview of ...' (suggested
233 * typos and "red-pen" corrections, fix cosmetic problems in PostScript
235 * remove the one case I use an URL fragment identifier, since
236 debiandoc-sgml doesn't like it (bug filed against debiandoc-sgml)
237 * debian/rules: cosmetic cleanups, loosen check for root
238 * debian/rules: build PostScript version during build, since it's nice
239 to have all my debiandoc2* scripts together
240 * debian/control: policy compliant to 2.5.0
242 * advise against uploading when a package has lintian problems of
244 * "Mailing Lists and Servers":
245 - "The master server": mention how master is the home of the BTS;
246 mention how users need to take care with their accounts on master
247 - "The WWW servers": fill in www.debian.org, first pass, and discuss
248 how to put up your own web pages on va or master
249 - "The CVS server": new section added
250 - "Mirrors of Debian servers": new section added; point to info about
252 * "Applying to Become a Maintainer": do not advise resending initial
253 application; instead, simply mail a followup asking new maintainers
254 whether they go the initial application (closes Bug #28739); mention
255 that calls usually come in the evening; mention that if you use PGP
256 v5, you need to generate an RSA key (right?); clarify our intentions
258 * "Release code names": Debian 2.2 is 'potato'
259 * "Distribution directories": give concrete examples, hopefully making
260 it clearer where to look in Debian archives for specific stuff;
261 mention that old distributions are moved to archive servers (is there
262 a canonical location?)
263 * "The override file": new section, added under "Notification that a new
264 package has been installed"; fill it out quite a bit
265 * "Uploading to *": reiterate thrice not to upload export
266 controlled-software to master, or the European queues on erlangen and
268 * "Picking a distribution": section broken out from "Generating the
270 * "Uploading to frozen": new section, almost straight from Brian White
271 (hope you don't mind!) -- isn't that topical?
272 * "Interim releases": if you NMU a new upstream version (0.1), run
273 'dpkg-buildpackage -sa'
275 -- Adam P. Harris <aph@debian.org> Thu, 12 Nov 1998 00:03:43 -0500
277 developers-reference (2.4.1.5) unstable; urgency=low
279 * Fix instructions for new maintainers, incorporating the actual text
280 sent to prospective new maintainers. Improve this text a bit for
281 readability, coverage, and organization. Significant changes were
282 patched back to the new-maintainers group, if they care to use
283 them. (closes Bug#26948)
284 * Add an introductory "Scope" chapter which helps delineate what should
285 and should not be included in this Reference.
286 * Add a new chapter, "Whirlwind Tour of Debian Maintainer Tools". Let
287 me know what useful tools I forgot -- remember, Debian-specific
288 maintainer tools only!
289 * Add discussion of the "experimental" distribution, culled from an email
290 from Guy Maor on debian-devel.
291 * Incorporated suggestions from Branden Robinson (closes Bug#27211).
292 * Point to doc-debian's mailing list instructions where relevant.
293 * Made references to online documentation into URLs where possible.
294 * Little corrections here and there.
295 * add a Makefile for use in the DDP manual hierarchy
296 * debian/rules: comment out my 'source-depends' hack; it's just slowing
299 -- Adam P. Harris <aph@debian.org> Thu, 1 Oct 1998 03:42:43 -0400
301 developers-reference (2.4.1.4) unstable; urgency=low
303 * fill in Section "The master server" a bit; other servers to follow
304 * in Section "Distribution directories", mention that distributions
305 are always in 'dists' subdir of the Debian archive; talk about
307 * in Section "Release code names", talk about 'sid' a bit
308 * in Section "Interim releases", talk about how non-maintainers should
309 use the BTS, and bug severity "fixed" (closes Bug#17524)
310 * in Section "Generating the changes file", talk about how to set the
311 distribution in the debian/changelog file (i.e., "frozen unstable")
312 * add a new Section "Checking the package prior to upload" to Section
313 "Uploading a package", mentioning lintian and other tests one should
314 do prior to uploading
315 * add new Section "Notification that a new package has been installed"
316 in Section "Uploading a package", talking about dinstall and the
318 * add new Sections "Moving packages", "Removing packages", "Replacing or
319 renaming packages", and "Orphaning a package" (closes Bug#26650)
320 * add new Section "Bugs in your packages", talking about maintainer
321 duties with respect to bugs
322 * add new Section "Lintian reports" under "Handling bugs reports",
323 talking about how maintainers should check their packages with lintian
324 every now and then, alternatively pointing them to the lintian web
326 * clarify, a bit, the use of "section" and "subsection", bringing it
327 into line with the usage in the Policy Manual and Packaging Manual
328 * grammar and markup changes throughout
329 * debian/rules: added a crude source-depends rule, which renders more
330 explicit what is used to build this package
332 -- Adam P. Harris <aph@debian.org> Mon, 21 Sep 1998 00:51:46 -0400
334 developers-reference (2.4.1.3) unstable; urgency=low
337 * version number and date are automatically populated now
338 * changed doc-base section to "debian"
339 * debian/rules: better abstraction and organization
340 * reformat SGML like I happen to like it
341 * utilize the new URL tag
342 * build PostScript on letter size, I hear thats better for A4 and US
345 -- Adam P. Harris <aph@debian.org> Thu, 16 Jul 1998 00:52:35 -0400
347 developers-reference (2.4.1.2) frozen unstable; urgency=low
349 * non-maintainer release
350 * rebuilt since HTML versions of Chapters 1 and 2 were truncated
351 (important bug, no number yet, bugs.debian.org isn't working;
352 regardless, this should go in hamm because a broken developers
353 reference won't win us many friends in hamm, and after all, it's just
354 text, it can't hurt you.)
355 * no content changes, except that the version number in the SGML file
356 reflect this packages version number
357 * debian/rule: clean is cleaner now
359 -- Adam P. Harris <aph@debian.org> Tue, 16 Jun 1998 01:35:39 -0400
361 developers-reference (2.4.1.1) frozen unstable; urgency=low
365 -- Christian Schwarz <schwarz@debian.org> Thu, 14 May 1998 21:56:36 +0200
367 developers-reference (2.4.1.0) frozen unstable; urgency=low
369 * New version numbering scheme:
371 - The version numbers are independent of dpkg now, but all policy
372 manuals (the Debian Policy Manual, the Debian Packaging Manual, and
373 the Debian Developer's Reference) share the same version numbering
376 - The first three digits of the version number specify the
377 `Standards-Version.' This number is incremented with each policy
378 change. The fourth digit represents the `patch-level,' which may
379 differ between the manuals.
381 If only the patch-level digit is incremented, no changes in policy
382 have been made, except bug fixes and clarifications. Packages only
383 have to specify the first three digits of the version number in the
384 `Standards-Version' field of their source packages.
386 * Uploaded to frozen and unstable. This is a documentation-only
387 package and the changes to the manual are relevant for hamm.
389 * No changes to the Developer's Reference
391 -- Christian Schwarz <schwarz@debian.org> Mon, 13 Apr 1998 17:54:43 +0200
393 developers-reference (0.5) unstable; urgency=low
395 * Changes to the Developer's Reference:
397 - Changed section 1.2 Registering as a Debian developer:
398 + signatures from formal certification service are _NOT_ accepted
400 + images of ID documents have to be PGP or RSA signed
401 (as requested by James Troup)
403 - Use current date instead of <date> in manual
405 * Updated FSF's address (reported by Lintian)
407 -- Christian Schwarz <schwarz@debian.org> Sat, 7 Mar 1998 13:52:15 +0100
409 developers-reference (0.4) unstable; urgency=low
411 * Changes to the Developer's Reference:
413 - Renamed chapter 4 into `Package uploads'
415 - New section 4.2.5 Uploading to the non-us server
417 - Changed section 4.4 Interim releases:
418 + non-maintainer releases should not close bugs
419 + normal maintainer must at least read the patch provided with
420 the non-maintainer release
422 - New chapter 5 Handling bug reports:
423 + when reporting more then 10 bugs on the same topic, a message
424 has to be sent to debian-devel and the `maintonly' address
427 - Lots of typos fixed
429 * Compressed SGML source code
431 * Added support for doc-base to register the Developer's Reference
432 to the online documentation systems dwww and dhelp
434 * Upgraded to standards version 2.4.0.0 (no changes)
436 -- Christian Schwarz <schwarz@debian.org> Fri, 30 Jan 1998 21:58:34 +0100
438 developers-reference (0.3) unstable; urgency=low
440 * Put lost sections from Policy Manual 2.1.3.3 back in:
441 - Generating the changes file (for uploads)
442 - Announcing package uploads
443 * New section about Debian Mentors
444 * debian/rules: Don't use debstd anymore
445 * debian/rules: Compress changelog file (fixes:#15441)
446 * Fixed link to WNPP list (fixes:#16201)
447 * Added menu entry (fixes:#15708)
449 -- Christian Schwarz <schwarz@debian.org> Wed, 24 Dec 1997 13:54:33 +0100
451 developers-reference (0.2) unstable; urgency=low
453 * New chapter about `The Debian Archive' describing the structure
454 of our FTP server and the development process
455 * Added note that new maintainers have to read the Social Contract
456 and have to know where to find the Policy and Packaging Manuals
457 * PGP key ring is not distributed via dpkg but in doc/ of the FTP
459 * Added note that cross posting between Debian lists is depreciated
460 * New list of advantages why new packages should be discussed on
461 debian-devel before they are uploaded
462 * Added section about how packages are uploaded
463 * Added note that the Security Managers may do interim releases without
464 contacting the maintainer
465 * Removed chapter about bug tracking system (will be included in
466 a new manual released soon)
468 * Include SGML source in package
469 * Don't use `2-up' style for PostScript version
470 * Upgraded to Standards 2.3.0.1
472 -- Christian Schwarz <schwarz@debian.org> Sun, 2 Nov 1997 20:53:26 +0100
474 developers-reference (0.1) unstable; urgency=low
478 -- Christian Schwarz <schwarz@debian.org> Tue, 8 Jul 1997 00:19:49 +0200
481 mode: debian-changelog