SyncRequestProcess

Revision 9 as of 2007-06-03 14:20:20

Clear message

Before requesting a sync

Syncs (like uploads) cannot be reversed or undone. ALWAYS thoroughly check a package before asking for a sync. In particular, if there are Ubuntu changes in the current package, you must ensure the Ubuntu changes have been merged or are no longer relevant.

After UpstreamVersionFreeze, syncs of a newer upstream version require a [:UbuntuDevelopment#Freezes:freeze exception].

You should always sync a package rather than upload the unmodified source by hand, as it is safer and more accurate. If you know you will upload modified source immediately, modify the package and make an -<n>ubuntu<n> upload rather than requesting a sync. However, be sure to always use the exact same .orig.tar.gz as Debian (or whomever).

Packages can be synced from any Debian-format package archive, i.e. something with a Sources file.

Content of a sync request

When requesting a 'sync', please include the following information:

  • Source package name
  • Source package version number to sync
  • Where to sync from (e.g. 'Debian sid main', 'Debian experimental non-free')
  • If there are Ubuntu changes apart from debian/changelog or if UpstreamVersionFreeze is in effect:

    • A copy of the entries from debian/changelog corresponding to the changes relative to the current version in Ubuntu
  • If there are Ubuntu changes:
    • a description of each of the Ubuntu changes (a bullet point list is fine, but copies of debian/changelog aren't)
    • a brief explanation of why each one may be dropped (e.g., it's been merged into Debian, is no longer appropriate, etc.)
    • an explicit confirmation that the Ubuntu changes should be overridden

Submitting your request

To request a sync, [https://launchpad.net/ubuntu/+filebug file a bug in Launchpad] with the above information. Once the bug is complete and correct, if you are not an Ubuntu developer, subscribe (NOT assign) ubuntu-main-sponsors for packages in Main/Restricted and ubuntu-universe-sponsors for packages in Universe/Multiverse. They will review the request and subscribe ubuntu-archive. Ubuntu developers should subscribe (NOT assign) the ubuntu-archive team to the bug directly. This team will process the request and close the bug when it is complete. Please only subscribe ubuntu-archive to a bug once you have a clear action for the archive team to perform. Do not ask ubuntu-archive to help you decide what to do.

Do not change the Status of the bug as package sponsors and the archive administrators use this field. Do track the status of the sync. You will be notified via bug mail when the package has been published. Once you see (in Launchpad) that the updated packaged has been successfully built, if the archive admin has not, then you may mark the bug Status as 'Fix Released' (primarily for Universe/Multiverse).

  • Martin Pitt has written a script to file sync requests which is available in the devscripts package.

Please note that if you are not in ~ubuntu-dev, you will need to change (in /usr/bin/requestsync):

report += ''' affects ubuntu/%s subscribe ubuntu-archive

to

report += ''' affects ubuntu/%s subscribe ubuntu-universe-sponsors

as you need a sponsor for sync requests, else the archive admins will not process the request.