Differences between revisions 11 and 12
Revision 11 as of 2007-02-04 13:56:43
Size: 7173
Editor: Jeroen
Comment: Emphasis that we'd like to know the maintainer's opinion
Revision 12 as of 2007-02-04 14:26:54
Size: 7228
Editor: Jeroen
Comment: Make some comments with the examples a bit more correct
Deletions are marked like this. Additions are marked like this.
Line 78: Line 78:
The binary package foobar (from source package fizz) is no longer built on hppa, but packages from an earlier version are still present in unstable. If a version of the package built on hppa is present in testing, this will stop the new version of foobar entering testing due to the "missing" hppa binaries. The binary package foobar (from source package fizz) is no longer built on hppa, some other binary packages of source fizz ''are'' still built on hppa. If a version of the package built on hppa is present in testing, this will stop the new version of foobar entering testing due to the "missing" hppa binaries.
Line 82: Line 82:
ANAIS may also be used in situations where a binary package has been uploaded for an architecture which is not listed in the package's control file. This should only occur if, for example, the package was built and uploaded by neither the maintainer nor an official auto-builder. ANAIS may also be used in situations where a binary package has been uploaded for an architecture which is not listed in the package's control file. This can occur if, for example, the package was built and uploaded by neither the maintainer nor an official auto-builder, or if the list of supported architectures is being reduced.

Package removal requests

Do you need to request removal?

As part of their archive maintenance role, the ftp-master team periodically (usually every few days) run a tool which searches for packages that should be removed. This tool used to be known as "rene" (and is still often referred to as such) but has now become the "auto-cruft" sub-command of dak. In the cases handled by this tool, there is no need to request that your package be removed.

You can view a recent copy of the tool's output at [http://ftp-master.debian.org/~jeroen/rene-full.txt]. The most common cases that are handled by the tool are:

  • Binary packages no longer built from any source package ("NBS", i.e. "not built from source")
  • Source packages which have had all their binary packages taken over by another source packages ("obsolete source packages")
  • Packages in experimental for which a higher numbered version of the package exists in unstable ("NVIU" - "newer version in unstable")
  • Packages in testing-proposed-updates for which a higher numbered version exists in testing ("NVIT")

Removals from testing, stable and oldstable

The ftp-master team only process removals from the unstable and experimental distributions.

The table below summarises the relevant contact points for requesting removals from other distributions.

Distribution

Contact

[http://www.debian.org/releases/testing testing]

Release Managers [mailto:debian-release@lists.debian.org debian-release@lists.debian.org]

[http://www.debian.org/releases/stable stable]

Stable Release Managers [mailto:debian-release@lists.debian.org debian-release@lists.debian.org]

oldstable

Not possible

Note that in most cases it is unnecessary to request removal of your package from both testing and unstable. Once the package is removed from unstable, it will automatically be removed from testing once there are no dependencies keeping it there.

If you do need the package simultaneously removed from both distributions, you will need to file a removal bug for unstable as usual, and contact the Release Managers to request removal from testing.

Before requesting removal

Reverse Dependencies

If your package has reverse dependencies in unstable, you need to ensure that they are aware of your intention to remove the package. Where possible, this will include suggesting (either via bugs or direct contact with the maintainer) a means of the dependent package handling the removal.

For instance, if you are removing an obsolete version of a library that the dependent package is still using, you should suggest that they transition to the current version.

If you are a DD, you can execute the folllowing command on merkel to check your package's reverse dependencies:

/srv/ftp.debian.org/katie/melanie -Rn $SOURCEPACKAGE

Who are you?

The ftp-masters will need to know your relationship to the package (if any) in order to process your request. In most cases, they will expect the request to be made by the maintainer (including co-maintainers) although there are a number of other parties who might be expected to submit removal requests for various reasons:

  • Porters requesting removal of binaries for their architecture
  • The Release Managers or Stable Release Managers, for packages which they do not consider to be suitable for release or which should be removed from stable (although the latter happens very rarely)
  • The QA team. Normally this will involve orphaned packages and/or MIA maintainers

If you do not fall in to any of the categories listed, you should indicate in your report why you are requesting that the package be removed. In all cases, if there is a maintainer and you're not the maintainer, mention the maintainer's opinion or if you don't know it, mention how and when you tried to contact him. If you didn't try to contact the maintainer, do so first. One way would be to file the bug as an RC bug on the package first, indicating why you think the package should be removed, and asking the maintainer if he/she agrees to reassign the bug to ftp.debian.org. If after a few weeks and some prodding there's still no reaction, and you believe the ftp-master team would process the removal anyway despite the maintainer not having replied, you might consider reassigning the bug yourself.

How to request removal

File a bug against the [http://bugs.debian.org/ftp.debian.org ftp.debian.org pseudo-package]. The ftp-masters do not take account of the severity of the bug reported when processing removals and, except in very rare cases (e.g. licensing problems) removals from unstable or experimental are not release critical. Removal bugs should thus be filed as severity "normal"; if you believe the request to be "important" or "serious" then simply provide appropriate reasoning in the report.

The subject line of the bug report should be in the format

  • RM: $PACKAGE [$ARCHITECTURES] -- $REASONS

where

  • $PACKAGE is the source package in most cases.
    • If you are requesting the removal of specific binary packages they should be listed here instead in the format "source package:binary package"
    • If you are requesting removal of packages from experimental, this should be indicated in the form $PACKAGE/experimental.
  • $ARCHITECTURES is only needed if requesting that only some architectures' packages be removed. If specified, the list should be in the same format as that used by dpkg - i.e. a space-separated list surrounded by brackets.
  • $REASONS approximately corresponds to the list at the head of http://ftp-master.debian.org/removals.txt, plus comments.

    • The first entry in the list of reasons should indicate the position from which you are requesting the removal - e.g. RoM if you are the maintainer, RoP if you are a porter requesting removal of packages for your architecture, and so on.

Examples

The m68k porters request that bigpackage's m68k binaries be removed as they do not build

  • RM: bigpackage [m68k] -- RoP; FTFBS

The binary package foobar (from source package fizz) is no longer built on hppa, some other binary packages of source fizz are still built on hppa. If a version of the package built on hppa is present in testing, this will stop the new version of foobar entering testing due to the "missing" hppa binaries.

  • RM: fizz:foobar [hppa] -- RoM; ANAIS

ANAIS may also be used in situations where a binary package has been uploaded for an architecture which is not listed in the package's control file. This can occur if, for example, the package was built and uploaded by neither the maintainer nor an official auto-builder, or if the list of supported architectures is being reduced.

Package wibble is orphaned, has release critical bugs and appears to have been abandoned upstream. In this case the package has never been part of a Debian release and the QA team request its removal.

  • RM: wibble -- RoQA; orphaned; NPOASR; RC-buggy; abandoned upstream