On Sun, 2012-09-16 at 13:28 +0000, Bart Martens wrote:

> I'm looking at this now.  I agree with most of your patch.  I'm having doubts
> on this paragraph :
...
> I suggest to replace the paragraph quoted above by these two paragraphs :

Done in the attached patch, thanks.

Based on feedback from IRC I also changed the ftp-master removals link
to http://ftp-master.debian.org/#removed since the page I was linking to
was about pending removals instead of completed ones.

> Other than that, I read good info in your patch, so I think it's a good
> addition.

Thanks for the ack!

-- 
bye,
pabs

http://wiki.debian.org/PaulWise
Index: common.ent
===================================================================
--- common.ent	(revision 9361)
+++ common.ent	(working copy)
@@ -28,6 +28,7 @@
 <!ENTITY www-debian-org "www.debian.org">
 <!ENTITY ftp-debian-org "ftp.debian.org">
 <!ENTITY release-debian-org "release.debian.org">
+<!ENTITY snap-debian-org "snapshot.debian.org">
 <!ENTITY lists-host "lists.debian.org">
 <!ENTITY archive-host "archive.debian.org">
 <!ENTITY keyserver-host "keyring.debian.org">
Index: pkgs.dbk
===================================================================
--- pkgs.dbk	(revision 9361)
+++ pkgs.dbk	(working copy)
@@ -1238,7 +1238,7 @@
 </section>
 
 <section id="archive-manip">
-<title>Moving, removing, renaming, adopting, and orphaning packages</title>
+<title>Moving, removing, reintroducing, renaming, adopting, and orphaning packages</title>
 <para>
 Some archive manipulation operations are not automated in the Debian upload
 process.  These procedures should be manually followed by maintainers.  This
@@ -1385,6 +1385,51 @@
 
 </section>
 
+<section id="reintroducing-pkgs">
+<title>Reintroducing packages</title>
+<para>
+Packages are often removed due to release-critical bugs, absent maintainers,
+too few users or poor quality in general. There are some things you should be
+aware of when reintroducing removed packages.
+</para>
+<para>
+You should check why the package was removed in the first place. This
+information can be found in the removal item in the news section of the PTS
+page for the package or by browsing the log of
+<ulink url="http://&ftp-master-host;/#removed";>removals</ulink>.
+The removal bug will tell you why the package was removed and will give some
+indication of what you will need to work on in order to reintroduce the package.
+It may indicate that the best way forward is to switch to some other piece of
+software instead of reintroducing the package.
+</para>
+<para>
+It may be appropriate to contact the former maintainers to find out if
+they are working on reintroducing the package, interested in co-maintaining
+the package or interested in sponsoring the package if needed.
+You should do all the things required before introducing new packages
+(<xref linkend="newpackage"/>).
+</para>
+<para>
+You should base your work on the latest packaging available that is suitable.
+That might be the latest version from <literal>unstable</literal>, which will
+still be present in the <ulink url="&snap-debian-org;">snapshot archive</ulink>.
+</para>
+<para>
+The version control system used by the previous maintainer might contain useful
+changes, so it might be a good idea to have a look there.  Check if the control
+file of the previous package contained any headers linking to the version
+control system for the package and if it still exists.
+</para>
+<para>
+Package removals from unstable (not testing, stable or oldstable) trigger the
+closing of all bugs related to the package. You should look through all the
+closed bugs (including archived bugs) and unarchive and reopen any that were
+closed in a version ending in <literal>+rm</literal> and still apply. Any that
+no longer apply should be marked as fixed in the correct version if that is
+known.
+</para>
+</section>
+
 <section id="s5.9.3">
 <title>Replacing or renaming packages</title>
 <para>

Attachment: signature.asc
Description: This is a digitally signed message part

Reply via email to