developers-reference (3.0) unstable; urgency=low * Adam Di Carlo: - welcome Manoj Srivastava as a co-maintainer - welcome Raphael Hertzog as a co-maintainer - new Chapter "Resource for Debian Developers", incorporating the former chapters Ch "Mailing Lists, Servers, and Other Machines" Ch "The Debian Archive" - new Chapter "Managing Packages", incorporating former chapters Ch "Package uploads" Ch "Non-Maintainer Uploads (NMUs)" Ch "Porting and Being Ported" Ch "Moving, Removing, Renaming, Adopting, and Orphaning Packages" Ch "Handling Bugs" (retitled "Handling package bugs") Sec "Bug housekeeping" (new section, some parts stubbed out) - new Chapter "Beyond Packaging" recommends ways to contribute to Debian beyond issues of package maintenance; incoporates Ch "Interaction with Prospective Developers", retitled to Sec "Interacting with Prospective Debian Developers" Sec "Submitting Bugs", renamed to "Reporting Bugs" Sec "QA" moved here from old Sec "Quality Assurance effort" Sec "Dealing with unreachable maintainers" - Sec "Voting" stubbed in Developer Duties - Sec "The Developers Database" added under Resources - Sec "Getting started": add link to New Maintainers' Guide - Sec "Debian Mentors" renamed to "Debian Mentors and Sponsors", we add some info on sponsoring; also in Sec "Sponsoring packages" - Section's first word capitalized, rest are normal case - purge a reference to the Packaging Manual; closes: #145039 - misc. cross-referencing with new or moved sections - change some literal quotes to ‘, ”, etc. - update copyright date - some simplifications on the TeX suffix rule -- Adam Di Carlo Sun, 5 May 2002 17:57:42 -0400 developers-reference (2.11) unstable; urgency=low * Antoine Hulin: - some grammar corrections - update French translation * Martin Michlmayr: - changes in upload situation, not possible to remove from Incoming anymore; closes: #135559 - also talk about dput a tiny bit * Adam Di Carlo: - Ch "Overview of Debian Maintainer Tools": - improve the intro - Charles Briscoe-Smith deprecates yada (I think new maintainers of that would be welcome) - debconf-doc mentioned for debconf - debhelper: don't talk about debmake; mention how to get info on the dh-* pkgs - dput: new section, closes: #129378 - debootstrap: new section, closes: #129377 - dpkg-dev-el: new section - other minor wording changes - Sec "Mailing Lists": where to find private archives, closes: #96780 - Ch "Package uploads": - new Sec "Adding an entry to debian/changelog" - rename Sec "Announcing new packages" to "New packages" - crypto is in main, non-US is for patent restrictions, so: - excise some text from "Registering as a Debian developer" - changes in Sec "Uploading to ftp-master" - changes in Sec "Uploading to non-US" * old bugs closed out, closes: #110573 -- Adam Di Carlo Sun, 7 Apr 2002 23:34:08 -0700 developers-reference (2.10.0) unstable; urgency=low * from Martin Michlmayr - update the "Applying to Become a New Maintainer" section, with review by Raphael Hertzog, closes: #133965 - bugs closed in NMUs should uses 'closes' changelog entries, closes: #133951 - developers are not required to subscribe to debian-private closes: #133955 - some suggestions on places to use the proper term, Debian GNU/Linux, closes: #133953 - fix some typos, closes: #133956 * Adam Di Carlo: - frozen doesn't exist anymore, just testing; note, however, that there is a way to upload to 'woody-proposed-updates' -- if I can find some description of that, I'll document it; closes: #133948 - minor build tweaks - minor cosmetics - isolate a few more language-independent bits * from Chris Tillman - change /usr/doc to /usr/share/doc, and typo in debian/copyright, closes: #126924 -- Adam Di Carlo Sun, 24 Feb 2002 14:46:46 -0500 developers-reference (2.9.0) unstable; urgency=low * Josip Rodin: - created a new subsection about uploading to stable, and elaborated about that subject - removed a stray sentence about stable from the paragraph about security uploads (which apply to all distributions equally) - replaced the nonexistent term "Security Manager" with "security officer" - uploading to stable and unstable is deprecated; updated the section about the experimental distribution; other fixes in the section talking about uploading to distributions - better organize some subsections in the section about package uploads - replaced some bogus s with s - noted how there is an upload queue on pandora, too * Antoine Hulin: - French translation updated * Adam Di Carlo: - normalize '--' as — for prettier output - integrate changes from James Troup, part of #102626 - typo fix thanks to Mark Hodge -- Adam Di Carlo Sun, 21 Oct 2001 01:03:01 -0400 developers-reference (2.8.8) unstable; urgency=low * from Josip Rodin: - a few more strong words about sponsoring - started a new chapter about the relationship between old and new developers -- Adam Di Carlo Fri, 20 Jul 2001 17:53:47 -0400 developers-reference (2.8.7) unstable; urgency=low * French updates * fix a typo in a link * dpkg-buildpackage -m flag was changed for -e when NMU'ing; update documentation accordingly closes: #101676 * Matt Zimmerman fixes up some wording in the section talking about forwarding bugs upstream closes: #98312 * provide proper l10n for SGML date entities; now we have &date- entities which should be used * debian/rules: fixes for new debiandoc-sgml * debian/control: depend on debiandoc-sgml 1.1.48 or better -- Adam Di Carlo Thu, 21 Jun 2001 14:43:42 -0400 developers-reference (2.8.6) unstable; urgency=low * fix a typo, thanks to Antoine Hulin * French version: completely up-to-date now * Makefile: add a 'validate' target * prepare and ship "upstream" ChangeLog; move the debian changelog to changelog.Debian.gz * all versions: change the email address to use when orphaning closes: #93727 -- Adam Di Carlo Fri, 13 Apr 2001 03:32:08 -0400 developers-reference (2.8.5) unstable; urgency=low * expunge references to the Debian Packaging Manual, which is now in the Policy * Japanese version: also comment out some references packaging manual; this translation needs updating * deny request to shut down non-maintainer bug maintenance bug closure practices (closes: Bug#88623) * add some advice about U.S. citizens uploading to non-US (closes: Bug#89694) * debian/control: Build-Depends should have been Build-Depends-Indep * French version: First complete translation of the Debian developer's reference guide. Much work done by Antoine Hulin. Reviewed by Nicolas Bertolissio. * Portuguese version: work is started by Carlos Laviola, nothing included yet, however -- Adam Di Carlo Sun, 8 Apr 2001 01:25:51 -0400 developers-reference (2.8.4) unstable; urgency=low * debian/control: remove reference to obsolete packaging-manual package (closes: Bug#86505) * debian/control: fill in the description a bit more * doc-base: index.html corrected to be index.en.html (closes: Bug#85933) * Makefile: clean is cleaner -- Adam Di Carlo Sun, 25 Feb 2001 12:47:06 -0500 developers-reference (2.8.3) unstable; urgency=low * build and provide French and Japanese versions * devolve build logic from debian/rules to top-level Makefile * developers-reference.jp.sgml: minor changes so it will build (is out of date) * debian/rules: stop making useless /usr/share/developers-reference dir -- Adam Di Carlo Mon, 22 Jan 2001 02:02:02 -0500 developers-reference (2.8.2) unstable; urgency=low * Josip Rodin: - fix typographic errors reported by David Martinez (closes: Bug#80740) - common.ent: upped the numbers a little bit, updated lintian reports URL - updated regarding va->klecker move, and www->people move, changed most mentions of dinstall to a generic term "archive maintenance software", removed full path to it because it is in PATH now, mentioned "dak" and "katie" (somewhat vaguely), changed week to month regarding FTP archive waiting time since that\'s more often the case, and changed weeks to hours regarding Maintainers file updates since that\'s also more often the case now, updated some URLs to entities, s/debian-doc/doc-debian/ - replaced evil latin1-only quotation marks, replaced mentions of important severity (in RCB context) with serious severity, some details fixed - common.ent (1.10): fixed email-debian-user alias; updated sample-dist-dirtree (with more to come) - described testing; described package pools (this particular part required quite a bit of changes, and it might be a bit rough, but it's a start); described the frozen test cycles et al; some other smaller fixes - another update WRT sid/unstable/testing, from Colin Watson (closes: Bug#80896) * debian/control: add Recommends for debian-policy, packaging-manual * update copyright notice for 2001 * fix for WNPP bug filing severities from David Schleef * clarify the status of the Developers's reference as "normative" * add a reference to debconf (closes: Bug#82413) -- Adam Di Carlo Sun, 21 Jan 2001 18:10:21 -0500 developers-reference (2.8.1) unstable; urgency=low * update WNPP instructions, based on patch from Marcelo E. Magallon (closes: Bug#69435) * spelling corrections, awkward grammar suggestions from Andreas Krueger (closes: Bug#72810) * debian/rules: remove some obsolete source-depends stuff -- Adam Di Carlo Sat, 4 Nov 2000 13:22:21 -0500 developers-reference (2.8.0) unstable; urgency=low * Almost all changes for this release are from Josip Rodin . Thanks, Josip! * debian/control, postinst, prerm, rules: Policy 3.2.1 (closes: Bug#68929, Bug#70384) * fixed bug closing example (closes: Bug#71198) * update the perl regexp from current /usr/lib/dpkg/parsechangelog/debian * updated keyring/keyserver information (closes: Bug#67783) * updated new-maintainer stuff (closes: Bug#67841) * updated for master -> ftp-master move (closes: Bug#68369) * noted www.d.o is the right host for web pages, but all other machines could be used if necessary * reorder mentions of scp to come before FTP, as it is more secure; mention the rsync dupload method * reorder mentions of pandora <-> non-us, canonical name non-us is better * other small corrections * fixed orphaning/adopting instructions with regard to the new WNPP * common.ent: fix urls for cvs.d.o, wnpp, Debian machines page, lists-archives, www.d.o BTS * common.ent: changed link for machines from devel/maintainer_contacts to the db.d.o CGI * Makefile: remove unnecessary subshell * Adam's change: update debian/copyright for new Policy, and put my name in there a bit with updated years; update doc-base file for FHS -- Adam Di Carlo Sun, 15 Oct 2000 03:25:21 -0400 developers-reference (2.7.2) frozen unstable; urgency=medium * I believe this should go into frozen because (a) it's only documentation, so it can't introduce RC bugs, and (b) it fixes an error which prevented it from building properly; however, whatever ftpmaster feels is best is fine * * include common.ent as well as version.ent (closes: Bug#52582, Bug#48926) * debian/rules: fix build error caused by newer debiandoc-sgml; remove constitution.en.html, since that is now located in the doc-debian package (closes: Bug#54778, Bug#42014); don't compress .pdf file * * All changes below from Raphael Hertzog * * Sec. "Uploading to master" and "Uploading to pandora": explained dinstall -n (closes: Bug#45079) * Sec. "Picking a distribution": added reference to the debian-release team (closes: Bug#52906) * Sec. "Announcing package uploads": rewrote it to take care of the fact that dinstall is doing it automatically (closes: Bug#43877) * Sec. "Mailing lists": added a paragraph about debian-email (closes: Bug#40258) * Changed the "Maintaining Your Debian Information" into "Debian Developer's Duties" (closes: Bug#28908) - added a section about the LDAP database - added a section about the "on vacation" message - added a section about the coordination with upstream developers (closes: Bug#43878) - added a section about managing Release Critical bugs - added a section about Quality Assurance effort -- Adam Di Carlo Sun, 16 Apr 2000 23:24:33 -0400 developers-reference (2.7.1) unstable; urgency=low * Sec. "Registering as a Debian developer": we are transitioning away from non-free PGP -- remove allusions to non-free software such as PGPv2 or v5 insofar as possible; recommend use of DSS keys rather than RSA * Sec. "Maintaining Your Public Key": remove PGP-centric stuff * Sec. "When bugs are closed by new uploads": describe how to close bugs via a magic changelog entry (closes: Bug#43690) * Sec. "Generating the changes file": refer to Sec. "When bugs are closed by new uploads" for closing bugs via a changelog entry * developers-reference.sgml: re-enable RCS variables in CVS sources * debian/control,rules: dynamically generate the TOC in the package description from developers-reference.sgml -- Adam Di Carlo Sun, 12 Sep 1999 18:15:59 -0400 developers-reference (2.7.0) unstable; urgency=low * developers-reference.sgml: separated out language-independant elements into common.ent (not content changes); misc minor grammar changes throughout * doc-base: change section for *constitution* to Debian (not 'debian') (closes Bug#37392) * Sec. "Stable, unstable, and sometimes frozen": mention how old stable releases are available at archive.debian.org * Sec. "Uploading to pandora (non-us)" added, remove stale information about the old anonymous ftp area (closes Bug#39541); Sec. "Other Upload Queues" added about that upload queues, added samosa and master.debian.org.jp (closes Bug#37804) * Sec. "Yada": mention that yada might not be as robust as other package producing systems, at request of the author; Sec. "equivs" added * Sec. "Moving packages": at the request of Guy Maor, clarify that this procedure is for moving packages in sections (i.e., free, contrib) only * Sec. "Registering as a Debian developer": talk about RSA keys rather than PGP keys, since I think GPG can create/handle them now; mention that the official pkg maintainer address much match an ID on your key; * Sec. "Maintaining Your Public Key": beef up the warnings a bit; point to the PGP FAQ * Sec. "Mailing Lists, Servers, and Other Machines": clean up and clarify section; mention that all developers are expected to be subscribed to debian-private and debian-devel-announce * Sec. "Other Debian Machines": remove list of machines; point to http://www.debian.org/devel/machines instead * Sec. "Release code names": potato is 2.2 * Sec. "Guidelines for Porter Uploads": talk about recompile only uploads and version numbers for this (i.e., foo_2.4-1.0.1), from a suggestion from James Troup * Sec. "buildd": mention andrea, and buildd.debian.org * Sec. "Removing packages": correct apt-cache usage * debain/rules: update standards to 3.0.1 -- since I'm not moving /usr/doc to /usr/share/doc yet, no changes were required except in the text here and there -- Adam Di Carlo Mon, 16 Aug 1999 23:29:45 -0400 developers-reference (2.6.8) unstable; urgency=low * when applying as a new user, the login name can be *eight* characters, not seven (thanks to Rafael Caetano dos Santos) -- Adam Di Carlo Fri, 21 May 1999 21:50:04 -0400 developers-reference (2.6.7) unstable; urgency=low * SGML'ish: normalize SGML elements, refill paragraphs (closes Bug#37987) * doc-base: change section to Debian -- hmm, this looks like a doc-base bug, really, but hey, who am I to refile bugs to another one of my own packages? (closes Bug#37392) * Ch. "Overview of Debian Maintainer Tools": new section for yada (um, someone who uses this should check my description), correct build -> debuild in the devscripts section (closes Bug#38053) -- Adam Di Carlo Fri, 21 May 1999 01:41:45 -0400 developers-reference (2.6.6) unstable; urgency=low * Sec. "The master server": note that problems on Debian ftp can be sent to ftpmaster@debian.org also * Secs. "Uploads via chiark" and "Uploads via erlangen": remove 'cron-driven' (thanks Roman Hodek) * Sec. "Being Kind to Porters": typos corrected, note that binary-arch and binary-indep targets should work independantly (thanks Roman Hodek) * Sec. "buildd": remove erroneous reference to debbuild, reorganize the section and correct typos (thank again Roman -- boy, this is the all Roman release) * debian/rules: re-enable letter-sized PDFs -- Adam Di Carlo Sun, 9 May 1999 01:17:29 -0400 developers-reference (2.6.5) unstable; urgency=low * Sec. "Architectures": correction on supported architecture in Linux 2.2, from Job Bogan * Sec. "Experimental": other reasons to use or not use the experiment archive "section", from comments by Guy Maor * Sec. "Being Kind to Porters": replace x86 with i386 (closes Bug#36485) * debian/rules: date printing protected from local l10n (closes Bug#36891) * Ch. "Mailing Lists, Servers, and Other Machines": renamed chapter; add intro paragraph * Sec. "Debian Servers": new, for talking about the standard servers, with intro; demoted server sections under that * Sec. "The FTP servers": was empty, removed * Sec. "The master server": fill in more info and cross-refs on how to report problems * Sec. "The CVS server": add some more detail which should be included when requesting cvs areas; mention the cvsweb URL * Sec. "Other Debian Machines": new section, list the machines for which a normal developer may have access. -- Adam Di Carlo Tue, 4 May 1999 03:32:21 -0400 developers-reference (2.6.4) unstable; urgency=low * debian/rules: hack 'byhand' file entries to include debian version number in it, so subsequent uploads of the package into Incoming don't step all over each other -- Adam Di Carlo Fri, 9 Apr 1999 20:04:04 -0400 developers-reference (2.6.3) unstable; urgency=low * correction from James Troup -- is indeed the correct address for PGP key updates -- Adam Di Carlo Sun, 4 Apr 1999 13:28:58 -0400 developers-reference (2.6.2) unstable; urgency=low * Sec. "fakeroot": libtricks is not replacing anything after all * developers-reference.sgml: use public declaration * BTW, if any maintainers of translated versions of this document would like to talk to me about folding your version into the developers-reference CVS area, please get in touch with me -- Adam Di Carlo Sun, 4 Apr 1999 04:42:29 -0400 developers-reference (2.6.1) unstable; urgency=low * include Debian constitution (closes Bug#30694) * Sec. "fakeroot": libtricks is replacing fakeroot, not libtool * Sec. "Maintaining Your Public Key" -- give email addresses as {pgp,gpg}-update@debian.org, at James Troup's request (note to Jameas, if you see this: /usr/doc/debian-keyring/README.gz talks about instead) * Ch. "Overview of Debian Maintainer Tools" -- add Sec. "debget" * developers-reference.sgml: minor typo correction from Tril * doc-base stuff: add abstract to developers-reference, new file for constitution * debian/rules: minor cleanup and consistency; build PDF, not PS file; ship PDF file;.text file now has .txt extension * debian/control: set priority to optional, matching archive -- Adam Di Carlo Sat, 3 Apr 1999 17:17:06 -0500 developers-reference (2.6.0) frozen unstable; urgency=low * would be nice to sneak this into slink; it's just documentation! * Ch. "Porting and Being Ported": porter information broken out into it's own chapter, Sec. "Guidelines for Porter Uploads" and "When to do a source NMU if you are a porter" moved to this chapter; porter tool descriptions such as 'quinn-diff' moved to this section. Sec. "Being Kind to Porters" added, with tips for how to avoid making problems for porters. * Ch. "Non-Maintainer Uploads (NMUs)": update for the new chapter, and tighten up the language a bit * Sec. "Monitoring bugs": add a little cron job to get an 'index maint' of outstanding bugs (closes Bug#31259), loosen language a tiny bit w.r.t. non-maintainers or submitters closing bugs (closes Bug#30394) * Sec. "Scope of This Document": point out that this file is not official policy * Ch. "Handling Bugs": renamed from "Handling Bug Reports", incorporate some suggestions from James Troup, namely, don't mail from your root account, don't close bugs via control@bugs.debian.org; break out new sections, "Submitting Bugs" and "Responding to Bugs" * Ch. "Overview of Debian Maintainer Tools": remove attribution for package maintainers, since I can't keep up; add entries for fakeroot and devscripts * Ch. "Maintaining Your Debian Information": new chapter, quite small right now; it mentions keyring-maint@debian.org for key modification, warns against putting private keys on multi-user machines, and talks about how to depart Debian gracefully * typo correction from Christian Hudon (closes Bug#32052) * menu file removed, obsoleted by doc-base file * parameterize some often-changing values with SGML entities, update number of available packages * use new way of notating multiple copyrights * change elements to where appropriate -- Adam Di Carlo Thu, 11 Feb 1999 02:53:55 -0500 developers-reference (2.5.0.5) unstable; urgency=low * add version.ent to docdir, needed to reconstruct from SGML (closes Bug#31034) -- Adam Di Carlo Tue, 29 Dec 1998 02:42:50 -0500 developers-reference (2.5.0.4) unstable; urgency=low * not officially released * more spelling corrections * s/ppc/powerpc/ (thanks, James Troup) -- Adam Di Carlo Fri, 18 Dec 1998 00:07:40 -0500 developers-reference (2.5.0.3) unstable; urgency=low * not officially released * Sec. "Removing a package from Incoming": tiny section added * some PGP-centricity removed * Sec. "Adopting a package": point out that hijacking packages is not ok * Ch. "Non-Maintainer Uploads (NMUs) and Porters": change 'NMU' to 'source NMU', 'port' to 'binary NMU', shorten the window for porters a tad; fix spelling; stress that non-maintainer patches must be non-disruptive and that aesthetic issues are not suitable for fixing by non-maintainers; other fixes as suggested by interested parties -- Adam Di Carlo Wed, 25 Nov 1998 00:01:27 -0500 developers-reference (2.5.0.2) frozen unstable; urgency=low * not officially released * maintainer name change (but it's still me) * Ch. "Non-Maintainer Uploads (NMUs) and Porters": new chapter discussing NMUs and porters; Section "Interim Releases" integrated out of existance. New TOC for this section is: * 6 Non-Maintainer Uploads (NMUs) and Porters + 6.1 Who can do a port or an NMU + 6.2 When to do a port or an NMU o 6.2.1 When to do an NMU if you are a porter + 6.3 How to do an NMU o 6.3.1 NMU version numbering o 6.3.2 NMUs must create a changelog entry o 6.3.3 NMUs must send patches, if any, to the BTS o 6.3.4 Building the NMU + 6.4 Guidelines for Porters * Sec. "Maintainer changes": renamed to "Adopting a package" and moved to Chapter "Moving, Removing, Renaming, Adopting, and Orphaning Packages". * Sec. "Reporting lots of bugs at once": more forcefully deprecate this practice * Sec. "Adopting a package": mention that the BTS maintainer update can take a couple of weeks * Sec. "Overview of Debian Maintainer Tools": give credit where credit is due and attribute current maintainers; add `apt'; add `quinn-diff'; add mention of as yet unreleased 'buildd' package, since I'm so excited about it and can't wait * Sec. "Removing packages": talk about how apt-cache can be used to look at reverse depends, a good step to take prior to removing a package from the archive * show *full* TOC, including sect2 * of course the obligatory typo, grammar, and spelling corrections * Makefile: small changes to accomodate DDP autobuild * debian/dirs: obsolete, removed * debian/rules: use changelog date for SGML timestamping, not current date -- Adam Di Carlo Fri, 20 Nov 1998 12:27:53 -0500 developers-reference (2.5.0) frozen unstable; urgency=low * move to 3-level version number: top-level version number probably won't change for a while, it is the "major", the second-level number means significant content changes, and the third-level change means corrections and minor improvements. Since this version has significant content changes, we are now 2.5.0. Since I'm going to put porter instructions in the next major rev, that will be 2.6.0... * use new tag where appropriate (Ardo, you rock) * replace 'm86k' with 'm68k' * rename 'Whirlwind Tour of ...' section to 'Overview of ...' (suggested by James Troup) * typos and "red-pen" corrections, fix cosmetic problems in PostScript version * remove the one case I use an URL fragment identifier, since debiandoc-sgml doesn't like it (bug filed against debiandoc-sgml) * debian/rules: cosmetic cleanups, loosen check for root * debian/rules: build PostScript version during build, since it's nice to have all my debiandoc2* scripts together * debian/control: policy compliant to 2.5.0 * advise against uploading when a package has lintian problems of severity 'E' * "Mailing Lists and Servers": - "The master server": mention how master is the home of the BTS; mention how users need to take care with their accounts on master - "The WWW servers": fill in www.debian.org, first pass, and discuss how to put up your own web pages on va or master - "The CVS server": new section added - "Mirrors of Debian servers": new section added; point to info about how to mirror * "Applying to Become a Maintainer": do not advise resending initial application; instead, simply mail a followup asking new maintainers whether they go the initial application (closes Bug #28739); mention that calls usually come in the evening; mention that if you use PGP v5, you need to generate an RSA key (right?); clarify our intentions with respect to GPG. * "Release code names": Debian 2.2 is 'potato' * "Distribution directories": give concrete examples, hopefully making it clearer where to look in Debian archives for specific stuff; mention that old distributions are moved to archive servers (is there a canonical location?) * "The override file": new section, added under "Notification that a new package has been installed"; fill it out quite a bit * "Uploading to *": reiterate thrice not to upload export controlled-software to master, or the European queues on erlangen and chiark * "Picking a distribution": section broken out from "Generating the changes file" * "Uploading to frozen": new section, almost straight from Brian White (hope you don't mind!) -- isn't that topical? * "Interim releases": if you NMU a new upstream version (0.1), run 'dpkg-buildpackage -sa' -- Adam P. Harris Thu, 12 Nov 1998 00:03:43 -0500 developers-reference (2.4.1.5) unstable; urgency=low * Fix instructions for new maintainers, incorporating the actual text sent to prospective new maintainers. Improve this text a bit for readability, coverage, and organization. Significant changes were patched back to the new-maintainers group, if they care to use them. (closes Bug#26948) * Add an introductory "Scope" chapter which helps delineate what should and should not be included in this Reference. * Add a new chapter, "Whirlwind Tour of Debian Maintainer Tools". Let me know what useful tools I forgot -- remember, Debian-specific maintainer tools only! * Add discussion of the "experimental" distribution, culled from an email from Guy Maor on debian-devel. * Incorporated suggestions from Branden Robinson (closes Bug#27211). * Point to doc-debian's mailing list instructions where relevant. * Made references to online documentation into URLs where possible. * Little corrections here and there. * add a Makefile for use in the DDP manual hierarchy * debian/rules: comment out my 'source-depends' hack; it's just slowing things down -- Adam P. Harris Thu, 1 Oct 1998 03:42:43 -0400 developers-reference (2.4.1.4) unstable; urgency=low * fill in Section "The master server" a bit; other servers to follow * in Section "Distribution directories", mention that distributions are always in 'dists' subdir of the Debian archive; talk about 'proposed-updates' * in Section "Release code names", talk about 'sid' a bit * in Section "Interim releases", talk about how non-maintainers should use the BTS, and bug severity "fixed" (closes Bug#17524) * in Section "Generating the changes file", talk about how to set the distribution in the debian/changelog file (i.e., "frozen unstable") * add a new Section "Checking the package prior to upload" to Section "Uploading a package", mentioning lintian and other tests one should do prior to uploading * add new Section "Notification that a new package has been installed" in Section "Uploading a package", talking about dinstall and the override file a bit * add new Sections "Moving packages", "Removing packages", "Replacing or renaming packages", and "Orphaning a package" (closes Bug#26650) * add new Section "Bugs in your packages", talking about maintainer duties with respect to bugs * add new Section "Lintian reports" under "Handling bugs reports", talking about how maintainers should check their packages with lintian every now and then, alternatively pointing them to the lintian web pages * clarify, a bit, the use of "section" and "subsection", bringing it into line with the usage in the Policy Manual and Packaging Manual * grammar and markup changes throughout * debian/rules: added a crude source-depends rule, which renders more explicit what is used to build this package -- Adam P. Harris Mon, 21 Sep 1998 00:51:46 -0400 developers-reference (2.4.1.3) unstable; urgency=low * new maintainer * version number and date are automatically populated now * changed doc-base section to "debian" * debian/rules: better abstraction and organization * reformat SGML like I happen to like it * utilize the new URL tag * build PostScript on letter size, I hear thats better for A4 and US letter printing -- Adam P. Harris Thu, 16 Jul 1998 00:52:35 -0400 developers-reference (2.4.1.2) frozen unstable; urgency=low * non-maintainer release * rebuilt since HTML versions of Chapters 1 and 2 were truncated (important bug, no number yet, bugs.debian.org isn't working; regardless, this should go in hamm because a broken developers reference won't win us many friends in hamm, and after all, it's just text, it can't hurt you.) * no content changes, except that the version number in the SGML file reflect this packages version number * debian/rule: clean is cleaner now -- Adam P. Harris Tue, 16 Jun 1998 01:35:39 -0400 developers-reference (2.4.1.1) frozen unstable; urgency=low * Orphaned package -- Christian Schwarz Thu, 14 May 1998 21:56:36 +0200 developers-reference (2.4.1.0) frozen unstable; urgency=low * New version numbering scheme: - The version numbers are independent of dpkg now, but all policy manuals (the Debian Policy Manual, the Debian Packaging Manual, and the Debian Developer's Reference) share the same version numbering scheme. - The first three digits of the version number specify the `Standards-Version.' This number is incremented with each policy change. The fourth digit represents the `patch-level,' which may differ between the manuals. If only the patch-level digit is incremented, no changes in policy have been made, except bug fixes and clarifications. Packages only have to specify the first three digits of the version number in the `Standards-Version' field of their source packages. * Uploaded to frozen and unstable. This is a documentation-only package and the changes to the manual are relevant for hamm. * No changes to the Developer's Reference -- Christian Schwarz Mon, 13 Apr 1998 17:54:43 +0200 developers-reference (0.5) unstable; urgency=low * Changes to the Developer's Reference: - Changed section 1.2 Registering as a Debian developer: + signatures from formal certification service are _NOT_ accepted anymore + images of ID documents have to be PGP or RSA signed (as requested by James Troup) - Use current date instead of in manual * Updated FSF's address (reported by Lintian) -- Christian Schwarz Sat, 7 Mar 1998 13:52:15 +0100 developers-reference (0.4) unstable; urgency=low * Changes to the Developer's Reference: - Renamed chapter 4 into `Package uploads' - New section 4.2.5 Uploading to the non-us server - Changed section 4.4 Interim releases: + non-maintainer releases should not close bugs + normal maintainer must at least read the patch provided with the non-maintainer release - New chapter 5 Handling bug reports: + when reporting more then 10 bugs on the same topic, a message has to be sent to debian-devel and the `maintonly' address should be used - Lots of typos fixed * Compressed SGML source code * Added support for doc-base to register the Developer's Reference to the online documentation systems dwww and dhelp * Upgraded to standards version 2.4.0.0 (no changes) -- Christian Schwarz Fri, 30 Jan 1998 21:58:34 +0100 developers-reference (0.3) unstable; urgency=low * Put lost sections from Policy Manual 2.1.3.3 back in: - Generating the changes file (for uploads) - Announcing package uploads * New section about Debian Mentors * debian/rules: Don't use debstd anymore * debian/rules: Compress changelog file (fixes:#15441) * Fixed link to WNPP list (fixes:#16201) * Added menu entry (fixes:#15708) -- Christian Schwarz Wed, 24 Dec 1997 13:54:33 +0100 developers-reference (0.2) unstable; urgency=low * New chapter about `The Debian Archive' describing the structure of our FTP server and the development process * Added note that new maintainers have to read the Social Contract and have to know where to find the Policy and Packaging Manuals * PGP key ring is not distributed via dpkg but in doc/ of the FTP server * Added note that cross posting between Debian lists is depreciated * New list of advantages why new packages should be discussed on debian-devel before they are uploaded * Added section about how packages are uploaded * Added note that the Security Managers may do interim releases without contacting the maintainer * Removed chapter about bug tracking system (will be included in a new manual released soon) * Some minor changes * Include SGML source in package * Don't use `2-up' style for PostScript version * Upgraded to Standards 2.3.0.1 -- Christian Schwarz Sun, 2 Nov 1997 20:53:26 +0100 developers-reference (0.1) unstable; urgency=low * Initial Release. -- Christian Schwarz Tue, 8 Jul 1997 00:19:49 +0200 Local variables: mode: auto-fill End: