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